# x402 Entity-ID Resolver

> Paid HTTP endpoint. Resolves an ambiguous name ("Apple", "ETH", "Stripe") to ranked
> candidates carrying verified canonical IDs across registries: SEC CIK + ticker, GLEIF LEI,
> Wikidata QID, CoinGecko slug. The exact, cross-registry ID lookup LLMs cannot do reliably.

## Endpoints
- GET /resolve?q=<string> — $0.005 USDC via x402 (Base mainnet, EIP-3009). Returns ranked canonical-ID candidates.
- GET /health — free. Returns service + network status.

## Payment (x402)
Unpaid GET /resolve returns HTTP 402 with payment terms. The caller's wallet signs an
EIP-3009 USDC transfer inline (gasless for the buyer); the facilitator verifies + settles
on Base. No account, no API key. payTo is the service's receiving wallet.

## Use when
You need exact canonical IDs for an entity name across SEC / GLEIF / Wikidata / CoinGecko —
the disambiguation + ID resolution that an LLM cannot produce reliably from memory.