{"uid":"cap_CoLUOoCoFbYwvVndn8UE8","slug":"the-undesirables-oracle-graded-slab-census-221f1dfe","name":"The Undesirables Oracle — Graded Slab Census","description":"Observed graded-slab census for a card: how many PSA/BGS/CGC/TAG slabs of each grade are circulating on the open market, with cert-number-verified depth, 30-day active counts and median asks. This is NOT a pop report — pop counts every slab ever graded (including vaulted); this census counts what is actually listed and pressing on price. Harvested daily from eBay conditionDescriptors (grader+grade are marketplace-required fields), committed on-chain daily under a census domain tag.","url":"https://oracle.the-undesirables.com/api/v1/census","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["product_id"],"properties":{"product_id":{"type":"integer","description":"TCGplayer product id — find it via the free /api/v1/search"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["status"],"properties":{"status":{"type":"string"},"by_grade":{"type":"array"},"total_slabs":{"type":"integer"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_J4vL2287rlZbMSK3CCITc","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a cert-verified, grade-by-grade count of actively listed PSA/BGS/CGC/TAG slabs on the open market for a specific trading card, with 30-day active counts and median ask prices.","exampleAgentPrompt":"How many graded slabs of TCGplayer product 121527 are actually listed for sale right now — break it down by grade and grader and tell me the median ask for each?","exampleUseCases":[{"title":"Check PSA 10 supply before buying","prompt":"Before I make an offer on a PSA 10, can you check how many PSA 10 slabs of TCGplayer product 220145 are currently listed on the market and what the median ask is?"},{"title":"Assess market saturation for flipping","prompt":"I'm thinking about submitting cards to PSA for grading — can you pull the active slab census for TCGplayer product 394821 so I can see how saturated each grade tier already is?"},{"title":"Monitor high-grade slab price pressure","prompt":"Keep an eye on the graded market depth for TCGplayer product 178302 — I want to know if the number of BGS 9.5 slabs listed is creeping up and pushing down the median ask."}],"resultDescription":"A JSON object containing total active slab count, a breakdown by grade (PSA, BGS, CGC, TAG grades listed separately) with cert-number-verified depth per grade, 30-day active listing counts, and median ask prices per grade tier — reflecting only slabs currently listed and pressing on open-market price, not total population report counts.","failureModes":["Missing or invalid product_id returns a 400 error","product_id not found in TCGplayer catalog returns empty or 404 response","No active listings for that card returns zero counts with empty by_grade array","Stale data if daily harvest has not yet completed for that day","Payment failure via x402 micropayment returns 402 before data is delivered"],"whenToPreferThis":"Use this endpoint when you need to understand actual market supply pressure for graded slabs of a specific card — i.e., how many certified copies are actively listed and at what prices — rather than the theoretical total graded population. Prefer this over a raw PSA/BGS pop report when making buy/sell/grade decisions based on real circulating supply. Especially valuable when assessing whether high-grade supply is thin (supporting price) or saturated (suppressing price).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:54:13.474Z","isFirstParty":false}