{"name":"CardZ Marketcap public API","version":"v1","description":"Daily PSA 10 market capitalisation for graded Pokémon TCG and One Piece Card Game cards. Market cap is the verified PSA 10 population multiplied by a PSA 10 reference price.","documentation":"https://cardzmarketcap.com/data","llmsTxt":"https://cardzmarketcap.com/llms.txt","llmsFullTxt":"https://cardzmarketcap.com/llms-full.txt","methodology":"https://cardzmarketcap.com/methodology","dataset":{"generation":"db3308_2057fb45d3d32982","generatedAt":"2026-11-03T03:23:28.827Z","effectiveAt":"2026-11-03T00:00:00Z","cardCount":1677,"top100Count":100,"watchlistCount":1577,"sealedProductCount":345},"updateCadence":{"frequency":"daily","description":"Every reference price, population and market cap is recalculated on each daily build. Quote the effectiveAt date with any figure.","cacheControl":"public, s-maxage=300, stale-while-revalidate=300"},"endpoints":[{"method":"GET","path":"/api/v1","url":"https://cardzmarketcap.com/api/v1","description":"This index: endpoint list, field dictionary, update cadence and attribution requirement."},{"method":"GET","path":"/api/v1/search","url":"https://cardzmarketcap.com/api/v1/search","description":"Look up a card or sealed box by name, nickname or collector number. Matches English, Traditional Chinese, Simplified Chinese, Japanese and Korean. Folded substring, not typo-fuzzy.","query":{"q":{"type":"string","required":true,"description":"Name, nickname or collector number. Empty returns 400."},"lang":{"values":["en","zh-TW","zh-CN","ja","ko"],"default":"en","description":"Ranks display names; matching still uses every language."},"kind":{"values":["card","box"],"description":"Omit to search both."},"tcg":{"values":["pokemon","one-piece"],"description":"Omit to search both games."},"limit":{"type":"positive integer","default":8,"max":50}},"examples":["https://cardzmarketcap.com/api/v1/search?q=%E6%A2%B5%E9%AB%98%E7%9A%AE%E5%8D%A1%E4%B8%98&lang=zh-TW","https://cardzmarketcap.com/api/v1/search?q=moonbreon","https://cardzmarketcap.com/api/v1/search?q=217/187","https://cardzmarketcap.com/api/v1/search?q=OP05-119"]},{"method":"GET","path":"/api/v1/resolve","url":"https://cardzmarketcap.com/api/v1/resolve","description":"Same search, but returns one card when the top hit is uniquely strong. Ambiguous names return resolved:null and a short candidate list.","query":{"q":{"type":"string","required":true},"lang":{"values":["en","zh-TW","zh-CN","ja","ko"],"default":"en"},"kind":{"values":["card","box"]},"tcg":{"values":["pokemon","one-piece"]}},"examples":["https://cardzmarketcap.com/api/v1/resolve?q=217/187","https://cardzmarketcap.com/api/v1/resolve?q=%E6%9C%88%E4%BA%AE%E4%BC%8A%E5%B8%83&lang=zh-TW"]},{"method":"GET","path":"/api/v1/market","url":"https://cardzmarketcap.com/api/v1/market","description":"Ranked cards with market cap, PSA 10 reference price, verified PSA 10 population and window changes.","query":{"scope":{"values":["all","pokemon","one-piece","watchlist"],"default":"all","description":"all and the two game scopes return the top 100 of that scope; watchlist returns rank 101 and beyond."},"page":{"type":"positive integer","default":1,"description":"watchlist scope only; other scopes return one page."},"pageSize":{"type":"positive integer","default":200,"max":500}},"examples":["https://cardzmarketcap.com/api/v1/market","https://cardzmarketcap.com/api/v1/market?scope=pokemon","https://cardzmarketcap.com/api/v1/market?scope=one-piece","https://cardzmarketcap.com/api/v1/market?scope=watchlist&page=2"]},{"method":"GET","path":"/api/v1/cards/{id}","url":"https://cardzmarketcap.com/api/v1/cards/{id}","description":"One card, including its full daily price and tracked-sales history.","examples":["https://cardzmarketcap.com/api/v1/cards/cmc_fc229f7ae1b256b2119fa79b"]}],"fields":{"generation.id":"Identifier of the dataset build that produced these figures.","generatedAt":"ISO timestamp of the build.","effectiveAt":"ISO date the figures are effective for. Cite this date with any number.","coverage.claim":"verified-top-100 or verified-top-n for the requested scope.","cards[].id":"Stable public card id; also the /card/{id} URL segment.","cards[].marketRank":"Rank by market cap across the whole index.","cards[].viewRank":"Rank inside the requested scope.","cards[].tcg":"Pokémon or One Piece.","cards[].cardLanguage":"Printing language (en, ja, ko, zhCN, zhTW) — not the UI language.","cards[].officialName":"Canonical PSA/graded full name of the printing.","cards[].setName":"Localised set name keyed by locale; non-English values are null when no translation exists.","cards[].collectorNumber":"Collector number as printed.","cards[].pricePsa10":"{ value: USD | null, status, asOf } — PSA 10 reference price.","cards[].populationPsa10":"{ value: count | null, status, asOf } — verified PSA 10 population.","cards[].marketCap":"{ value: USD | null, status, asOf } — population x reference price.","cards[].windows":"Keyed 1d, 7d, 30d, 90d, 180d, 365d. changePct is the price change; marketCapChangePct is the market-cap change; trackedSales covers completed sales inside tracked coverage.","cards[].historyDaily":"Single-card endpoint only: daily points { at, priceUsd, priceStatus, trackedSalesValueUsd, trackedSalesCount }.","hits[].match":"Why the hit ranked: number-exact, number-prefix, name-exact, name-prefix, official-prefix, or contains.","hits[].url":"Canonical public page for the hit. Cite this URL with the effectiveAt date.","citation":"Ready-to-paste attribution line. A figure without its date is not attributable to us.","resolve.ambiguous":"true when more than one printing is a strong match. Do not guess — show hits or ask.","null semantics":"A null value means the figure is not published for that window. It never means zero."},"license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/","attribution":"CardZ Marketcap, https://cardzmarketcap.com, data as of 2026-11-03","requirement":"Name CardZ Marketcap, link the page or endpoint used, and carry the effectiveAt date of the figure. A figure without its date is not attributable to us."},"disambiguation":"CardZ Marketcap is a data index for physical graded trading cards. It is not a cryptocurrency, not a token and not the CARDS token; there is no CardZ ticker and nothing here is tradable."}