{"openapi":"3.1.0","info":{"title":"TickerMint API","description":"Daily TCGplayer market prices for about 130,000 Pokemon, One Piece, Disney Lorcana, Riftbound, Yu-Gi-Oh and Gundam\nproducts since February 2024: market and low price\nper printing per day, all-time highs and lows, movers, set lists, sealed product,\ndeck costs and base rates. Prices only; card images and catalog data belong to\nTCGplayer and the publishers.\n\n**Terms in one line each.** Free: personal use, link back. Paid: commercial use\n(from API Pro). Never: mirror or resell our data. Graded prices: a separate\nadd-on with its own source credit. Full terms:\nhttps://tickermint.cards/developers#terms\n\nPlans are counted in **card lookups**: a Sheets range, a CSV file or a bulk call\ncounts one per card returned, every other call counts one. Every answer carries\n`X-Quota-Limit`, `X-Quota-Remaining` and `X-Quota-Reset`; single-card answers\ncarry an `attribution` object (`text`, `url`) to show next to the price.\n\n**No key**: try it with no sign-up, 100 lookups a day per IP, the current price\nplus 30 days of history, single cards and search. Personal and non-commercial,\nwith a link back to the TickerMint page the data came from.\n\n**Free key** (log in with your email, `X-API-Key` header or `?key=`): 1,000 lookups\na day, 90 days of history, Google Sheets ranges and CSV files. Personal use, with\na link back where the prices appear (we check public pages weekly).\n\n**Developer ($19/month or $190/year)**: 50,000 lookups a month, full daily history\nsince February 2024 and the bulk endpoints (`/v1/bulk/day`, `/v1/bulk/history`,\n`/v1/bulk/base-rates`; counted per card returned, a whole day of every card is\nabout 160,000 lookups), with full history for up to 10,000 different products a\nmonth. Personal and non-commercial use only, link back.\n\n**API Pro ($49/month)**: 250,000 lookups a month, full history for up to 25,000\ndifferent products a month, and a commercial license to show the data in your\nproduct, with a link back.\n\n**API Business ($249/month)**: 1,500,000 lookups a month, full history for up to\n60,000 different products a month, plus written retention and export rights,\nwith a link back.\n\n**API Platform ($599/month)**: 5,000,000 lookups a month, unlimited full history,\nno link back needed, and use inside products you run for other businesses.\n\n**Full history beyond 90 days counts toward the monthly history cap**: the\ndifferent products whose history `/v1/bulk/history`, `/v1/bulk/day` for a day\nolder than 7 days, or a single-card call reaching back more than 90 days returns\nin a calendar month. Fetching the same products again is free; 30- and 90-day\ncharts (`/products/{id}/prices?days=90`) and today's bulk prices never count.\n\n**Enterprise (from $1,500/month)**: custom volume, redistribution rights, graded\ndata at volume, an uptime commitment and direct support, by agreement:\nhello@tickermint.cards\n\n**Graded prices add-on ($149/month or $1,490/year, API Pro and above, 7-day\ntrial)**: ungraded, grades 1 to 9.5 and PSA, BGS, CGC, SGC, TAG and ACE 10s from\nsold listings, with daily history, on the `/v1/graded/*` endpoints (one lookup\nper card). Every value carries `attribution` (\"Prices from PriceCharting\" and a\nlink), which must stay visible wherever you show it. Start it at\nhttps://tickermint.cards/developers#graded\n\nEvery plan may show prices in your product; no plan may copy or mirror the full\ncatalog or price history as a dataset for redistribution or a competing price\nservice (Enterprise by agreement). Yearly billing = 2 months free.\n\nPaid plans start with a 7-day free trial (card required) and get 10% grace over\ntheir monthly quota. Trials: 5,000 lookups and no bulk history until the first\npayment (end the trial from the keys panel to start the full plan at once).\nUntil November 9, 2026 calls over a quota still answer, with\na `Warning` header and a `notice`; after that they get HTTP 429 with an upgrade link.\nPer-minute limits (120 without a key, 300 with a free key, more on paid plans)\nremain as burst protection.\n\n**Archive**: the full daily archive as gzipped CSV, $499 (research and internal\nuse, 30-day link) or $2,990 business edition (internal business use, a year of\nweekly builds). Plans, terms and keys: https://tickermint.cards/developers\n\n\n**For coding agents.** Key: `X-API-Key` header, from the env var `TICKERMINT_API_KEY`\n(free key with an email login: https://tickermint.cards/developers#keys). Plans as JSON: https://tickermint.cards/pricing.json;\nall docs as markdown: https://tickermint.cards/llms-full.txt. Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above. Show\n\"Prices: TickerMint\" linking `tickermint_url` next to the prices. Errors carry\n`error`, `required_plan`, `how_to_fix` and `upgrade_url`; on 429 wait `Retry-After`.\nPrices change once a day: cache answers for an hour or more.\n","version":"1.2","contact":{"name":"The TickerMint team","url":"https://tickermint.cards/developers","email":"hello@tickermint.cards"},"termsOfService":"https://tickermint.cards/developers#terms","license":{"name":"TickerMint API terms","url":"https://tickermint.cards/developers#terms"},"x-logo":{"url":"https://tickermint.cards/apple-touch-icon.png","altText":"TickerMint"},"x-pricing":{"json":"https://tickermint.cards/pricing.json","markdown":"https://tickermint.cards/docs/pricing.md","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."},"x-agent-docs":{"llms_txt":"https://tickermint.cards/llms.txt","llms_full_txt":"https://tickermint.cards/llms-full.txt","errors":"https://tickermint.cards/docs/errors.md","examples":"https://github.com/seankarltonlee/tickermint-examples","env_var":"TICKERMINT_API_KEY"}},"paths":{"/games":{"get":{"summary":"Games Index","description":"Active games + per-game capability flags, for game-aware clients.","operationId":"gamesIndex","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"tags":["Meta"],"x-tickermint-plan":"no_key","x-quota-units":"1 per call"}},"/games/summary":{"get":{"summary":"Games Summary","description":"Homepage MARKETS rail: per-launched-game counts + one top 7d mover\n(logic in tickermint_api.games_summary, anchored per game).","operationId":"gamesSummary","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"tags":["Meta"],"x-tickermint-plan":"no_key","x-quota-units":"1 per call"}},"/health":{"get":{"summary":"Health","description":"Answered on the event loop, not in the worker threadpool (2026-09-25):\nduring a cold start every thread can be busy computing boards, a sync\nhealth check then waits, Docker marks the API unhealthy, and autoheal\nrestarts it, cold again, every eight minutes. Busy is not dead.","operationId":"health","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Health Health Get"}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"tags":["Meta"],"x-tickermint-plan":"no_key","x-quota-units":"1 per call"}},"/products/{product_id}":{"get":{"summary":"Product Detail","operationId":"productDetail","parameters":[{"name":"product_id","in":"path","required":true,"schema":{"type":"integer","title":"Product Id"},"description":"TickerMint product id = the TCGplayer product id (from /products/search).","example":517045}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductOut"},"example":{"product_id":517045,"name":"Charizard ex - 199/165","group_id":23237,"set_name":"SV: Scarlet & Violet 151","card_number":"199/165","rarity":"Special Illustration Rare","image_url":"https://assets.tcgdex.net/en/sv/sv03.5/199/high.webp","card_id":"sv03.5-199","game":"pokemon","market":"300.29","printing":"Holofoil","attribution":{"text":"Prices: TickerMint","url":"https://tickermint.cards/card/517045/charizard-ex-199"},"tickermint_url":"https://tickermint.cards/card/517045/charizard-ex-199"}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"tags":["Cards and products"],"description":"One card or sealed product: name, set, number, rarity, image, the latest TCGplayer market price of its main printing, and an `attribution` object (`text`, `url`) to render next to the price.","x-tickermint-plan":"no_key","x-quota-units":"1 per call"}},"/cards/{card_id}":{"get":{"summary":"Products For Card Id","description":"Look up by a pokemontcg.io card id (\"swsh7-215\", \"sv3pt5-199\") or a\nTCGdex id (\"sv03.5-199\"): the TCGplayer\nproducts for that card (usually one; some printings split), each with its\nmarket. The migration path for apps that stored pokemontcg.io ids, which\nstop resolving when that API shuts down on 2027-03-01 (2026-09-26).","operationId":"productsForCardId","parameters":[{"name":"card_id","in":"path","required":true,"schema":{"type":"string","title":"Card Id"},"description":"A pokemontcg.io card id.","example":"sv3pt5-199"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProductOut"},"title":"Response Products For Card Id Cards  Card Id  Get"},"example":[{"product_id":517045,"name":"Charizard ex - 199/165","set_name":"SV: Scarlet & Violet 151","market":"300.29","tickermint_url":"https://tickermint.cards/card/517045/charizard-ex-199"}]}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"tags":["Cards and products"],"x-tickermint-plan":"no_key","x-quota-units":"1 per call"}},"/products/search":{"get":{"summary":"Search Products","operationId":"searchProducts","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"title":"Q"},"description":"Search text: card name, optionally with the collector number or set.","example":"charizard ex 199/165"},{"name":"game","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Game"},"description":"Card game. One of: pokemon, one-piece, lorcana, riftbound, yugioh, gundam. Omit for Pokemon on most boards.","example":"pokemon"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProductOut"},"title":"Response Search Products Products Search Get"},"example":[{"product_id":517045,"name":"Charizard ex - 199/165","group_id":23237,"set_name":"SV: Scarlet & Violet 151","card_number":"199/165","rarity":"Special Illustration Rare","image_url":"https://assets.tcgdex.net/en/sv/sv03.5/199/high.webp","card_id":"sv03.5-199","game":"pokemon","market":"300.29","tickermint_url":"https://tickermint.cards/card/517045/charizard-ex-199"}]}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"tags":["Cards and products"],"description":"Find cards and sealed products by name, collector number or set. Include the number (`charizard ex 199/165`) to get one card. Each hit carries `product_id` (use it with the other endpoints), the latest TCGplayer `market` price (USD decimal string) and `tickermint_url` (the link to show next to the price).","x-tickermint-plan":"no_key","x-quota-units":"1 per call"}},"/desk/movers":{"get":{"summary":"Movers","operationId":"movers","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":7,"title":"Days"},"description":"Window in days (1 to 90).","example":7},{"name":"min_market","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0.0},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"}],"default":"5","title":"Min Market"},"description":"Ignore cards under this market price (USD).","example":5},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"},"description":"Rows per side.","example":20},{"name":"suppress_solo","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Suppress Solo"},"description":"Hide moves backed by a single sale."},{"name":"min_liquidity","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":3,"title":"Min Liquidity"},"description":"Minimum recent listings for a card to count."},{"name":"game","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Game"},"description":"Card game. One of: pokemon, one-piece, lorcana, riftbound, yugioh, gundam. Omit for Pokemon on most boards.","example":"pokemon"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MoverOut"},"title":"Response Desk Movers Desk Movers Get"}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"tags":["Market"],"description":"Biggest gainers and losers by TCGplayer market price over 1 to 90 days.","x-tickermint-plan":"no_key","x-quota-units":"1 per call"}},"/desk/movers.csv":{"get":{"summary":"Movers CSV","description":"The movers board as CSV, one row per card.","operationId":"moversCsv","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":7,"title":"Days"}},{"name":"min_market","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0.0},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"}],"default":"5","title":"Min Market"}},{"name":"min_liquidity","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":3,"title":"Min Liquidity"}},{"name":"game","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Game"},"description":"Card game. One of: pokemon, one-piece, lorcana, riftbound, yugioh, gundam. Omit for Pokemon on most boards.","example":"pokemon"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"tags":["Spreadsheets and CSV"],"x-tickermint-plan":"no_key","x-quota-units":"1 per call"}},"/products/{product_id}.csv":{"get":{"summary":"Product Price Csv","description":"One card or sealed product as CSV: date, product_id, name, set, number,\nprinting, market_price_usd, url. The latest daily TCGplayer market price of\nthe main printing, the same number its TickerMint page headlines. No key.","operationId":"productPriceCsv","parameters":[{"name":"product_id","in":"path","required":true,"schema":{"type":"integer","title":"Product Id"},"description":"TickerMint product id = the TCGplayer product id (from /products/search).","example":517045}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"CSV and multi-card Sheets answers need a free key.","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"CSV and multi-card Sheets answers need a free key.","error":"key_required","required_plan":"free_key","how_to_fix":"Send a key in the X-API-Key header (env var TICKERMINT_API_KEY). A free key takes an email login: https://tickermint.cards/developers#keys. Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above.","upgrade_url":"https://tickermint.cards/developers?ref=api-key_required#keys","docs_url":"https://tickermint.cards/docs/errors.md#key-required","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"tags":["Spreadsheets and CSV"],"x-tickermint-plan":"free_key","x-quota-units":"1 per card returned"}},"/sets/{group_id}.csv":{"get":{"summary":"Set Price Csv","description":"Every card and sealed product in a set as CSV, one row each in collector\nnumber order: date, product_id, name, set, number, printing,\nmarket_price_usd, url (the latest daily TCGplayer market price of each\nproduct's main printing). No key.","operationId":"setPriceCsv","parameters":[{"name":"group_id","in":"path","required":true,"schema":{"type":"integer","title":"Group Id"},"description":"Set id (TCGplayer group id), from /sets or a product's group_id.","example":23237}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"CSV and multi-card Sheets answers need a free key.","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"CSV and multi-card Sheets answers need a free key.","error":"key_required","required_plan":"free_key","how_to_fix":"Send a key in the X-API-Key header (env var TICKERMINT_API_KEY). A free key takes an email login: https://tickermint.cards/developers#keys. Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above.","upgrade_url":"https://tickermint.cards/developers?ref=api-key_required#keys","docs_url":"https://tickermint.cards/docs/errors.md#key-required","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"tags":["Spreadsheets and CSV"],"x-tickermint-plan":"free_key","x-quota-units":"1 per card returned"}},"/sheets/price":{"get":{"summary":"Sheets Price","description":"One value for one spreadsheet cell, as text/plain: the latest daily\nTCGplayer market price of the card's main printing (the number its\nTickerMint page headlines), or its low, name, url, id or date. Matches like\nthe site search (add the collector number to be sure); a number is a\nTickerMint id. Built for =IMPORTDATA and =TICKERMINT() in Google Sheets.\nNo key.","operationId":"sheetsPrice","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":300,"description":"card name as you would search it, or a TickerMint id","default":"","title":"Q"},"description":"card name as you would search it, or a TickerMint id","example":"charizard ex 199/165"},{"name":"game","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"pokemon, one-piece, lorcana, ...","title":"Game"},"description":"pokemon, one-piece, lorcana, ...","example":"pokemon"},{"name":"field","in":"query","required":false,"schema":{"type":"string","description":"market, low, name, url, id or date","default":"market","title":"Field"},"description":"market, low, name, url, id or date","example":"market"}],"responses":{"200":{"description":"one value, e.g. 322.37","content":{"text/plain":{"schema":{"type":"string"}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"tags":["Spreadsheets and CSV"],"x-tickermint-plan":"no_key","x-quota-units":"1 per call"}},"/sheets/prices":{"get":{"summary":"Sheets Prices","description":"Many cards at once for a range: CSV with a header and one row per q, in\norder: query, name, market, date, url (the same headline price as\n/sheets/price). Up to 50 queries per call; rows past that say skipped, so\nthe rows still line up with your list. No key.","operationId":"sheetsPrices","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"repeat up to 50 times","title":"Q"},"description":"repeat up to 50 times"},{"name":"game","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Game"},"description":"Card game. One of: pokemon, one-piece, lorcana, riftbound, yugioh, gundam. Omit for Pokemon on most boards.","example":"pokemon"}],"responses":{"200":{"description":"query,name,market,date,url","content":{"text/csv":{"schema":{"type":"string"}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"CSV and multi-card Sheets answers need a free key.","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"CSV and multi-card Sheets answers need a free key.","error":"key_required","required_plan":"free_key","how_to_fix":"Send a key in the X-API-Key header (env var TICKERMINT_API_KEY). A free key takes an email login: https://tickermint.cards/developers#keys. Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above.","upgrade_url":"https://tickermint.cards/developers?ref=api-key_required#keys","docs_url":"https://tickermint.cards/docs/errors.md#key-required","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"tags":["Spreadsheets and CSV"],"x-tickermint-plan":"free_key","x-quota-units":"1 per card returned"}},"/sets/{group_id}":{"get":{"summary":"Set Detail","description":"A set's full card list in collector-number order, with latest market prices.","operationId":"setDetail","parameters":[{"name":"group_id","in":"path","required":true,"schema":{"type":"integer","title":"Group Id"},"description":"Set id (TCGplayer group id), from /sets or a product's group_id.","example":23237}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"tags":["Sets"],"x-tickermint-plan":"no_key","x-quota-units":"1 per call"}},"/products/{product_id}/ath":{"get":{"summary":"Product Ath","description":"All-time high and low market price per printing with their dates, and the distance from the high.\n\nAll-time high/low per variant, with the current distance below ATH.","operationId":"productAth","parameters":[{"name":"product_id","in":"path","required":true,"schema":{"type":"integer","title":"Product Id"},"description":"TickerMint product id = the TCGplayer product id (from /products/search).","example":517045}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"as_of":"2026-10-31","tracked_since":"2024-02-08","variants":[{"sub_type_name":"Holofoil","ath_market":"500.42","ath_date":"2026-05-23","atl_market":"99.31","atl_date":"2024-05-14","market":"300.29","pct_off_ath":-0.3999}]}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"tags":["Cards and products"],"x-tickermint-plan":"no_key","x-quota-units":"1 per call"}},"/products/{product_id}/printings":{"get":{"summary":"Product Printings","description":"Every printing of this card we price today (sibling products sharing\nits collector number and name, and each one's variants), priciest first.","operationId":"productPrintings","parameters":[{"name":"product_id","in":"path","required":true,"schema":{"type":"integer","title":"Product Id"},"description":"TickerMint product id = the TCGplayer product id (from /products/search).","example":517045}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"tags":["Cards and products"],"x-tickermint-plan":"no_key","x-quota-units":"1 per call"}},"/products/{product_id}/prices":{"get":{"summary":"Price History","description":"Daily TCGplayer market and low prices per printing (Normal, Holofoil, Reverse Holofoil...). History depth by plan: no key = 30 days, free key = 90 days, paid plans = everything since 2024-02-08. Full history beyond 90 days counts toward the plan's monthly history cap (Developer 10,000, API Pro 25,000, API Business 60,000 different products; API Platform unlimited); ?days=90 or less never does.\n\nAll variants by default; ``representative=1`` narrows to the one variant\nthe share images may quote: priciest with a usable low/market ratio, so a\nceiling sentinel can never anchor a publicly shared number. ``days=N`` keeps\nthe last N days. Full history beyond 90 days counts the card toward the\nplan's monthly history cap (Developer 10,000, API Pro 25,000, API Business\n60,000 different products; API Platform unlimited); 30- and 90-day charts\nnever do.","operationId":"priceHistory","parameters":[{"name":"product_id","in":"path","required":true,"schema":{"type":"integer","title":"Product Id"},"description":"TickerMint product id = the TCGplayer product id (from /products/search).","example":517045},{"name":"representative","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Representative"},"description":"true = only the headline printing.","example":false},{"name":"days","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":10000,"minimum":1},{"type":"null"}],"description":"Only the newest point and the N days before it. 90 or less never counts toward the monthly history cap; full history beyond 90 days does.","title":"Days"},"description":"Only the newest point and the N days before it. 90 or less never counts toward the monthly history cap; full history beyond 90 days does.","example":90}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/PricePoint"}},"title":"Response Price History Products  Product Id  Prices Get"},"example":{"Holofoil":[{"snapshot_date":"2026-10-30","low":"289.99","market":"301.12"},{"snapshot_date":"2026-10-31","low":"290.00","market":"300.29"}]}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"tags":["Cards and products"],"x-tickermint-plan":"no_key","x-quota-units":"1 per call"}},"/v1/bulk/day":{"get":{"summary":"Bulk Day","description":"Every priced printing for one tape day, keyset-paginated 5,000 rows a page.\nA day older than 7 days is history: its products count toward the plan's\nmonthly history cap (Developer 10,000, API Pro 25,000, API Business\n60,000 distinct products; API Platform unlimited). Not during an unpaid trial.","operationId":"bulkDay","parameters":[{"name":"day","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"tape day; default latest","title":"Day"},"description":"tape day; default latest","example":"2026-10-31"},{"name":"game","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Game"},"description":"Card game. One of: pokemon, one-piece, lorcana, riftbound, yugioh, gundam. Omit for Pokemon on most boards.","example":"pokemon"},{"name":"after","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"last product_id of the previous page","default":0,"title":"After"},"description":"last product_id of the previous page"},{"name":"after_variant","in":"query","required":false,"schema":{"type":"string","default":"","title":"After Variant"},"description":"Paging cursor: the last variant of the previous page."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"No key, or an unknown key. Needs a Developer key.","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"No key, or an unknown key. Needs a Developer key.","error":"key_required","required_plan":"developer","how_to_fix":"Send a key in the X-API-Key header (env var TICKERMINT_API_KEY). A free key takes an email login: https://tickermint.cards/developers#keys. Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above.","upgrade_url":"https://tickermint.cards/developers?ref=api-key_required&plan=developer#plan","docs_url":"https://tickermint.cards/docs/errors.md#key-required","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}},"402":{"description":"The key's plan does not include this endpoint (Developer and up).","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"The key's plan does not include this endpoint (Developer and up).","error":"plan_required","required_plan":"developer","how_to_fix":"This endpoint needs Developer or above. Plans and prices: https://tickermint.cards/pricing.json; subscribe at https://tickermint.cards/developers?ref=api-plan-required&plan=developer#plan (7-day free trial).","upgrade_url":"https://tickermint.cards/developers?ref=api-plan_required&plan=developer#plan","docs_url":"https://tickermint.cards/docs/errors.md#plan-required","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{"ApiKeyHeader":[]}],"tags":["Bulk (Developer and up)"],"x-tickermint-plan":"developer","x-quota-units":"1 per row returned"}},"/v1/graded/products/{product_id}":{"get":{"tags":["Meta"],"summary":"Graded Product","description":"Graded values for one card: ungraded, grades 1 to 9.5 (any grader), PSA,\nBGS, CGC, SGC, TAG and ACE 10s, from sold listings, with the as-of day. Values\ncome from PriceCharting: show \"Prices from PriceCharting\" with the `attribution`\nlink wherever they appear. Graded prices add-on only (API Pro and up).","operationId":"gradedProduct","parameters":[{"name":"product_id","in":"path","required":true,"schema":{"type":"integer","title":"Product Id"}},{"name":"printing","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":63},{"type":"null"}],"description":"printing (sub_type_name); default the card's main one","title":"Printing"},"description":"printing (sub_type_name); default the card's main one"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"x-tickermint-plan":"no_key","x-quota-units":"1 per call"}},"/v1/graded/products/{product_id}/history":{"get":{"tags":["Meta"],"summary":"Graded History","description":"Daily graded values for one card, from TickerMint's own daily record\n(starts 2026-10-31). Graded prices add-on only.","operationId":"gradedHistory","parameters":[{"name":"product_id","in":"path","required":true,"schema":{"type":"integer","title":"Product Id"}},{"name":"printing","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":63},{"type":"null"}],"title":"Printing"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":365,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"x-tickermint-plan":"no_key","x-quota-units":"1 per call"}},"/v1/graded/products/batch":{"post":{"tags":["Meta"],"summary":"Graded Batch","description":"Graded values for up to 100 cards in one call (one lookup per card\nreturned). Graded prices add-on only.","operationId":"gradedBatch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GradedBatchIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"x-tickermint-plan":"no_key","x-quota-units":"not metered"}},"/v1/graded/bulk/day":{"get":{"tags":["Meta"],"summary":"Graded Bulk Day","description":"Every card with graded values in one game, the latest day, keyset-paginated\n2,000 cards a page (one lookup per card). Graded prices add-on only.","operationId":"gradedBulkDay","parameters":[{"name":"game","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Game"}},{"name":"after","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"last product_id of the previous page","default":0,"title":"After"},"description":"last product_id of the previous page"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"x-tickermint-plan":"no_key","x-quota-units":"1 per call"}},"/v1/bulk/history":{"get":{"summary":"Bulk History","description":"Full daily history for up to 50 products in one call. Counts toward the\nplan's monthly history cap: Developer 10,000, API Pro 25,000, API\nBusiness 60,000 distinct products (API Platform unlimited); products already\nfetched this month are free again. Not during an unpaid trial.","operationId":"bulkHistory","parameters":[{"name":"ids","in":"query","required":true,"schema":{"type":"string","description":"comma-separated product ids, up to 50","title":"Ids"},"description":"comma-separated product ids, up to 50","example":"517045,246723"},{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Since"},"description":"Only days on or after YYYY-MM-DD.","example":"2026-01-01"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"No key, or an unknown key. Needs a Developer key.","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"No key, or an unknown key. Needs a Developer key.","error":"key_required","required_plan":"developer","how_to_fix":"Send a key in the X-API-Key header (env var TICKERMINT_API_KEY). A free key takes an email login: https://tickermint.cards/developers#keys. Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above.","upgrade_url":"https://tickermint.cards/developers?ref=api-key_required&plan=developer#plan","docs_url":"https://tickermint.cards/docs/errors.md#key-required","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}},"402":{"description":"The key's plan does not include this endpoint (Developer and up).","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"The key's plan does not include this endpoint (Developer and up).","error":"plan_required","required_plan":"developer","how_to_fix":"This endpoint needs Developer or above. Plans and prices: https://tickermint.cards/pricing.json; subscribe at https://tickermint.cards/developers?ref=api-plan-required&plan=developer#plan (7-day free trial).","upgrade_url":"https://tickermint.cards/developers?ref=api-plan_required&plan=developer#plan","docs_url":"https://tickermint.cards/docs/errors.md#plan-required","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{"ApiKeyHeader":[]}],"tags":["Bulk (Developer and up)"],"x-tickermint-plan":"developer","x-quota-units":"1 per product returned"}},"/v1/bulk/base-rates":{"get":{"summary":"Bulk Base Rates","description":"The base-rate table behind every verdict: what cards in each\n(distance from high, 30-day move) bin did over the next 90 days.\nThe archive starts in February 2024 and is mostly a rising market, so\nread each rate against its period: the same cells ran 48 to 58% up in\nflat months of 2024 and 77 to 86% in the 2026 run-up, and net of\nmarketplace fees of about 13% most short holds lost money.","operationId":"bulkBaseRates","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"401":{"description":"No key, or an unknown key. Needs a Developer key.","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"No key, or an unknown key. Needs a Developer key.","error":"key_required","required_plan":"developer","how_to_fix":"Send a key in the X-API-Key header (env var TICKERMINT_API_KEY). A free key takes an email login: https://tickermint.cards/developers#keys. Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above.","upgrade_url":"https://tickermint.cards/developers?ref=api-key_required&plan=developer#plan","docs_url":"https://tickermint.cards/docs/errors.md#key-required","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}},"402":{"description":"The key's plan does not include this endpoint (Developer and up).","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"The key's plan does not include this endpoint (Developer and up).","error":"plan_required","required_plan":"developer","how_to_fix":"This endpoint needs Developer or above. Plans and prices: https://tickermint.cards/pricing.json; subscribe at https://tickermint.cards/developers?ref=api-plan-required&plan=developer#plan (7-day free trial).","upgrade_url":"https://tickermint.cards/developers?ref=api-plan_required&plan=developer#plan","docs_url":"https://tickermint.cards/docs/errors.md#plan-required","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{"ApiKeyHeader":[]}],"tags":["Bulk (Developer and up)"],"x-tickermint-plan":"developer","x-quota-units":"1 per call"}},"/v1/webhooks":{"get":{"summary":"List Webhooks","description":"This key's webhooks (secrets are never listed).","operationId":"listWebhooks","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/WebhookOut"},"type":"array","title":"Response List Webhooks V1 Webhooks Get"}}}},"401":{"description":"No key, or an unknown key. Needs a API Pro key.","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"No key, or an unknown key. Needs a API Pro key.","error":"key_required","required_plan":"api_pro","how_to_fix":"Send a key in the X-API-Key header (env var TICKERMINT_API_KEY). A free key takes an email login: https://tickermint.cards/developers#keys. Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above.","upgrade_url":"https://tickermint.cards/developers?ref=api-key_required&plan=api_pro#plan","docs_url":"https://tickermint.cards/docs/errors.md#key-required","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}},"403":{"description":"The key's plan does not include this endpoint (API Pro and up).","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"The key's plan does not include this endpoint (API Pro and up).","error":"plan_required","required_plan":"api_pro","how_to_fix":"This endpoint needs API Pro or above. Plans and prices: https://tickermint.cards/pricing.json; subscribe at https://tickermint.cards/developers?ref=api-plan-required&plan=api_pro#plan (7-day free trial).","upgrade_url":"https://tickermint.cards/developers?ref=api-plan_required&plan=api_pro#plan","docs_url":"https://tickermint.cards/docs/errors.md#plan-required","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{"ApiKeyHeader":[]}],"tags":["Webhooks (API Pro and up)"],"x-tickermint-plan":"api_pro","x-quota-units":"1 per call"},"post":{"summary":"Create Webhook","description":"Create a webhook. price.moved fires after the nightly price update when\na watched product's market price moved at least threshold_pct since the\nday before; product.added fires for products of `game` seen for the first\ntime that night. Events from one night arrive as one signed POST. The\nsigning secret is returned once.","operationId":"createWebhook","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookCreated"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"No key, or an unknown key. Needs a API Pro key.","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"No key, or an unknown key. Needs a API Pro key.","error":"key_required","required_plan":"api_pro","how_to_fix":"Send a key in the X-API-Key header (env var TICKERMINT_API_KEY). A free key takes an email login: https://tickermint.cards/developers#keys. Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above.","upgrade_url":"https://tickermint.cards/developers?ref=api-key_required&plan=api_pro#plan","docs_url":"https://tickermint.cards/docs/errors.md#key-required","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}},"403":{"description":"The key's plan does not include this endpoint (API Pro and up).","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"The key's plan does not include this endpoint (API Pro and up).","error":"plan_required","required_plan":"api_pro","how_to_fix":"This endpoint needs API Pro or above. Plans and prices: https://tickermint.cards/pricing.json; subscribe at https://tickermint.cards/developers?ref=api-plan-required&plan=api_pro#plan (7-day free trial).","upgrade_url":"https://tickermint.cards/developers?ref=api-plan_required&plan=api_pro#plan","docs_url":"https://tickermint.cards/docs/errors.md#plan-required","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{"ApiKeyHeader":[]}],"tags":["Webhooks (API Pro and up)"],"x-tickermint-plan":"api_pro","x-quota-units":"not metered"}},"/v1/webhooks/{webhook_id}":{"delete":{"summary":"Delete Webhook","description":"Stop a webhook. Pending retries stop too.","operationId":"deleteWebhook","parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"integer","title":"Webhook Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"No key, or an unknown key. Needs a API Pro key.","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"No key, or an unknown key. Needs a API Pro key.","error":"key_required","required_plan":"api_pro","how_to_fix":"Send a key in the X-API-Key header (env var TICKERMINT_API_KEY). A free key takes an email login: https://tickermint.cards/developers#keys. Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above.","upgrade_url":"https://tickermint.cards/developers?ref=api-key_required&plan=api_pro#plan","docs_url":"https://tickermint.cards/docs/errors.md#key-required","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}},"403":{"description":"The key's plan does not include this endpoint (API Pro and up).","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"The key's plan does not include this endpoint (API Pro and up).","error":"plan_required","required_plan":"api_pro","how_to_fix":"This endpoint needs API Pro or above. Plans and prices: https://tickermint.cards/pricing.json; subscribe at https://tickermint.cards/developers?ref=api-plan-required&plan=api_pro#plan (7-day free trial).","upgrade_url":"https://tickermint.cards/developers?ref=api-plan_required&plan=api_pro#plan","docs_url":"https://tickermint.cards/docs/errors.md#plan-required","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{"ApiKeyHeader":[]}],"tags":["Webhooks (API Pro and up)"],"x-tickermint-plan":"api_pro","x-quota-units":"not metered"}},"/v1/webhooks/{webhook_id}/test":{"post":{"summary":"Test Webhook","description":"Send a signed webhook.test event now and return what your endpoint\nanswered. Tests are not retried and never disable the webhook.","operationId":"testWebhook","parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"integer","title":"Webhook Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookTestResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"No key, or an unknown key. Needs a API Pro key.","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"No key, or an unknown key. Needs a API Pro key.","error":"key_required","required_plan":"api_pro","how_to_fix":"Send a key in the X-API-Key header (env var TICKERMINT_API_KEY). A free key takes an email login: https://tickermint.cards/developers#keys. Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above.","upgrade_url":"https://tickermint.cards/developers?ref=api-key_required&plan=api_pro#plan","docs_url":"https://tickermint.cards/docs/errors.md#key-required","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}},"403":{"description":"The key's plan does not include this endpoint (API Pro and up).","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"The key's plan does not include this endpoint (API Pro and up).","error":"plan_required","required_plan":"api_pro","how_to_fix":"This endpoint needs API Pro or above. Plans and prices: https://tickermint.cards/pricing.json; subscribe at https://tickermint.cards/developers?ref=api-plan-required&plan=api_pro#plan (7-day free trial).","upgrade_url":"https://tickermint.cards/developers?ref=api-plan_required&plan=api_pro#plan","docs_url":"https://tickermint.cards/docs/errors.md#plan-required","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{"ApiKeyHeader":[]}],"tags":["Webhooks (API Pro and up)"],"x-tickermint-plan":"api_pro","x-quota-units":"not metered"}},"/desk/today":{"get":{"summary":"Market Today","description":"The daily-return hook: what actually happened on the latest tape: biggest 1-day moves (artifact-suppressed), fresh all-time highs, and the\nlargest dollar swings. No sales-volume data exists upstream (TCGCSV is\nprice-only), so 'most sold' is impossible; this is the honest version.","operationId":"marketToday","parameters":[{"name":"game","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Game"},"description":"Card game. One of: pokemon, one-piece, lorcana, riftbound, yugioh, gundam. Omit for Pokemon on most boards.","example":"pokemon"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"tags":["Market"],"x-tickermint-plan":"no_key","x-quota-units":"1 per call"}},"/desk/highs":{"get":{"summary":"All-Time Highs","description":"Cards that set an all-time high this week and still hold it (singles).","operationId":"allTimeHighs","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":100,"title":"Limit"},"example":25},{"name":"game","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Game"},"description":"Card game. One of: pokemon, one-piece, lorcana, riftbound, yugioh, gundam. Omit for Pokemon on most boards.","example":"pokemon"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"tags":["Market"],"x-tickermint-plan":"no_key","x-quota-units":"1 per call"}},"/desk/lows":{"get":{"summary":"All-Time Lows","description":"Cards sitting at their all-time low after a real fall (singles, $5+).","operationId":"allTimeLows","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":100,"title":"Limit"},"example":25},{"name":"game","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Game"},"description":"Card game. One of: pokemon, one-piece, lorcana, riftbound, yugioh, gundam. Omit for Pokemon on most boards.","example":"pokemon"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"tags":["Market"],"x-tickermint-plan":"no_key","x-quota-units":"1 per call"}},"/desk/sealed":{"get":{"summary":"Sealed Prices","description":"Sealed product priced (latest day), by kind: booster boxes, ETBs,\nbundles, packs, tins, cases. The answer page for \"{set} ETB price\".","operationId":"sealedPrices","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":300,"minimum":1,"default":100,"title":"Limit"},"example":25},{"name":"game","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Game"},"description":"Card game. One of: pokemon, one-piece, lorcana, riftbound, yugioh, gundam. Omit for Pokemon on most boards.","example":"pokemon"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"tags":["Market"],"x-tickermint-plan":"no_key","x-quota-units":"1 per call"}},"/desk/raffles":{"get":{"summary":"Raffles and Drawings","description":"Official raffles, drawings and lotteries for buying sealed at the\nretailer's price: open now (closing soonest first), upcoming, and closed\nin the last 30 days. Each carries the entry window (UTC, plus the\nsource's own timezone and wording), how it works, the official link, the\nsource and the day we verified it, and for products we track today's\nTCGplayer market price next to the price a winner pays. Hand-kept from\npublic announcements only (tickermint_desk.raffles); `status` is\ncomputed from the window at answer time. Filter by game, by set\n(group_id: the raffle's set or any of its products') or by product.","operationId":"raffles","parameters":[{"name":"game","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Game"}},{"name":"group_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Group Id"}},{"name":"product_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Product Id"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"open, upcoming or closed","title":"Status"},"description":"open, upcoming or closed"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"tags":["Meta"],"x-tickermint-plan":"no_key","x-quota-units":"1 per call"}},"/desk/most-valuable":{"get":{"summary":"Most Valuable","description":"Most valuable singles by TickerMint market price (TCGplayer market,\nlatest day), thin or plateaued prices ranked below clean ones, plus the\ncards closest to their all-time high. Free callers get the top 25.","operationId":"mostValuable","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"},"example":25},{"name":"game","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Game"},"description":"Card game. One of: pokemon, one-piece, lorcana, riftbound, yugioh, gundam. Omit for Pokemon on most boards.","example":"pokemon"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"tags":["Market"],"x-tickermint-plan":"no_key","x-quota-units":"1 per call"}},"/sets":{"get":{"summary":"Sets Index","description":"Every tracked set of a game, newest first, with its card count and total market value.\n\nEvery set with card count + set market value, newest first.","operationId":"setsIndex","parameters":[{"name":"game","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Game"},"description":"Card game. One of: pokemon, one-piece, lorcana, riftbound, yugioh, gundam. Omit for Pokemon on most boards.","example":"pokemon"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":[{"group_id":24722,"name":"ME: 30th Celebration","abbreviation":"30C","published_on":"2026-09-16","card_count":223,"total_market":"27952.16","singles_market":"12979.56"}]}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"tags":["Sets"],"x-tickermint-plan":"no_key","x-quota-units":"1 per call"}},"/releases":{"get":{"summary":"Releases","description":"Drops & Releases radar: recent + upcoming sets with sealed-product\nprices and week-one market moves: the ToS-safe answer to drop alerts.","operationId":"releases","parameters":[{"name":"game","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Game"},"description":"Card game. One of: pokemon, one-piece, lorcana, riftbound, yugioh, gundam. Omit for Pokemon on most boards.","example":"pokemon"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"tags":["Sets"],"x-tickermint-plan":"no_key","x-quota-units":"1 per call"}},"/releases/since":{"get":{"summary":"Releases Since","description":"New-releases board: every set of the last year ranked by how its 25\npriciest singles moved since release day (median), with the biggest drop\nand gain and the sealed products' change (logic in set_answers).","operationId":"releasesSince","parameters":[{"name":"game","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Game"},"description":"Card game. One of: pokemon, one-piece, lorcana, riftbound, yugioh, gundam. Omit for Pokemon on most boards.","example":"pokemon"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"tags":["Sets"],"x-tickermint-plan":"no_key","x-quota-units":"1 per call"}},"/releases/day-returns":{"get":{"summary":"Releases Day Returns","description":"Release-day returns: every booster box, display, Elite Trainer Box and\nbooster bundle released since 2024-02-08, its launch price (median market\nover its first 14 days) next to today's market, ranked best first (logic\nin set_answers). Recomputed once per tape day.","operationId":"releasesDayReturns","parameters":[{"name":"game","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Game"},"description":"Card game. One of: pokemon, one-piece, lorcana, riftbound, yugioh, gundam. Omit for Pokemon on most boards.","example":"pokemon"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"tags":["Sets"],"x-tickermint-plan":"no_key","x-quota-units":"1 per call"}},"/desk/index":{"get":{"summary":"Market Indexes","description":"The TickerMint index of every game (e.g. TickerMint Pokemon 100): level, daily, weekly, monthly and year-to-date change, and a citation line. Rules: https://tickermint.cards/index/methodology\n\nThe TickerMint index of every launched game: level, 1-day, 7-day,\n30-day and year-to-date change, all-time and 52-week range, a 90-day\nsparkline and the one-line citation (tickermint_desk.market_index).","operationId":"marketIndexes","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"tags":["Market"],"x-tickermint-plan":"no_key","x-quota-units":"1 per call"}},"/desk/index/{game}":{"get":{"summary":"Market Index","description":"One game's TickerMint index: every daily level since the base day (1,000), the current constituents with weights, and the rules.\n\nOne game's TickerMint index: the summary, every daily level since the\nbase day, the current constituents (art, printing, base and latest price,\nweight), the rules in numbers and the game's latest wire facts.","operationId":"marketIndex","parameters":[{"name":"game","in":"path","required":true,"schema":{"type":"string","title":"Game"},"description":"Card game. One of: pokemon, one-piece, lorcana, riftbound, yugioh, gundam. Omit for Pokemon on most boards.","example":"pokemon"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"tags":["Market"],"x-tickermint-plan":"no_key","x-quota-units":"1 per call"}},"/desk/wire":{"get":{"summary":"Wire","description":"The wire: dated one-sentence facts (index moves, record highs, biggest movers, new-set box vs presale), each with its permalink. Whole days per page, newest first.\n\nThe wire: single dated facts, newest first, each one sentence with its\nnumber, date, source link and permalink (tickermint_desk.wire). Whole\ndays per page; `next_before` pages back.","operationId":"wire","parameters":[{"name":"game","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"one game; omit for every game","title":"Game"},"description":"one game; omit for every game","example":"pokemon"},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":60,"minimum":1,"description":"days of facts per page","default":7,"title":"Days"},"description":"days of facts per page","example":7},{"name":"before","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"facts before this day, YYYY-MM-DD","title":"Before"},"description":"facts before this day, YYYY-MM-DD","example":"2026-11-03"},{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind"},"description":"One kind: index, record_highs, top_gainer, top_decliner, dollar_move, box_presale."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"tags":["Market"],"x-tickermint-plan":"no_key","x-quota-units":"1 per call"}},"/desk/wire/{fact_id}":{"get":{"summary":"Wire Fact","description":"One wire fact by its permalink id.\n\nOne wire fact by its permalink id (e.g. 2026-11-03-pokemon-index).","operationId":"wireFact","parameters":[{"name":"fact_id","in":"path","required":true,"schema":{"type":"string","title":"Fact Id"},"description":"Fact id, from /desk/wire.","example":"2026-11-03-pokemon-index"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"tags":["Market"],"x-tickermint-plan":"no_key","x-quota-units":"1 per call"}},"/decks":{"get":{"summary":"Decks Index","description":"Every active archetype with its typical-list cost and week change.","operationId":"decksIndex","parameters":[{"name":"game","in":"query","required":false,"schema":{"type":"string","default":"pokemon","title":"Game"},"description":"pokemon or one-piece.","example":"pokemon"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"tags":["Market"],"x-tickermint-plan":"no_key","x-quota-units":"1 per call"}},"/decks/{game}/{slug}":{"get":{"summary":"Deck Detail","description":"One archetype's typical list, priced. With a session, `owned` says how\nmany of its cards the member already has (any equivalent printing).","operationId":"deckDetail","parameters":[{"name":"game","in":"path","required":true,"schema":{"type":"string","title":"Game"},"description":"pokemon or one-piece.","example":"pokemon"},{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"},"description":"Archetype or leader slug from /decks.","example":"dragapult-ex"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-Quota-Limit":{"description":"Lookups allowed in the current period.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left in the current period.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the period resets, Unix seconds.","schema":{"type":"integer"}},"X-Quota-Period":{"description":"day (no key, free key) or month (paid plans).","schema":{"type":"string"}},"X-Quota-Plan":{"description":"no-key, free, developer, api_pro, api_business or api_platform.","schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Over the daily or monthly lookup quota, or the per-minute burst limit.","headers":{"Retry-After":{"description":"Seconds until you may retry.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"detail":"Over the daily or monthly lookup quota, or the per-minute burst limit.","error":"quota_exceeded","required_plan":"free_key","how_to_fix":"See https://tickermint.cards/docs/errors.md","upgrade_url":"https://tickermint.cards/developers?ref=api-quota_exceeded#keys","docs_url":"https://tickermint.cards/docs/errors.md#quota-exceeded","pricing_url":"https://tickermint.cards/pricing.json","commercial_use":"Free keys and Developer are for personal and non-commercial use. A store, a paid app or any product a business runs needs API Pro ($49/mo) or above."}}}}},"security":[{},{"ApiKeyHeader":[]}],"tags":["Market"],"x-tickermint-plan":"no_key","x-quota-units":"1 per call"}}},"components":{"schemas":{"GradedBatchIn":{"properties":{"product_ids":{"items":{"type":"integer"},"type":"array","maxItems":100,"minItems":1,"title":"Product Ids"}},"type":"object","required":["product_ids"],"title":"GradedBatchIn"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"MoverOut":{"properties":{"product_id":{"type":"integer","title":"Product Id"},"name":{"type":"string","title":"Name"},"group_id":{"type":"integer","title":"Group Id"},"set_name":{"type":"string","title":"Set Name"},"sub_type_name":{"type":"string","title":"Sub Type Name"},"card_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Card Number"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url"},"thin":{"type":"boolean","title":"Thin","default":false},"solo_variant":{"type":"boolean","title":"Solo Variant","default":false},"recovery":{"type":"boolean","title":"Recovery","default":false},"base_market":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Base Market"},"market":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Market"},"pct_change":{"type":"number","title":"Pct Change"}},"type":"object","required":["product_id","name","group_id","set_name","sub_type_name","base_market","market","pct_change"],"title":"MoverOut"},"PricePoint":{"properties":{"snapshot_date":{"type":"string","title":"Snapshot Date"},"low":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Low"},"market":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Market"}},"type":"object","required":["snapshot_date","low","market"],"title":"PricePoint"},"ProductOut":{"properties":{"product_id":{"type":"integer","title":"Product Id"},"name":{"type":"string","title":"Name"},"group_id":{"type":"integer","title":"Group Id"},"set_name":{"type":"string","title":"Set Name"},"card_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Card Number"},"rarity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rarity"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"card_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Card Id"},"artist":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Artist"},"game":{"type":"string","title":"Game","default":"pokemon"},"market":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Market"},"printing":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Printing"},"game_data":{"anyOf":[{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array"},{"type":"null"}],"title":"Game Data"},"character":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Character"},"variant_premium":{"anyOf":[{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"object"},{"type":"null"}],"title":"Variant Premium"},"attribution":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Attribution"},"tickermint_url":{"type":"string","title":"Tickermint Url","description":"The TickerMint card page: the link back the free API terms ask for\n(`url` is the TCGplayer page).","readOnly":true}},"type":"object","required":["product_id","name","group_id","set_name","card_number","rarity","image_url","card_id","artist","tickermint_url"],"title":"ProductOut"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"WebhookCreated":{"properties":{"webhook_id":{"type":"integer","title":"Webhook Id"},"url":{"type":"string","title":"Url"},"product_ids":{"items":{"type":"integer"},"type":"array","title":"Product Ids"},"threshold_pct":{"type":"number","title":"Threshold Pct"},"events":{"items":{"type":"string"},"type":"array","title":"Events"},"game":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Game"},"status":{"type":"string","title":"Status","description":"active, or disabled after 20 failed attempts in a row"},"created_at":{"type":"string","title":"Created At"},"consecutive_failures":{"type":"integer","title":"Consecutive Failures"},"secret":{"type":"string","title":"Secret","description":"signing secret, shown only in this response"}},"type":"object","required":["webhook_id","url","product_ids","threshold_pct","events","status","created_at","consecutive_failures","secret"],"title":"WebhookCreated"},"WebhookIn":{"properties":{"url":{"type":"string","title":"Url","description":"https URL on the public internet; we POST JSON to it"},"product_ids":{"items":{"type":"integer"},"type":"array","title":"Product Ids","description":"products to watch for price.moved, up to 500"},"threshold_pct":{"type":"number","maximum":1000.0,"minimum":1.0,"title":"Threshold Pct","description":"send price.moved when the market price moves at least this many percent","default":10.0},"events":{"items":{"type":"string"},"type":"array","title":"Events","description":"price.moved, product.added or both"},"game":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Game","description":"game slug for product.added (pokemon, one-piece, ...)"}},"type":"object","required":["url"],"title":"WebhookIn"},"WebhookOut":{"properties":{"webhook_id":{"type":"integer","title":"Webhook Id"},"url":{"type":"string","title":"Url"},"product_ids":{"items":{"type":"integer"},"type":"array","title":"Product Ids"},"threshold_pct":{"type":"number","title":"Threshold Pct"},"events":{"items":{"type":"string"},"type":"array","title":"Events"},"game":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Game"},"status":{"type":"string","title":"Status","description":"active, or disabled after 20 failed attempts in a row"},"created_at":{"type":"string","title":"Created At"},"consecutive_failures":{"type":"integer","title":"Consecutive Failures"}},"type":"object","required":["webhook_id","url","product_ids","threshold_pct","events","status","created_at","consecutive_failures"],"title":"WebhookOut"},"WebhookTestResult":{"properties":{"delivery_id":{"type":"string","title":"Delivery Id"},"delivered":{"type":"boolean","title":"Delivered"},"http_status":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Http Status"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["delivery_id","delivered"],"title":"WebhookTestResult"},"ApiError":{"type":"object","description":"Every 401/402/403/429 on the API. `detail` is the human sentence; the other fields say what to do. Docs: https://tickermint.cards/docs/errors.md","properties":{"detail":{"description":"What happened, in one sentence (a string)."},"error":{"type":"string","enum":["key_required","invalid_key","plan_required","quota_exceeded","rate_limited"]},"required_plan":{"type":["string","null"],"enum":["free_key","developer","api_pro","api_business","api_platform","enterprise",null],"description":"The cheapest plan that fixes it."},"how_to_fix":{"type":"string","description":"One sentence: what to do, with the URL."},"upgrade_url":{"type":"string","format":"uri"},"docs_url":{"type":"string","format":"uri"},"pricing_url":{"type":"string","format":"uri"},"commercial_use":{"type":"string"},"quota":{"type":"object","description":"On quota answers: plan, limit, used, period, resets_at."}},"required":["detail","error"]}},"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Developer, API Pro or API Business key from https://tickermint.cards/developers. Optional on the free endpoints (raises the rate limit), required for /v1/bulk and /v1/webhooks (API Pro and up)."}}},"servers":[{"url":"https://api.tickermint.cards","description":"Production (read-only; no key needed to try it)"}],"externalDocs":{"description":"Quickstarts, plans and terms","url":"https://tickermint.cards/developers"},"tags":[{"name":"Cards and products","description":"Find cards and sealed products, their latest price and daily history."},{"name":"Sets","description":"Set lists with today's prices, releases and release-day returns."},{"name":"Market","description":"Movers, all-time highs and lows, most valuable cards, sealed boards, deck costs."},{"name":"Spreadsheets and CSV","description":"Plain answers for Google Sheets IMPORTDATA, Excel Power Query and CSV tools."},{"name":"Bulk (Developer and up)","description":"Whole days and full histories in few calls. Needs a key on Developer or above, not during an unpaid trial. Full history beyond 90 days (/v1/bulk/history, /v1/bulk/day for days older than 7 days, single-card history deeper than 90 days) counts toward a monthly cap in different products: Developer 10,000, API Pro 25,000, API Business 60,000, API Platform unlimited."},{"name":"Webhooks (API Pro and up)","description":"Price-move and new-product events sent to your server."},{"name":"Meta","description":"Games, coverage and health."}]}