Skip to main content

Asset Types

Overview

TPX supports multiple asset types, each with specific data requirements and formats. Every asset type follows a standardized structure with four main components:

  1. External IDs - Platform-specific identifiers for cross-platform matching
  2. Asset Details - Asset-level information (applies to all items of this asset)
  3. Config Details - Configuration-level information (asset grouping and categorization)
  4. Item Details - Item-specific information (condition, quantity, location, etc.)

Supported Asset Types

Asset TypeIdentifierDescriptionStatus
TicketTICKETEvent tickets (concerts, sports, theater)Active
Sealed TCGSEALED_TCGSealed trading card game products (booster boxes, packs, etc.)Active
Sealed WaxSEALED_WAXSealed sports card wax products (hobby boxes, packs, cases)Active
CoinCOINCollectible coins (US Mint releases, commemoratives, numismatic)Active
LegoLEGOLego sets, minifigures, and gearActive
Trading CardTRADING_CARDSingle trading cards (Pokemon, Magic, Yu-Gi-Oh, etc.) — graded or rawActive

List Asset Types

Most endpoints across TPX (including Advanced Strategies) reference asset types by their internal id (UUID), not the string identifier above. Use this query to look up the id for an asset type.

query AssetTypes($input: ListAssetTypesInput!) {
assetTypes(input: $input) {
assetTypes {
id
type
slug
displayName
platformEnabled
tpxEnabled
}
pagination {
totalCount
}
error { message code }
}
}

Input Fields

FieldTypeRequiredDescription
typeAssetTypeEnumNoFilter by a single identifier (TICKET, SEALED_TCG, etc.)
platformEnabledBooleanNoFilter to types enabled on the consumer marketplace
tpxEnabledBooleanNoFilter to types available via TPX (partner API)
includeMediaBooleanNoInclude media URLs (default false)
paginationSimplePaginationInputNo{ limit, offset } — defaults to limit: 20, offset: 0

Filter to a Single Asset Type

{
"query": "query AssetTypes($input: ListAssetTypesInput!) { assetTypes(input: $input) { assetTypes { id type slug } error { message code } } }",
"variables": {
"input": { "type": "SEALED_TCG" }
}
}

List All TPX-enabled Asset Types

{
"query": "query AssetTypes($input: ListAssetTypesInput!) { assetTypes(input: $input) { assetTypes { id type displayName } } }",
"variables": {
"input": { "tpxEnabled": true }
}
}

Authentication

This query is open — it can be called with or without auth. Partner integrations typically include their API key for consistency.

Data Structure

All asset types follow this structure in webhook messages:

{
"asset_type": "<ASSET_TYPE>",
"external_ids": { ... },
"asset_details": { ... },
"config_details": { ... },
"item_details": { ... }
}

See each asset type page for detailed field specifications and examples.

Forward Compatibility

Your integration should accept unknown fields without validation errors. New fields may be added to any payload section at any time.


← Webhook Messages | GraphQL Responses →