# Foil Ledger API

> Condition-aware Pokémon TCG market prices (TCGplayer-based, refreshed daily) plus realized sales from a working card shop. Pay per call with USDC on Base via x402; also available as paid MCP tools at /mcp.

No API key, no account. Paid routes answer HTTP 402 with x402 payment requirements; any x402 client (e.g. @x402/fetch) pays USDC on Base and retries automatically. Prices are per call.

## Free
- https://foil-ledger-api.lazylucariospokemart28.workers.dev/ — Landing: endpoints, prices, MCP, referral terms
- https://foil-ledger-api.lazylucariospokemart28.workers.dev/v1/sample — Three real cards and one real sale so you can see the response shapes
- https://foil-ledger-api.lazylucariospokemart28.workers.dev/v1/health — Freshness + card count
- https://foil-ledger-api.lazylucariospokemart28.workers.dev/v1/stats — Calls and USDC earned today / last 7 days (no addresses)
- https://foil-ledger-api.lazylucariospokemart28.workers.dev/v1/referrals/:address — Referral earnings for a wallet

## Paid (USDC per call)
- https://foil-ledger-api.lazylucariospokemart28.workers.dev/v1/cards — $0.005 — All tracked cards with current market price and 7-day change
- https://foil-ledger-api.lazylucariospokemart28.workers.dev/v1/card/:id — $0.002 — One card by id (ids from /v1/cards, /v1/search or the free /v1/sample)
- https://foil-ledger-api.lazylucariospokemart28.workers.dev/v1/search — $0.005 — Search by card name / set
- https://foil-ledger-api.lazylucariospokemart28.workers.dev/v1/movers — $0.01 — Biggest 7-day movers, up and down
- https://foil-ledger-api.lazylucariospokemart28.workers.dev/v1/sold — $0.005 — Realized sales: what this shop actually got per card, with the market price at the time
- https://foil-ledger-api.lazylucariospokemart28.workers.dev/v1/comp — $0.01 — Comp one card: live market price for matching cards next to this shop's realized sales

## MCP
- https://foil-ledger-api.lazylucariospokemart28.workers.dev/mcp — streamable HTTP; tools: get_all_cards ($0.005), get_card_price ($0.002), search_cards ($0.005), get_movers ($0.01), get_sold_prices ($0.005), comp_card ($0.01), get_sample (free), health (free)

## Referrals
- Append ?ref=0xYourWallet to any paid call to earn 10% of it. Free tally: https://foil-ledger-api.lazylucariospokemart28.workers.dev/v1/referrals/0xYourWallet

## Machine-readable
- https://foil-ledger-api.lazylucariospokemart28.workers.dev/openapi.json
- https://foil-ledger-api.lazylucariospokemart28.workers.dev/.well-known/x402
- https://foil-ledger-api.lazylucariospokemart28.workers.dev/.well-known/agent.json
- https://foil-ledger-api.lazylucariospokemart28.workers.dev/.well-known/ai-catalog.json

## Docs
- https://github.com/lazylucariospokemart/foil-ledger-api