{"uid":"cap_v-hZj9DmynIGoApfAHz2W","slug":"the-undesirables-oracle-tcg-card-grade-upload-c369c07b","name":"The Undesirables Oracle — TCG Card Grade Upload","description":"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.","url":"https://oracle.the-undesirables.com/api/v1/grade/upload","method":"POST","headers":{},"bodySchema":{"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`"}}},"responseSchema":{"type":"json","example":{"report":{"overall_grade":8.5},"status":"ok","privacy":"image not stored; deleted after grading; EXIF stripped"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_QyJtsGPtauJHEzxZThmCh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Grades a physical trading card image using AI vision, returning a numeric grade and detailed condition report with privacy guarantees","exampleAgentPrompt":"Can you grade this Pokémon card photo for me and tell me what condition it's in and what numeric grade it gets?","exampleUseCases":[{"title":"Pre-sale condition check for eBay listing","prompt":"I'm about to list this holographic Charizard on eBay — can you upload this photo and grade it so I know what condition to advertise and what price to set?"},{"title":"Deciding whether to send to PSA","prompt":"I've got a First Edition Base Set Blastoise I'm thinking of sending to PSA for professional grading — can you grade this card image first so I know if it's worth the submission fee?"},{"title":"Bulk collection triage before trading","prompt":"I'm trading at a card show this weekend and I need to know the grade on this Magic: The Gathering Black Lotus I just pulled — can you analyze this card photo and give me a numeric grade?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:51:01.941Z","isFirstParty":false}