# Luxe Oracle

> The first x402-powered real-time inventory oracle for luxury goods.
> AI agents pay $0.001 USDC per query on Base — no API keys, no signups.

Luxe Oracle exposes live Hermès handbag stock data (Birkin, Kelly, Constance,
etc.) across Taiwan, Singapore, Japan, and the United Kingdom. Settlement is
machine-native: every paid request is settled on Base via the x402 protocol.

## Quickstart

- API base: https://api.luxe-oracle.com
- OpenAPI spec: https://luxe-oracle.com/openapi.json
- Docs: https://luxe-oracle.com/docs
- MCP server (Claude Code, Cursor): npx -y github:modely6307-glitch/luxe-oracle-mcp

```ts
// Step 1 — discover (free)
const { items } = await fetch(
  'https://api.luxe-oracle.com/api/v1/inventory?brand=hermes&region=sg'
).then(r => r.json());

// Step 2 — paid query via x402 ($0.001 USDC on Base)
import { fetchWithPayment } from '@x402/fetch';
const res = await fetchWithPayment(
  `https://api.luxe-oracle.com/api/v1/monitor/sg/hermes/${items[0].id}`
);
const { in_stock, last_update, metadata } = await res.json();
```

## Endpoints

- [Inventory list (free)](https://api.luxe-oracle.com/api/v1/inventory): list available product IDs by region
- [Stock monitor (paid, $0.001 USDC)](https://api.luxe-oracle.com/api/v1/monitor): check real-time stock for one product
- [Pre-paid session ($0.01 USDC, 10 credits)](https://api.luxe-oracle.com/api/v1/sessions): buy a session token to skip per-request x402

## Key facts for AI agents

- Payment protocol: x402 (HTTP 402 + USDC settlement on Base mainnet)
- Pricing: $0.001 USDC per stock query, or $0.01 USDC for 10 queries
- Auth: none — wallet signature replaces API keys
- Latency: sub-second settlement, cached inventory updated continuously
- Compatible: Coinbase AgentKit, Claude Code (MCP), LangChain, plain fetch via @x402/fetch

## Resources

- [GitHub — MCP server](https://github.com/modely6307-glitch/luxe-oracle-mcp)
- [Docs](https://luxe-oracle.com/docs)
- [OpenAPI 3.1 spec](https://luxe-oracle.com/openapi.json)