{"uid":"cap_wOhcEQ7a9SCVxE-2notYf","slug":"re-tcg-appraise-e6c59190","name":"Re:TCG Appraise","description":"Trading-card appraisal: raw and every grader×grade (PSA/BGS/CGC/SGC) in USD, EUR, USDC, EURC, GBP, JPY, ETH, SOL and BTC, each with its source, n and window; the set's lifecycle phase, measured 30-day momentum and heat; projections through the phases ahead; PnL net of venue fees; break-even; EIP-712 signed. Pokémon only for now.","url":"https://www.retcg.xyz/api/appraise/:id?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":null,"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_W9GdiBA6WzfJCSG8OaEXM","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 multi-currency appraisal values for a Pokémon TCG card across raw and all graded conditions (PSA/BGS/CGC/SGC), with momentum, lifecycle phase, projections, PnL, break-even, and EIP-712 signature.","exampleAgentPrompt":"What's my pokemon:sv3pt5-199 worth right now — give me values for raw and all PSA/BGS/CGC/SGC grades in USD and ETH, and since I paid $40 on 2024-06-15, tell me my PnL and break-even too.","exampleUseCases":[{"title":"Pre-sale graded card valuation","prompt":"I'm about to list my PSA 10 Charizard (pokemon:base1-4) on eBay — what's the current appraisal across all graded tiers in USD and GBP, and what's my break-even if I paid $800 for it?"},{"title":"Crypto portfolio allocation check","prompt":"I want to know the current value of pokemon:sv3pt5-199 in ETH, SOL, and BTC across raw and all graded conditions — I'm trying to figure out if it makes sense to trade it for crypto."},{"title":"Investment PnL tracking for collector","prompt":"I bought pokemon:swsh12-160 on 2023-11-01 for $25 — what's the full appraisal today in USD and USDC, what's my PnL net of fees, and how is the set's momentum and lifecycle phase looking?"}],"resultDescription":"A structured JSON response containing: per-condition (raw + every grader×grade) prices in all requested currencies, each annotated with data source, sample count (n), and time window; the card set's current lifecycle phase; 30-day momentum and heat metrics; projected values through upcoming lifecycle phases; PnL and break-even computed against the provided cost basis and net of venue fees; and an EIP-712 cryptographic signature over the result.","failureModes":["Invalid or unsupported card ID format returns an error (only pokemontcg.io IDs for Pokémon supported)","Non-Pokémon game IDs (e.g. Magic: The Gathering) rejected — Pokémon only currently","Malformed date in 'on' query param (not YYYY-MM-DD) causes parse error","Unknown denomination in 'denoms' param returns validation error","Insufficient market data for rare/obscure cards may result in null or low-confidence values","Payment failure ($0.02 USDC via x402) returns 402 Payment Required"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive, multi-currency, multi-grader appraisal of a specific Pokémon TCG card — especially when you need graded vs raw price comparisons, lifecycle phase context, momentum/heat signals, forward projections, or PnL accounting against a known cost basis. It is distinctly more analytical than a simple last-sale lookup; prefer it for investment decisions, sell/hold analysis, or crypto-denominated valuations.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T06:36:05.141Z","isFirstParty":false,"canonicalSlug":"re-tcg-appraise-e6c59190"}