Match a natural language card description to the best card in the CardHedge data
Match a natural language card description to the best card in the CardHedge database.
Answeringour last check, 2026-10-24
1 of 1checks answered this week
1628 msmedian answer time
$0.01listed price per call
$0.01price it asked us
Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.
Endpoint
POST https://api.cardhedger.com/v1/agent/cards/card-match
| Category | Everything else |
|---|---|
| Provider host | api.cardhedger.com |
| Networks | eip155:8453 |
| Payment schemes | exact |
| Self-reported calls, 30 days | 0 from 0 payers (the provider's figure, not ours) |
Our checks, last 30 days
| Day | Result | HTTP | Asked | Time |
|---|---|---|---|---|
| 2026-10-24 | valid payment request | 402 | $0.01 | 1628 ms |
Example input (from the provider)
{
"body": {
"category": "Baseball",
"max_candidates": 10,
"query": "2018 Topps Chrome Shohei Ohtani #150"
},
"bodyType": "json",
"method": "POST",
"type": "http"
}
Promised output schema (from the provider)
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"body": {
"properties": {
"category": {
"description": "Optional category filter to narrow search (e.g., 'Baseball', 'Pokemon')",
"type": "string"
},
"max_candidates": {
"default": 10,
"description": "Number of search results to evaluate (1-10, more = slower but potentially more accurate)",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"query": {
"description": "Natural language description of the card to match (e.g., '2018 Topps Chrome Shohei Ohtani rookie base')",
"maxLength": 500,
"minLength": 3,
"type": "string"
},
"raw_images_only": {
"default": true,
"description": "If true, only return actual card photos (not graded slab images). Defaults to true.",
"type": "boolean"
}
},
"required": [
"query"
],
"type": "object"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
},
"method": {
"enum": [
"POST",
"PUT",
"PATCH"
],
"type": "string"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method",
"bodyType",
"body"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}