API Getting Started

Try it now#Link copied!

No signup required. Paste either command in your terminal:

curl "https://silphcoanalytics.xyz/api/v3/trending?limit=5"

curl "https://silphcoanalytics.xyz/api/v3/cards/me2pt5-276/sales?limit=50"

Playground responses include X-LOR-Tier: playground. Want more? Sign in for a free API key (100 requests/day).

Recipes#Link copied!

Three common starting points. Replace YOUR_API_KEY with a key from the dashboard.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://silphcoanalytics.xyz/api/v3/search?q=charizard&limit=5"

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://silphcoanalytics.xyz/api/v3/cards/me2pt5-276/chart-series"

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://silphcoanalytics.xyz/api/v3/market/volume?days=30&language=en"

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ids":["base1-4","sv3-197","swsh12pt5-159"],"game":"pokemon","profile":"core"}' \
  "https://silphcoanalytics.xyz/api/v3/cards/batch"

Quick start#Link copied!

1. Create an account and generate an API key at the dashboard.
2. Send the key as a Bearer token on every request.
3. Browse the interactive reference for parameters and response shapes.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://silphcoanalytics.xyz/api/v3/cards?limit=1"

Authentication#Link copied!

Most /api/v3 data routes require Authorization: Bearer YOUR_API_KEY. Requests without a valid key return HTTP 401.

Playground plus Free / Pro / Elite apply at https://silphcoanalytics.xyz:

History windows are enforced: the public edge clamps since / date_from to your tier (see X-Silph-History-Days response headers).

Playground routes work without a key on the same URLs:

• /api/v3/cards/{id}
• /api/v3/cards/{id}/sales
• /api/v3/cards/{id}/tcgplayer-history
• /api/v3/trending

Add a Bearer token on any route to use your account tier. Per-card sales return up to 200 rows per request and include next_cursor for paging within your history window. Responses include X-LOR-Tier (playground vs authenticated).

Check daily usage with GET /keys/usage using the same Bearer token (includes history_days).

Beta: GET /api/v3/shop/listings is available but not suitable for production integrations. Deal scores and platform freshness are experimental — verify listings before acting on them.

Endpoints#Link copied!

Base URL: https://silphcoanalytics.xyz/api/v3

Unavailable routes#Link copied!

These routes appear in contract metadata or older docs but are not callable on the public API. Use the replacement where listed.

Response envelope#Link copied!

Every v3 response uses silphco-envelope.v1. The payload lives in data; the contract field names its schema version.

Pagination#Link copied!

Lists accept offset and limit (max 200). Per-card sales use an opaque next_cursor to page through history (API key required; playground returns at most 50 rows and next_cursor: null).

Errors#Link copied!

Errors return contract: "error.v1" with error.code and error.message. HTTP 401 indicates a missing or invalid key. For removed routes, 404 with error.code: "removed" includes error.details.replacement pointing at the supported path.

Finding cards#Link copied!

You do not need a Pokémon TCG card ID to start. Use the same filters as Explore on GET /api/v3/search (with q) or GET /api/v3/cards (browse without q). Resolve fuzzy names with GET /api/v3/lookup, then call GET /api/v3/cards/{id} or /sales once you have an ID.

Shared filters include language, grader, rarity, variant, min_price / max_price, sort, window, slab_only, and raw_only.

Card Identity#Link copied!

Cards are uniquely identified by a combination of set code and print number:

Print Variants & Finishes#Link copied!

Cards with the same ID can exist in different variant runs or finishes. These are treated as separate asset nodes for pricing and uniqueness:

Examples#Link copied!

# Search
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://silphcoanalytics.xyz/api/v3/search?q=charizard&limit=5"

# Card chart series
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://silphcoanalytics.xyz/api/v3/cards/me2pt5-276/chart-series"

# Market volume (30 days)
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://silphcoanalytics.xyz/api/v3/market/volume?days=30&language=en"

# Trending (no API key)
curl "https://silphcoanalytics.xyz/api/v3/trending?limit=5"

# Shop listings (beta — experimental deal scores)
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://silphcoanalytics.xyz/api/v3/shop/listings?limit=5"

# SQL (body field is sql, not query)
curl -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sql":"SELECT tcg_card_id FROM pkmn_card_rollup LIMIT 1"}' \
  "https://silphcoanalytics.xyz/api/v3/sql"

Reference#Link copied!

• Interactive API reference — parameters, schemas, and try-it-out
• OpenAPI JSON (public) — curated data routes for Postman or typed client generation