Name: card-resolve
Price: 0.005 USDC
Availability: InStock

$ man card-resolve

agentutility / wordmint / card-resolve

PRICE / CALL

$0.005

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

wordmint

CATEGORY

STATUS

● live

NAME

card-resolve — normalizes free-form graded card text into a canonical card object

SYNOPSIS

POST https://x402.agentutility.ai/card-resolve
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

Normalizes free-form graded card text into a canonical card object. Takes any descriptive string ('2018 Topps Update Juan Soto RC PSA 9', '1999 Pokemon Base Set Charizard Holo PSA 10', 'MTG Black Lotus Alpha BGS 8.5') and returns sport_or_tcg, year, set, player_or_card_name, parallel, grade, grader, and cert_number, plus a confidence score and a stable search_key suitable for downstream cache coherence. Structured extraction from the text you provide, with no external data lookups. The clean glue endpoint for collector-pricing bots, marketplace listing automations, AI-shopping agents, and portfolio trackers that need to normalize messy human descriptions before any further lookup. Use it as a card resolver or graded card string normalizer.

INPUT — request schema

property	type	description	req?
card	string	Free-form card description. Max 500 chars. Examples: '2018 Topps Update Juan Soto RC PSA 9', '1999 Pokemon Base Set Charizard Holo 1st Edition PSA 10'.	required

OUTPUT — response shape

field	type	description
input	string	Echo of the original free-form card description submitted to the resolver.
canonical	object	Structured card object with fields: sport_or_tcg (sports/pokemon/magic/yugioh/other), year, set, player_or_card_name, parallel, grade, grader (PSA/BGS/SGC/CGC), cert_number.
confidence	number	Extractor confidence score 0-1. Treat values below 0.5 as low-confidence resolutions worth re-validating.
search_key	string	Deterministic lower-kebab key. Same canonical card always produces the same key regardless of input phrasing — useful as a cache coherence key for downstream comp lookups.
model	string	LLM model identifier that produced the extraction (Morpheus hermes-3 or Venice mistral-small fallback).
source	string	Which provider served the response: 'morpheus' (primary) or 'venice' (fallback).

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.agentutility.ai/card-resolve \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# Install the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>

# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...

# Then call the card-resolve tool from your MCP-aware agent.

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: wordmintcard-extractiongraded-cardstcgsports-cardsstructured-output
env: VENICE_API_KEY
methods: POST
cluster: wordmint
price: $0.005 USDC per call

ADJACENT — other endpoints in wordmint

endpoint	description	price
brand-tagline	Generates brand taglines and slogans for launch pages, X bios, email copy, and product cards.	$0.005
brand-tagline-generate	Generates tagline options for a brand or startup from its name, concept, audience, and tone.	$0.005
content-simhash	Fingerprints text with a 64-bit SimHash for near-duplicate detection, computed entirely locally.	$0.005
cron-parse	Cron parser.	$0.005
detect-language	Language detector / language identification.	$0.005
dictionary-define	Looks up English word definitions with pronunciation, part of speech, and synonyms.	$0.005
embedding-similarity	Measures how semantically similar two strings are: embeds both via Venice (default model: text-embedding-bge-m3) and returns the cosine s…	$0.005
extract-entities	Named entity recognition (NER) / entity extractor.	$0.005