Key Fair Values

Overview

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

Requires a partner API key via the X-API-Key header — see Authentication.

Get Key Fair Values

query GetKeyFairValues($input: GetKeyFairValuesByAssetConfigInput!) {
  getKeyFairValuesByAssetConfig(input: $input) {
    keys {
      keyId
      keyType
      value
      displayName
      ancestors
      fairValues {
        valueCents
        modelVersion
      }
    }
    rootKey {
      keyId
      value
    }
    error { message code }
  }
}

Input Fields

Field	Type	Required	Description
assetConfigurationId	UUID	Yes	The asset configuration to fetch fair values for
keyIds	[UUID!]	No	Restrict the response to specific keys. Omit to get every key under the configuration

Get Fair Values for a Sealed Product

{
  "query": "query GetKeyFairValues($input: GetKeyFairValuesByAssetConfigInput!) { getKeyFairValuesByAssetConfig(input: $input) { keys { keyId value displayName fairValues { valueCents modelVersion } } error { message code } } }",
  "variables": {
    "input": {
      "assetConfigurationId": "72786f31-2001-48a0-9408-6a30c6e14388"
    }
  }
}

Response (trimmed):

{
  "data": {
    "getKeyFairValuesByAssetConfig": {
      "keys": [
        {
          "keyId": "29ac7644-e506-4a42-9b74-1681da3ae7b1",
          "value": "UNOPENED",
          "displayName": "Unopened",
          "fairValues": [
            { "valueCents": 47218, "modelVersion": "v1_tcgplayer_direct" }
          ]
        },
        {
          "keyId": "f7b0f25f-83eb-4dc6-b44d-3da08ca49655",
          "value": "OPENED",
          "displayName": "Opened",
          "fairValues": []
        }
      ],
      "error": null
    }
  }
}

An empty fairValues array means the key is unpriced, not worth zero.

Get a Single Key's Fair Value

Pass keyIds to target specific variants — here, one ticket section tier:

{
  "query": "query GetKeyFairValues($input: GetKeyFairValuesByAssetConfigInput!) { getKeyFairValuesByAssetConfig(input: $input) { keys { keyId value fairValues { valueCents modelVersion } } error { message code } } }",
  "variables": {
    "input": {
      "assetConfigurationId": "385246fb-547d-42a7-a683-e62ff3f7212d",
      "keyIds": ["55f33aa2-1cf5-4022-b78f-2ce36eb0878f"]
    }
  }
}

{
  "keys": [
    {
      "keyId": "55f33aa2-1cf5-4022-b78f-2ce36eb0878f",
      "value": "100s",
      "fairValues": [
        { "valueCents": 990, "modelVersion": "v2_lowest_smoothed" }
      ]
    }
  ]
}

Key Reuse by Asset Type

Sealed TCG, trading cards, and sealed wax share one key set per asset type — condition keys like UNOPENED 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.

Response Types

KeyOptionWithFairValues

Field	Type	Description
keyId	UUID!	Key identifier — pass back in keyIds, or into keyCriteria when building an Advanced Strategy
keyType	KeyType!	The kind of variant (e.g., SEALED_TCG_CONDITION)
value	String!	Machine value of the key (e.g., UNOPENED, 100s)
displayName	String	Human-readable label
ancestors	[UUID!]!	Parent key IDs in the key hierarchy (e.g., a row's section)
fairValues	[FairValue!]!	Current fair value entries. Empty when unpriced

FairValue

Field	Type	Description
valueCents	Int	Fair value in USD cents
modelVersion	String	Version of the pricing model that produced the value — see Model Configs. Multiple entries on a key come from different models, not a time series

---

← Model Configs | Keys →

© 2026 Tradepost Markets Inc. All rights reserved.