{"uid":"cap_1fqY0kO33tbln1XRvuigi","slug":"re-tcg-card-appraisal-actual-sold-prices-ffa84cd2","name":"Re:TCG Card Appraisal — Actual Sold Prices","description":"What a trading card actually sold for, not what someone is asking — including the ones worth less than the postage, where other tools stop looking. Whether a slab's plastic paid for itself, and the trip onto Polygon or Solana and off again.","url":"https://www.retcg.xyz/api/appraise/%7Bid%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["id"],"properties":{"id":{"type":"string","description":"game:cardId — a pokemontcg.io id, e.g. pokemon:sv3pt5-199"}}},"queryParams":{"type":"object","properties":{"on":{"type":"string","description":"YYYY-MM-DD you bought it; reports the corpus change since"},"paid":{"type":"string","description":"your cost basis in USD; PnL is computed against it"},"denoms":{"type":"string","description":"comma list of USD EUR USDC EURC GBP JPY ETH SOL BTC; all when omitted"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"id":"pokemon:sv3pt5-199","set":{"heat":0.69,"name":"151","phase":"out-of-print","ageDays":1094,"momentum30":0.042},"card":{"name":"Charizard ex","number":"199","rarity":"Special illustration rare"},"paid":true,"rows":[{"cond":"PSA 9","expo":-8,"mant":37160000000,"basis":{"n":2,"to":"2026-09-19","src":"ebay sold","from":"2026-02-27","kind":"observed"},"denom":"USD","price":371.6}],"attest":{"root":"0x…","signer":"0xb0Fd9c696CE8B93Aee2e9f63A43A28383A5fa947","signature":"0x…"},"projections":{"raw@365":{"steps":[{"n":58,"days":365,"phase":"out-of-print","drift30":-0.0038}],"value":300.77}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_trx-nq3L5HLj83iDbWci9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x3600000000000000000000000000000000000000","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns real transaction-based market prices for a specific trading card by ID, including graded slabs, across multiple currencies, with optional cost-basis PnL and 1-year value projection.","exampleAgentPrompt":"What did the Charizard ex Special Illustration Rare (pokemon:sv3pt5-199) actually sell for recently? I paid $250 for it back on 2024-06-15 — show me the breakdown by grade and tell me my PnL in USD and USDC.","exampleUseCases":[{"title":"PnL check on a graded slab","prompt":"I bought a PSA 9 Charizard ex 151 set card (pokemon:sv3pt5-199) for $300 on 2024-03-10 — can you pull the actual sold prices and tell me whether I'm up or down, in USD?"},{"title":"Pre-sale price reality check","prompt":"Before I list my Umbreon VMAX Alt Art (pokemon:swsh4-215), can you tell me what copies have actually sold for recently — not just the asking prices? Show me raw and graded prices."},{"title":"Portfolio valuation in multiple currencies","prompt":"I need to value my collection for insurance purposes — can you appraise pokemon:sv3pt5-199 and give me the current sold-price data in USD, EUR, and USDC?"}],"resultDescription":"Returns a JSON object with the card's identity (name, number, rarity), set metadata (heat score, momentum, print phase, age in days), a rows array of actual observed sold prices broken down by condition and grade (e.g. PSA 9) with sale count and date range, optional PnL if cost basis was provided, a 1-year value projection with drift assumptions, and an on-chain cryptographic attestation (signer address, signature, Merkle root) verifying the price data integrity.","failureModes":["Unknown or malformed card ID returns an error — must use game:cardId format like pokemon:sv3pt5-199","No recent sales data available for low-liquidity cards may return empty rows","Invalid date format for 'on' parameter (must be YYYY-MM-DD) causes bad request","Unsupported currency in 'denoms' list is silently ignored or errors","Payment failure (x402 protocol) blocks the response with a 402 status"],"whenToPreferThis":"Use this endpoint when you need actual transaction-verified sold prices (not listing/asking prices) for a specific trading card, especially for graded slabs or when you need multi-currency output, PnL calculations against a known cost basis, or cryptographic attestation of the price data. It covers low-value cards that other tools ignore. Prefer over general e-commerce search when you have a specific pokemontcg.io card ID and need defensible, sourced market data for insurance, resale, or portfolio tracking purposes.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:35:18.095Z","isFirstParty":false,"canonicalSlug":"re-tcg-card-appraisal-actual-sold-prices-ffa84cd2"}