Skip to main content

Key Fair Values

Look up current fair values for a product's variants. Pass an asset configuration ID and get back its keys with fair values attached.

query V($i: GetKeyFairValuesByAssetConfigInput!) {
getKeyFairValuesByAssetConfig(input: $i) {
keys {
keyId
keyType
value
displayName
ancestors
fairValues { valueCents modelVersion }
}
rootKey { keyId value }
error { message code }
}
}
FieldTypeDescription
assetConfigurationIdUUID (required)The product to fetch fair values for
keyIds[UUID!]Restrict to specific keys; omit for every key under the configuration
{ "i": { "assetConfigurationId": "<assetConfigurationId>" } }

Response (trimmed):

{
"keys": [
{
"keyId": "4a9a2cca-c05f-5474-9979-428dc6f41107",
"value": "MINT",
"displayName": "Mint",
"fairValues": [{ "valueCents": 47218, "modelVersion": "v1_tcgplayer_direct" }]
},
{
"keyId": "f3302a27-5ca8-59d4-b861-633a1597b175",
"value": "NEAR_MINT",
"displayName": "Near Mint",
"fairValues": []
}
]
}

An empty fairValues array means the key is unpriced, not worth zero. Multiple entries on one key come from different models, not a time series — see Model Configs.

Key reuse by asset type

Sealed TCG, trading cards, and sealed wax share one key set per asset type — condition keys like MINT have the same key ID on every product, so resolve them once via Keys. Ticket keys are event-specific: section and row key IDs are only valid for the configuration they came from, so read them from this query's response.