{"name":"TCG Oracle — Financial Intelligence for Collectibles","version":"2.0.0","x402_enabled":true,"payment_address":"0x642e8a7C289381f24f0395e0539f0bA41c74Cc1B","network":"eip155:8453","endpoints":{"free":[{"path":"/api/v1/search","description":"Search 456K+ TCG products — names, IDs and market price. USD prices carry their own as-of date and are currently FROZEN at their last good date; Japanese-print quotes refresh daily (limit 1-50, default 10)"},{"path":"/api/v1/accuracy","description":"Public grading-report count + the on-chain forecast track record (open predictions, committed roots, first maturity date)"},{"path":"/api/v1/alerts/subscribe","method":"POST","description":"Subscribe to price alert webhooks"},{"path":"/api/v1/alerts","description":"List active price alerts"},{"path":"/api/v1/alerts/{alert_id}","method":"DELETE","description":"Unsubscribe from alert"},{"path":"/api/v1/alerts/check","method":"POST","description":"Trigger alert check cycle"},{"path":"/api/v1/recommend","method":"GET or POST","description":"AI workflow advisor — tells you which endpoints to call and in what order. `goal` as a query param (GET) or JSON body field (POST); both return the same response."},{"path":"/api/v1/collection","description":"The Undesirables (UNDSR) NFT — live supply + public-mint status on Ethereum mainnet"},{"path":"/api/v1/collection/wallet/{address}","description":"UNDSR mint eligibility + holdings for a wallet"},{"path":"/api/v1/collection/prepare-mint","description":"Build an unsigned UNDSR mint transaction — you sign with your own wallet, we never hold keys"},{"path":"/api/v1/sports/board","description":"Daily sports movers board — hot players per live league with conformal 7-day context, headshots, and the current calibration verdict. Free"},{"path":"/api/v1/sports/players","description":"Player directory for the live forecast panel — id, name, team, position per league. Filter server-side with ?league=&query=&limit= (query matches name or team). Free"},{"path":"/api/v1/sports/leaderboard","description":"Sports souls leaderboard — minted Undesirables' weekly OVER/UNDER calls vs the oracle's own 7-day lines, locked on-chain before outcomes, graded mechanically. Free"},{"path":"/api/v1/souls/leaderboard","description":"TCG souls leaderboard — weekly on-chain-locked card calls (USD season 1: 7 graded weeks; JP season 2 live) ranked by skill vs each soul's own best-constant baseline (always-up or always-down, per market). Free"},{"path":"/api/v1/fantasy/league","description":"Souls fantasy league — 4,444 personalities draft weekly lineups over calibrated forecasts, merkle-locked before games score. Free"},{"path":"/api/v1/equity/rh-memecoins","description":"Memecoins launched against Robinhood-tokenized stocks: launcher wallet, anchored stock, seeded amount, pools, plus serial-launcher aggregates. Every 15 min. Free"},{"path":"/api/v1/equity/rh-holders","description":"Top holders per Robinhood-tokenized stock, cross-stock whales, and supply-share moves. Hourly. Free"},{"path":"/api/v1/stamps/panel","description":"Daily Bitcoin Stamps market panel — every SRC-20 token with exchange market data and every stamp collection floor on stampchain.io, snapshotted daily; 7d/30d volume and price change DERIVED from our own dated snapshots (upstream publishes 24h only); Merkle-rooted nightly on Base + LiteForge (stream stamps_market). Free"},{"path":"/api/v1/stamps/panel/{tick}","description":"One SRC-20 tick's daily history from the Stamps panel with the commit roots for each day. Free"},{"path":"/api/v1/equity/rh-pools","description":"Robinhood Chain tokenized stocks + every liquidity pool per token, hourly: real stock price vs pool prices, routable spread, deployer-verified identity. Free"},{"path":"/chart/{product_id}.png","description":"Conformal forecast cone as a PNG — embeddable image, ?days=7..30 (free, no payment)"},{"path":"/api/v1/loan-terms/universe","description":"The rated universe for the Loan-Terms Oracle — every graded slab with a live value basis, census liquidity tier, free-board flag. Free"},{"path":"/api/v1/loan-terms/preview/{product_id}","description":"Worked LTV derivation (all six steps) for today's published free-board cards — the /lending page's data source. Free"},{"path":"/api/v1/price","description":"Current market price for one product_id — the cheapest way to check a card"},{"path":"/api/v1/prices","description":"Batch price lookup — ?ids=1,2,3. Returns one entry per (product_id, sub_type); a product may have several"},{"path":"/api/v1/history","description":"Last 30 stored prices for a product_id, plus drift/volatility stats. For USD products the series ENDS at the frozen panel date — check latest_date before treating it as current"},{"path":"/api/v1/forecast","description":"The free forecast board — 200 cards with conformal bands and VaR. Takes no parameters; returns the whole board"},{"path":"/api/v1/forecast/{product_id}","description":"Conformal forecast for one card — 50/80/90/95% bands, VaR95/99, regime, and the risk basis note"},{"path":"/api/v1/merkle/proof","description":"Merkle proof that a price we published is in the root committed on-chain that day — verify us without trusting us"},{"path":"/api/v1/graded","description":"Graded ASK medians by grade for a product_id (PSA/BGS/CGC) — active-listing asks, not sold prices (sold-history pending eBay Insights approval)"},{"path":"/api/v1/graded/proof","description":"Merkle proof for a graded-price entry — ?product_id=&grade=PSA+10"},{"path":"/api/v1/graded/sales","description":"Realized-sales history for a graded card — individual sold records, chronological. Pending eBay Insights production approval; honest empty state until then"},{"path":"/api/v1/graded-bluechips","description":"Graded blue-chip board — the cards with the deepest graded price history"},{"path":"/api/v1/jp/summary","description":"Japanese dealer panel as AGGREGATES — cards/two-sided counts, bid/ask norm per price band, per-game depth, day-over-day and week-over-week movement, the day's on-chain root. No card rows; per-card is /jp/card/... one at a time"},{"path":"/api/v1/census/summary","description":"Observed slab-census totals — slabs, cert-verified depth, cards covered, grader mix. The free teaser for the per-card census"},{"path":"/api/v1/ebay-comps","description":"Current eBay ACTIVE fixed-price listings for a search query — asks, NOT completed sales. The endpoint itself says so; this line used to claim the opposite. No free route returns realized sales."},{"path":"/api/v1/soul-rating","description":"Soul leaderboard — every rated Undesirable soul with its current standing"},{"path":"/api/v1/soul-rating/{token_id}","description":"One soul's rating, call history and record"},{"path":"/api/v1/soul-rating/wallet/{address}","description":"Soul ratings for every soul held by a wallet"},{"path":"/api/v1/wallet/portfolio","description":"Vault portfolio valuation — every Courtyard.io vaulted card in a Polygon wallet with raw and grade-adjusted values. Free."},{"path":"/api/v1/crypto-oracle","description":"NFT floor-price oracle + risk forecast"},{"path":"/api/v1/coin-history","description":"CoinGecko OHLC + token price forecast"},{"path":"/api/v1/sports/forecast","description":"Calibrated 7-day player stat-line forecast — conformal bands + Heat/Form grades + on-chain proof pointer. MLB is always free (MLB stats are licensed for non-commercial use only)"},{"path":"/api/v1/census","description":"Observed graded-slab census per card — circulating supply by grader/grade, cert-verified, 30d activity + median asks. Not a pop report: what is actually on the market"},{"path":"/api/v1/loan-terms","description":"Loan-Terms Oracle — graded-slab terms: VaR-derived max LTV, liquidation price, census liquidity tier and suggested APR premium. Live graded value basis; refuses unrateable collateral"}],"paid":[],"retired":[{"path":"/api/v1/accuracy/report","method":"POST","was":"free","status":"retired","answers":410,"reason":"grade-outcome reports for the AI grader, which is retired"},{"path":"/api/v1/grade","method":"GET","was":"$0.10","status":"retired","answers":410,"reason":"AI card grading — our own blind study (2026-08-31) scored 3.5% exact through slab plastic"},{"path":"/api/v1/grade/upload","method":"POST","was":"$0.10","status":"retired","answers":410,"reason":"AI card grading from uploaded bytes — same pipeline as /api/v1/grade"},{"path":"/api/v1/grade-or-not","method":"GET","was":"$0.10","status":"retired","answers":410,"reason":"grading-ROI decisions built on the AI grade"},{"path":"/api/v1/batch-triage","method":"POST","was":"$0.50","status":"retired","answers":410,"reason":"batch grading and ranking built on the AI grade"},{"path":"/api/v1/loan-monitor","method":"POST","was":"$1.00","status":"retired","answers":410,"reason":"paid loan monitoring — no outside loan was ever registered"}],"suspended":[{"path":"/api/v1/market","was":"$0.025","reason":"daily market snapshot of the USD panel","status":"suspended","not_charged":true,"resumes_when":"a live USD price series exists again"},{"path":"/api/v1/simulate","was":"$0.015","reason":"conformal price forecast issued from the USD panel","status":"suspended","not_charged":true,"resumes_when":"a live USD price series exists again"},{"path":"/api/v1/trending","was":"$0.025","reason":"top movers by USD price velocity","status":"suspended","not_charged":true,"resumes_when":"a live USD price series exists again"},{"path":"/api/v1/portfolio-optimize","was":"$0.50","reason":"Markowitz optimisation over USD price history","status":"suspended","not_charged":true,"resumes_when":"a live USD price series exists again"},{"path":"/api/v1/verdict","was":"$0.30","reason":"buy/hold/avoid decision on the USD price + forecast","status":"suspended","not_charged":true,"resumes_when":"a live USD price series exists again"},{"path":"/api/v1/alerts/subscribe","was":"free","reason":"USD price-threshold alerts (cannot fire on a frozen panel)","status":"suspended","not_charged":true,"resumes_when":"a live USD price series exists again"},{"path":"/api/v1/alerts/check","was":"free","reason":"USD price-alert check cycle","status":"suspended","not_charged":true,"resumes_when":"a live USD price series exists again"}]},"discovery":{"agent_card":"/.well-known/agent.json","openapi":"/openapi.json","docs":"/docs"},"website":"https://the-undesirables.com","technocore_feed":{"server":"https://technocore.chat","room":"/r/d-undsr-oracle","latest_note":"/kv/undsr/price-root","what":"daily TCG price-tree merkle roots as signed messages in an owned room — verify any price via /api/v1/merkle/proof (free) against merkleRoot() on the on-chain contracts; the chain is the source of truth"},"pay_per_call":{"status":"paused","since":"2026-10-02","note":"every endpoint is free; the x402 payment rail stays installed and can be switched back on per route"},"total_endpoints":45,"paid_endpoints":0,"free_endpoints":45,"suspended_endpoints":7,"total_minted":274,"panels":{"usd":{"products":289608,"as_of":"2026-09-07","refreshing":false,"note":"upstream feed unavailable — frozen at its last good date"},"japanese":{"cards":369897,"two_sided":170378,"as_of":"2026-10-21","refreshing":true,"note":"24 games; two_sided rows carry an ask AND a dealer buyback bid"}},"total_products":456630,"tagline":"Conformal risk forecasts and Safe-Hold/Momentum card grades for 456K+ trading cards across 25+ games"}