# TCG Card Grading AI (PSA/Beckett Grade Predictor)

> TCG Card Grading AI (PSA/Beckett Grade Predictor) is a paid API for AI agents from oracle.the-undesirables.com, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-15).

Uses AI vision to analyze images of physical Trading Card Game (TCG) cards and predict their PSA and Beckett grades.

## Facts

- Endpoint: GET https://oracle.the-undesirables.com/api/v1/grade
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oracle-the-undesirables-com-506c4b8b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yJKNOOG2OrzfnNaKaZGcD

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 oracle-the-undesirables-com-506c4b8b
```

Example prompt: Can you predict what PSA and Beckett grades this Pokémon Charizard card would get? Here's the image URL of the card front and back.

## When to prefer this

Choose this endpoint when you need a fast, inexpensive AI-powered pre-grading estimate for Pokémon or Magic: The Gathering cards before committing to costly professional grading services like PSA or Beckett. Ideal for collectors and resellers wanting to triage large collections or decide which cards are worth professional submission.

## Known failure modes

- Image URL inaccessible or invalid — returns error indicating image cannot be fetched
- Non-TCG image submitted — model may return low confidence or error
- Poor image quality or lighting — reduced grading accuracy or refusal
- Unsupported card type — may return uncertain results
- Payment failure via x402 — request rejected before processing

## How this service works

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.

## Output

Returns predicted PSA and Beckett numerical grade estimates for the submitted card image, along with a condition assessment and confidence score based on AI vision analysis of the card's surface, corners, edges, and centering.

## 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": [
      "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"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "overall_grade": 9
  },
  "tool": "grade_card",
  "price": "$0.10",
  "status": "ok"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oracle-the-undesirables-com-506c4b8b/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)