The Undesirables Oracle
GET oracle.the-undesirables.com/api/v1/grade
Why an agent can trust this route.
Sonar evidence is advisory. Paid delivery is shown as verified only when paid probes are available; otherwise route estimates use the unpaid handshake as a clearly labeled proxy.
Observed outcomes
Grade any physical Pokémon, Magic: The Gathering, Yu-Gi-Oh, or Digimon trading card using a 3-stage AI pipeline: (1) Qwen Vision LLM analyzes corners, edges, and surface defects, (2) OpenCV measures exact centering ratios programmatically, (3) BGS professional capping algorithm adjusts the final grade. Returns PSA/Beckett-calibrated subgrades and an overall condition score. Accepts card image URLs or base64. INPUT REQUIREMENT: a direct, well-lit macro photo of the RAW card. Photos through slab plastic or marketplace listing photos are NOT a supported input — our own published blind study (2026-08-31, 300 slabbed cards, see /api/v1/accuracy blind_slab_study) showed the pipeline cannot discriminate grades through slab glare.
Resource: oracle.the-undesirables.com/api/v1/grade
Network: eip155:8453, solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp, eip155:4663 · Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 · Pay to: 0x642e8a7C289381f24f0395e0539f0bA41c74Cc1B
Payment methods: — · Last validation: 2026-10-15 05:30:47.522+00
{
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET",
"HEAD",
"DELETE"
],
"type": "string"
},
"queryParams": {
"type": "object",
"required": [
"image_url"
],
"properties": {
"game": {
"type": "string",
"description": "Ecosystem context, e.g. 'Pokemon' or 'Magic'"
},
"image_url": {
"type": "string",
"description": "URL or direct path to the physical card image"
}
}
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object",
"required": [
"status"
],
"properties": {
"data": {
"type": "object"
},
"tool": {
"type": "string"
},
"price": {
"type": "string"
},
"status": {
"type": "string"
}
}
}
}
},
"paymentRequirements": [
{
"raw": {
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x642e8a7C289381f24f0395e0539f0bA41c74Cc1B",
"amount": "100000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
},
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"payTo": "0x642e8a7C289381f24f0395e0539f0bA41c74Cc1B",
"scheme": "exact",
"network": "eip155:8453",
"amountAtomic": "100000"
},
{
"raw": {
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"extra": {
"feePayer": "BFK9TLC3edb13K6v4YyH3DwPb5DSUpkWvb7XnqCL9b4F"
},
"payTo": "GueVKFK4VNe4LYvMoYAKpnJe8s7Yar6FF3r1f92gfm9y",
"amount": "100000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 300
},
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"payTo": "GueVKFK4VNe4LYvMoYAKpnJe8s7Yar6FF3r1f92gfm9y",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"amountAtomic": "100000"
},
{
"raw": {
"asset": "0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168",
"extra": {
"name": "Global Dollar",
"version": "1"
},
"payTo": "0x642e8a7C289381f24f0395e0539f0bA41c74Cc1B",
"amount": "100000",
"scheme": "exact",
"network": "eip155:4663",
"maxTimeoutSeconds": 300
},
"asset": "0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168",
"payTo": "0x642e8a7C289381f24f0395e0539f0bA41c74Cc1B",
"scheme": "exact",
"network": "eip155:4663",
"amountAtomic": "100000"
}
]
}Source catalog records are retained separately from live endpoint observations. Sonar score, uptime, and latency are advisory metrics. CDP indexing is not inferred from validation.