# The Undesirables Oracle — TCG Card Grade Upload

> The Undesirables Oracle — TCG Card Grade Upload 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).

Grades a physical trading card image using AI vision, returning a numeric grade and detailed condition report with privacy guarantees

## Facts

- Endpoint: POST https://oracle.the-undesirables.com/api/v1/grade/upload
- 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/the-undesirables-oracle-tcg-card-grade-upload-c369c07b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_v-hZj9DmynIGoApfAHz2W

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-tcg-card-grade-upload-c369c07b -d '<json body>'
```

Example prompt: Can you grade this Pokémon card photo for me and tell me what condition it's in and what numeric grade it gets?

## When to prefer this

Choose this endpoint when you need AI-powered numeric grading of a physical trading card from an uploaded image, especially when privacy is important (image deleted post-grading, EXIF stripped). Prefer this over batch URL-based triage endpoints when you have a local image file to upload rather than a publicly accessible image URL. Best for single-card deep assessment before selling, trading, or deciding on professional grading submission.

## Known failure modes

- Image too blurry or low-resolution to assess — grader returns an error or low-confidence result
- Unsupported card type or non-TCG image submitted — may return unexpected results
- HTTP 402 returned if payment header is missing or malformed — must sign USDC/USDG micropayment and retry
- Network timeout during image upload for large files
- Payment on wrong chain or insufficient amount — 402 not resolved

## How this service works

TCG card grading, conformal risk forecasting, and market intelligence. Powered by x402 micropayments — USDC on Base, USDC on Solana, or USDG on Robinhood Chain; the 402 offers all three and the agent picks a leg. Free tools require no payment. Paid tools return HTTP 402 — sign a payment and retry with the payment proof header.

## Output

A JSON object containing an overall numeric grade (0–10 scale), a detailed condition report, grading status, and a privacy confirmation stating the image was not stored, was deleted after grading, and had EXIF data stripped.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "file": {
   "type": "string",
   "format": "binary",
   "description": "Card image: JPEG, PNG, HEIC or HEIF"
  },
  "game": {
   "type": "string",
   "description": "TCG game for grading context (default: Pokemon)"
  },
  "image_base64": {
   "type": "string",
   "description": "Base64 image bytes — alternative to `file`"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "report": {
   "overall_grade": 8.5
  },
  "status": "ok",
  "privacy": "image not stored; deleted after grading; EXIF stripped"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/the-undesirables-oracle-tcg-card-grade-upload-c369c07b/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)