# The Undesirables Oracle — Graded Slab Census

> The Undesirables Oracle — Graded Slab Census is a paid API for AI agents from oracle.the-undesirables.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

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.

## Facts

- Endpoint: GET https://oracle.the-undesirables.com/api/v1/census
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/the-undesirables-oracle-graded-slab-census-221f1dfe
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CoLUOoCoFbYwvVndn8UE8

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability the-undesirables-oracle-graded-slab-census-221f1dfe
```

Example prompt: 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?

## When to prefer this

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).

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/the-undesirables-oracle-graded-slab-census-221f1dfe/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from oracle.the-undesirables.com](https://www.zero.xyz/host/oracle.the-undesirables.com/llms.txt)