{ "$schema_note": "TickerMint plans for people and AI agents choosing a plan. Numbers come from the live API (GET https://api.tickermint.cards/meta).", "name": "TickerMint API", "what": "Daily TCGplayer market prices since February 2024 for about 132,308 Pokemon, One Piece, Lorcana, Riftbound, Gundam and Yu-Gi-Oh cards and sealed products, plus price history, movers, sets and sealed. Read-only JSON, CSV and an MCP server.", "data_as_of": "2026-11-03", "currency": "USD", "unit": "card lookup", "unit_rule": "A lookup is one card: Google Sheets ranges, CSV files and bulk calls count one per card returned, every other call counts one.", "history_rule": "Price history: the current price plus 30 days with no key, 90 days with a free key, and the full daily history back to February 8, 2024 on every paid plan.", "bulk_history_rule": "Full history per month: Developer 10,000 products, API Pro 25,000, API Business 60,000, API Platform unlimited. Full history beyond 90 days counts toward the monthly history cap: the different products whose history /v1/bulk/history, /v1/bulk/day for a day older than 7 days, or a single-card call reaching back more than 90 days returns in a calendar month. Fetching the same products again is free; 30- and 90-day charts (/products/{id}/prices?days=90) and today's bulk prices never count.", "auth": { "header": "X-API-Key", "query_param": "key", "env_var": "TICKERMINT_API_KEY", "get_a_key": "https://tickermint.cards/developers#keys" }, "trial": { "days": 7, "card_required": true, "applies_to": "every paid API plan", "lookups": 5000, "bulk_history": false, "rule": "Trials: 5,000 lookups and no bulk history until the first payment.", "end_early": "End the trial and pay from the keys panel (https://tickermint.cards/developers#keys) to start the full plan at once.", "longer_trial": "Building something commercial and need longer? Ask for API Pro free for 30 days while you ship: https://tickermint.cards/developers#business" }, "refunds": "30-day money back on every API plan, no questions: email hello@tickermint.cards within 30 days of a charge.", "annual_billing": "2 months free (pay 10 months for 12)", "overage": "10% grace over a paid plan's monthly quota, then HTTP 429 until the month resets; never billed automatically", "enforcement": { "mode": "soft", "enforce_at": "2026-11-09T15:00:00+00:00", "note": "Until enforce_at, calls over a quota still answer with a Warning header and a JSON notice; after it they get HTTP 429." }, "plans": [ { "id": "no_key", "name": "No key", "price_monthly_usd": 0, "price_annual_usd": null, "price_note": "Free, no signup", "lookups_per_day": 100, "lookups_per_month": null, "bulk_history_products_per_month": null, "history": "current price plus 30 days", "requests_per_minute": 120, "commercial_use": false, "attribution_required": true, "includes": [ "single cards and search", "the MCP server", "per IP address" ], "best_for": [ "trying the API", "a one-off script" ], "not_for": [ "CSV files and Google Sheets ranges (need a free key)", "commercial use", "anything shared by many users from one server" ], "how_to_get": "Call the API with no key.", "upgrade_url": "https://tickermint.cards/developers#keys" }, { "id": "free_key", "name": "Free key", "price_monthly_usd": 0, "price_annual_usd": null, "price_note": "Free, email login only (about 20 seconds), no card", "lookups_per_day": 1000, "lookups_per_month": null, "bulk_history_products_per_month": null, "history": "90 days", "requests_per_minute": 300, "commercial_use": false, "attribution_required": true, "includes": [ "Google Sheets ranges and CSV files", "your own per-minute bucket", "usage counts in your panel" ], "best_for": [ "personal projects", "a hobby Discord bot", "a personal spreadsheet or portfolio tracker", "research and students" ], "not_for": [ "stores, paid apps or any product a business runs (API Pro)", "full price history (Developer and up)" ], "how_to_get": "Log in with your email at https://tickermint.cards/developers#keys and create a key; send it as the X-API-Key header (env var TICKERMINT_API_KEY).", "upgrade_url": "https://tickermint.cards/developers#keys" }, { "id": "developer", "name": "Developer", "price_monthly_usd": 19, "price_annual_usd": 190, "price_note": "7-day free trial, card required (5,000 lookups and no bulk history until the first payment); yearly billing = 2 months free", "lookups_per_day": null, "lookups_per_month": 50000, "bulk_history_products_per_month": 10000, "history": "Full daily history since February 2024 (Yu-Gi-Oh since September 2026)", "requests_per_minute": 600, "commercial_use": false, "attribution_required": true, "includes": [ "full daily history since February 2024", "bulk endpoints (/v1/bulk/history: 50 products per call; /v1/bulk/base-rates); bulk counts one lookup per card, so a whole day of every card (/v1/bulk/day) is about 160,000 lookups", "full history beyond 90 days for up to 10,000 different products a month (30- and 90-day charts never count)", "up to 5 keys" ], "best_for": [ "personal and non-commercial projects that need volume or full history", "backtests and research on price history" ], "not_for": [ "commercial use (API Pro and up)" ], "how_to_get": "Subscribe at https://tickermint.cards/developers?ref=agent-docs&plan=developer#plan; the key is emailed after checkout.", "upgrade_url": "https://tickermint.cards/developers?ref=agent-docs&plan=developer#plan" }, { "id": "api_pro", "name": "API Pro", "price_monthly_usd": 49, "price_annual_usd": 490, "price_note": "7-day free trial, card required (5,000 lookups and no bulk history until the first payment); yearly billing = 2 months free", "lookups_per_day": null, "lookups_per_month": 250000, "bulk_history_products_per_month": 25000, "history": "Full daily history since February 2024 (Yu-Gi-Oh since September 2026)", "requests_per_minute": 1200, "commercial_use": true, "attribution_required": true, "includes": [ "commercial license to show prices and history in your product", "everything in Developer", "full history beyond 90 days for up to 25,000 different products a month (30- and 90-day charts never count)", "webhooks (price moves, new products)" ], "best_for": [ "an online store showing market prices next to listings", "a paid or ad-supported app, site or bot", "a collection or portfolio app", "a deck builder", "an internal tool at a business" ], "not_for": [ "mirroring or reselling the dataset (never allowed)", "products sold to other businesses without attribution (API Platform)" ], "how_to_get": "Subscribe at https://tickermint.cards/developers?ref=agent-docs&plan=api_pro#plan; the key is emailed after checkout.", "upgrade_url": "https://tickermint.cards/developers?ref=agent-docs&plan=api_pro#plan" }, { "id": "api_business", "name": "API Business", "price_monthly_usd": 249, "price_annual_usd": 2490, "price_note": "7-day free trial, card required (5,000 lookups and no bulk history until the first payment); yearly billing = 2 months free", "lookups_per_day": null, "lookups_per_month": 1500000, "bulk_history_products_per_month": 60000, "history": "Full daily history since February 2024 (Yu-Gi-Oh since September 2026)", "requests_per_minute": 3000, "commercial_use": true, "attribution_required": true, "includes": [ "everything in API Pro", "full history beyond 90 days for up to 60,000 different products a month (30- and 90-day charts never count)", "written retention rights: keep data you fetched after you cancel", "your users can export their collections with prices attached", "written terms emailed on purchase" ], "best_for": [ "stores and apps past API Pro volume", "products that need retention or export rights" ], "not_for": [ "no-attribution or multi-tenant products (API Platform)" ], "how_to_get": "Subscribe at https://tickermint.cards/developers?ref=agent-docs&plan=api_business#plan.", "upgrade_url": "https://tickermint.cards/developers?ref=agent-docs&plan=api_business#plan" }, { "id": "api_platform", "name": "API Platform", "price_monthly_usd": 599, "price_annual_usd": 5990, "price_note": "7-day free trial, card required (5,000 lookups and no bulk history until the first payment); yearly billing = 2 months free", "lookups_per_day": null, "lookups_per_month": 5000000, "bulk_history_products_per_month": null, "history": "Full daily history since February 2024 (Yu-Gi-Oh since September 2026)", "requests_per_minute": 6000, "commercial_use": true, "attribution_required": false, "includes": [ "everything in API Business", "unlimited full history", "no attribution required", "use inside products you build or run for other businesses (multi-store apps, white-label tools, marketplaces)", "up to 25 keys", "email support within one business day" ], "best_for": [ "multi-store or white-label tools", "marketplaces", "products that cannot show a link back" ], "not_for": [ "redistributing the dataset (Enterprise)" ], "how_to_get": "Subscribe at https://tickermint.cards/developers?ref=agent-docs&plan=api_platform#plan.", "upgrade_url": "https://tickermint.cards/developers?ref=agent-docs&plan=api_platform#plan" }, { "id": "enterprise", "name": "Enterprise", "price_monthly_usd": null, "price_annual_usd": null, "price_note": "From $1,500 a month, by written agreement", "lookups_per_day": null, "lookups_per_month": null, "bulk_history_products_per_month": null, "history": "Full daily history since February 2024 (Yu-Gi-Oh since September 2026)", "requests_per_minute": null, "commercial_use": true, "attribution_required": false, "includes": [ "custom volume past API Platform", "unlimited full history", "redistribution rights by written agreement", "graded data at volume", "uptime commitment and direct support" ], "best_for": [ "data redistribution", "graded data at volume", "very high volume", "an uptime commitment" ], "not_for": [], "how_to_get": "Email hello@tickermint.cards with the use case and expected volume.", "upgrade_url": "mailto:hello@tickermint.cards?subject=TickerMint%20Enterprise" } ], "choose_a_plan": [ { "if": "Just trying the API or writing a one-off script", "plan": "no_key" }, { "if": "Personal, hobby, student or research project (no money involved), up to 1,000 lookups a day", "plan": "free_key" }, { "if": "Personal or research project that needs full history since 2024, bulk endpoints or more volume", "plan": "developer" }, { "if": "Anything commercial: an online store, a paid or ad-supported app, site or bot, a product or internal tool a business runs", "plan": "api_pro" }, { "if": "Commercial and past API Pro volume, or you need to keep fetched data after cancelling or let users export it", "plan": "api_business" }, { "if": "A product you run for other businesses (multi-store, white-label, marketplace) or you cannot show a link back", "plan": "api_platform" }, { "if": "Redistributing the data, graded data at volume, an uptime commitment, or more than API Platform volume", "plan": "enterprise" } ], "rules": { "summary": [ "Free: personal use, link back.", "Paid: commercial use (from API Pro).", "Never: mirror or resell our data.", "Graded prices: a separate add-on with its own source credit." ], "commercial_use": "Free keys and Developer are for personal and non-commercial use. Commercial use (a store, a paid or ad-supported app, site or bot, or any product or tool a business runs) needs API Pro or above, whatever the volume.", "attribution": "Free, Developer, API Pro and API Business: a visible \"Prices: TickerMint\" link to the card's page next to the prices you show (each answer carries it as tickermint_url, and single-card answers as an attribution object). API Platform and Enterprise need no link.", "attribution_check": "Your key form asks where the prices will appear (tick \"not public\" for a private or internal tool). We check public pages once a week. If the link is missing we email you; if it is still missing 14 days later the key can drop to no-key limits until it is back.", "attribution_markup": "Prices: TickerMint (use tickermint_url from the API answer)", "no_mirroring": "Every plan may show prices in your product. No plan may copy or mirror the full catalog or price history as a dataset for redistribution or a competing price service (Enterprise by agreement).", "terms_url": "https://tickermint.cards/developers#terms" }, "add_ons": [ { "id": "graded", "name": "Graded prices (PSA, BGS, CGC, SGC)", "status": "live: /v1/graded/* endpoints, 7-day trial with card", "price_monthly_usd": 149, "requires": "API Pro or above", "includes": [ "Ungraded, grade 7 to 9.5 and every grader's 10, per card, with daily history", "Added to API Pro or any plan above it", "Source credit required: \"Prices from PriceCharting\" with a link" ], "note": "PSA, BGS, CGC, SGC, TAG and ACE 10s and grades 1 to 9.5 from PriceCharting sold listings, with daily history. Every value carries attribution (\"Prices from PriceCharting\" with a link) that must stay visible. Endpoints: GET /v1/graded/products/{id}, GET /v1/graded/products/{id}/history, POST /v1/graded/products/batch, GET /v1/graded/bulk/day.", "start": "https://tickermint.cards/developers#graded" } ], "archive": { "what": "Every daily market price since February 2024 as gzipped CSV (about 48 million rows)", "research_usd": 499, "business_usd": 2990, "url": "https://tickermint.cards/tcg-price-data-download" }, "errors": [ { "code": "key_required", "status": 401, "fix": "Send X-API-Key (env var TICKERMINT_API_KEY). Free key: https://tickermint.cards/developers#keys. For /v1/bulk the key must be on Developer or above; for /v1/webhooks on API Pro or above." }, { "code": "invalid_key", "status": 401, "fix": "Copy a live key from https://tickermint.cards/developers#keys (log in with the same email) or create a new one." }, { "code": "plan_required", "status": 402, "fix": "Subscribe to required_plan at upgrade_url (7-day free trial). Plans: https://tickermint.cards/pricing.json." }, { "code": "quota_exceeded", "status": 429, "fix": "No key: get a free key. Free key: Developer for personal use, API Pro for commercial use. Paid: the next plan up (required_plan). Trial: end the trial and pay from the keys panel (upgrade_url), and the full plan starts at once. History cap: ask single cards for ?days=90 or less (never counted); products already fetched this month are free again. Cache answers: prices change once a day." }, { "code": "trial_limit", "status": 403, "fix": "End the trial and pay at upgrade_url (https://tickermint.cards/developers#keys); bulk opens at once. Until then use single-card endpoints within the trial's 5,000 lookups." }, { "code": "rate_limited", "status": 429, "fix": "Wait Retry-After seconds and retry with backoff; cache answers; use a key for its own per-minute bucket." } ], "links": { "llms_txt": "https://tickermint.cards/llms.txt", "llms_full_txt": "https://tickermint.cards/llms-full.txt", "docs_markdown": "https://tickermint.cards/docs/index.md", "pricing_markdown": "https://tickermint.cards/docs/pricing.md", "openapi": "https://api.tickermint.cards/openapi.json", "mcp": "https://api.tickermint.cards/mcp", "examples": "https://github.com/seankarltonlee/tickermint-examples", "developers_page": "https://tickermint.cards/developers" } }