Trading Card

Active Development

This asset type is currently in active development and is subject to change. Fields, formats, and behavior may be updated without prior notice.

Single trading cards across TCGs (Pokémon, Magic: The Gathering, Yu-Gi-Oh, etc.) and modern non-sports brands. Supports both graded and raw cards.

External IDs

Field	Required	Description	Example
TCGPLAYER	No	TCGPlayer marketplace product ID	"593355"

Asset Details

Asset-level fields identify the card itself (set + character + identity), independent of grade or print variant.

Field	Required	Type	Description	Example
id	Yes	string	Internal Tradepost asset ID (UUID)	"be6323f8-25d0-4953-9af1-becac5f13acb"
name	No	string	Asset name (card identity, e.g. set number + character)	"Charizard - 4/102"
set_name	No	string	Canonical set name	"1999 Pokemon Base Set"
subcategory	No	string	TCG family / category	"POKEMON_CARDS", "MAGIC_CARDS", "YUGIOH_CARDS"
brand	No	string	IP / franchise	"Pokemon", "Magic: The Gathering", "Yu-Gi-Oh!"
manufacturer	No	string	Company that prints the cards	"Wizards of the Coast", "Konami"
subject	No	string[]	Featured characters / subjects on the card	["Charizard"]

Config Details

Configuration-level fields distinguish print variants of the same card — language, rarity, foil treatment, print run.

Field	Required	Type	Description	Example
id	Yes	string	Internal Tradepost asset configuration ID (UUID)	"0ce36c59-1710-4c6a-93ae-86b4e8f06a24"
name	No	string	Configuration name	"Charizard - 4/102 · Base Set · Holo Rare · English"
image_url	No	string	Primary product image URL	"https://cdn.tradepost.co/.../card.webp"
rarity	No	string	Official rarity	"Common", "Uncommon", "Rare", "Holo Rare", "Ultra Rare", "Secret Rare", "Promo"
print_version	No	string	Edition / print run	"1st Edition", "Unlimited"
artist	No	string	Card artist credit	"Mitsuhiro Arita"
language	No	string	Print language	"English", "Japanese"
is_foil	No	boolean	Foil / holographic treatment	true
holo_pattern	No	string	Specific holographic pattern	"Cosmos", "Rainbow", "Galaxy"
reverse_holo	No	boolean	Reverse-holo printing (frame foil, artwork non-foil)	false
is_textured	No	boolean	Raised / textured surface	false

Item Details

Item-level fields are about the specific physical card being sold — its grade, condition, autograph status.

For graded cards: grading_company + grade (+ cert_number) define the card. raw_condition is null. For raw (ungraded) cards: raw_condition defines the card. grading_company and grade are null.

Field	Required	Type	Description	Example
key_id	No	string	Internal Tradepost key ID for grouping items (UUID, may be null)	"33d011e4-60ec-51ed-a92e-30677a9066b8"
key_ids	No	string[]	Array of internal Tradepost key IDs for this item	["33d011e4-…"]
fair_values	No	array	Fair value pricing information	[]
grading_company	No	string	Grading company (null for raw cards)	"PSA", "BGS", "CGC", "SGC", "TAG"
grade	No	string	Overall card grade (null for raw cards)	"10", "9.5", "8"
cert_number	No	string	Certification number from the grading company	"12345678"
raw_condition	No	string	Condition for ungraded cards	"MINT", "NEAR_MINT", "EXCELLENT", "VERY_GOOD", "GOOD", "FAIR", "POOR"
is_autographed	No	boolean	Whether the card is autographed	false
autograph_grade	No	string	Autograph grade (if applicable)	"10"
serial_number	No	string	Serial number numerator (e.g. for /99 print runs)	"23"
quantity	Yes	integer	Number of units	1

Supported Grading Companies:

• PSA — Professional Sports Authenticator
• BGS — Beckett Grading Services
• CGC — Certified Guaranty Company
• SGC — Sportscard Guaranty
• TAG — TAG Grading
• RAW — Ungraded (use raw_condition instead of grade)

Example — Graded Card

{
  "asset_type": "TRADING_CARD",
  "external_ids": {
    "TCGPLAYER": "593355"
  },
  "asset_details": {
    "id": "be6323f8-25d0-4953-9af1-becac5f13acb",
    "name": "Charizard - 4/102",
    "set_name": "1999 Pokemon Base Set",
    "subcategory": "POKEMON_CARDS",
    "brand": "Pokemon",
    "manufacturer": "Wizards of the Coast",
    "subject": ["Charizard"]
  },
  "config_details": {
    "id": "0ce36c59-1710-4c6a-93ae-86b4e8f06a24",
    "name": "Charizard - 4/102 · Base Set · Holo Rare · English",
    "image_url": "https://cdn.tradepost.co/.../card.webp",
    "rarity": "Holo Rare",
    "print_version": "Unlimited",
    "language": "English",
    "is_foil": true,
    "reverse_holo": false,
    "is_textured": false
  },
  "item_details": {
    "key_id": "33d011e4-60ec-51ed-a92e-30677a9066b8",
    "key_ids": ["33d011e4-60ec-51ed-a92e-30677a9066b8"],
    "fair_values": [],
    "grading_company": "PSA",
    "grade": "10",
    "cert_number": "12345678",
    "is_autographed": false,
    "quantity": 1
  }
}

Example — Raw Card

{
  "asset_type": "TRADING_CARD",
  "external_ids": {},
  "asset_details": {
    "id": "be6323f8-25d0-4953-9af1-becac5f13acb",
    "name": "Charizard - 4/102",
    "set_name": "1999 Pokemon Base Set",
    "subcategory": "POKEMON_CARDS",
    "brand": "Pokemon",
    "manufacturer": "Wizards of the Coast",
    "subject": ["Charizard"]
  },
  "config_details": {
    "id": "0ce36c59-1710-4c6a-93ae-86b4e8f06a24",
    "name": "Charizard - 4/102 · Base Set · Holo Rare · English",
    "image_url": "https://cdn.tradepost.co/.../card.webp",
    "rarity": "Holo Rare",
    "print_version": "Unlimited",
    "language": "English",
    "is_foil": true
  },
  "item_details": {
    "key_id": "dafe91c0-bcee-58a2-a868-006cb8e19ac0",
    "key_ids": ["dafe91c0-bcee-58a2-a868-006cb8e19ac0"],
    "fair_values": [],
    "raw_condition": "NEAR_MINT",
    "is_autographed": false,
    "quantity": 1
  }
}

Use with Advanced Strategies

Trading cards work with Advanced Strategies. For the full strategy flow including how to discover key IDs (PSA 10, raw conditions, etc.), pricing model configs, and facet filters, see the Quickstart walkthrough.

---

← Asset Types Overview