HobbyCardIndex API: sports card and Pokémon card prices, sold sales, cert lookup and card recognition
Examples, JavaScript and Python SDKs, and MCP setup for the HobbyCardIndex Data API.
The HobbyCardIndex Data API returns raw and graded prices, based on real sold prices, for a 16M+ card catalog across 25+ categories: baseball, basketball, football, hockey, soccer, Pokemon, Magic: The Gathering, Yu-Gi-Oh, One Piece and more. It also identifies a card from a photo, looks up PSA, BGS, CGC and SGC certs, and returns sold sales, price history, pop reports and market movers.
Used by card apps and marketplaces, graders, dealers and shop software, and AI agents (through the MCP server).
Which part answers your question
Quick start
Every request carries your key in the X-API-Key header (or Authorization: Bearer). Every successful response is {"success": true, "data": {...}}; the SDKs return data.
curl
JavaScript (Node 18+)
Python (3.9+)
More in examples/: curl for every endpoint, Node, Python, MCP client config, Google Sheets.
Endpoints
Base URL: https://hobbycardindex.com/api/v1
cardId is the id from search or scan results; ext-<externalId> looks a card up by its externalId. Rate limits are per key and per second (1 on Enterprise, 10 to 50 on the commercial sizes); a 429 carries a Retry-After header.
Errors are {"success": false, "error": {"code", "message", "details"?}}. Codes you will meet: MISSING_API_KEY, INVALID_API_KEY, RATE_LIMITED, VALIDATION_ERROR, NOT_FOUND, REQUIRES_COMMERCIAL_LICENSE, MONTHLY_LIMIT_REACHED.
Attribution
The Terms ask for one visible credit to Hobby Card Index with a link, beside the prices or on your site. The API's JSON responses carry an attribution object and an X-Attribution header with the exact text and link to show.
HTML:
Markdown badge (for a README or docs page):
Plans
For apps and websites whose users see the data: Lite $99, Growth Lite $249, Growth $499 and Platform $1,500 a month, billed monthly, cancel any time. A free setup month is available by application at https://hobbycardindex.com/developers.
Keeping your own copy of every price? Add the daily price files ($450 a month on Growth Lite or Growth): current prices for every card in a category as one download a day, instead of paging through search.
Not sure which size fits? GET https://hobbycardindex.com/api/v1/agent/plans?use_case=<id> recommends one for display_prices, copy_all_prices, photo_scans, sold_sales, certs_and_pop or own_use, and an agent can buy it there with no account (POST /api/v1/agent/checkout; the buyer pays on Stripe's page). Your own business's internal use is covered by the Enterprise plan ($49.99 a month). Full terms: https://hobbycardindex.com/terms/ section 8.
MCP (AI assistants)
AI assistants that speak the Model Context Protocol connect to https://hobbycardindex.com/api/v1/mcp (Streamable HTTP, JSON responses, no session) with the same key as the X-API-Key header. Tools: search_cards, get_card_prices, and, without a key, list_plans (pass use_case for a recommendation) and start_checkout. Client configs for Claude Desktop, Claude Code, Cursor and VS Code are in examples/mcp/.
Questions
[email protected], or open an issue here. Please do not post API keys in issues.