Keys

A key identifies a priceable variant within a product — a "PSA 10" vs "PSA 9" grade of the same card, a section/row combo for tickets. One asset configuration can hold many variants, each with its own fair value.

You need key IDs to target order submissions and strategies: a strategy's keyCriteria names the variants it prices against, and without at least one criterion a strategy never fills.

List key configurations

query K($i: ListKeyConfigurationsInput!) {
  listKeyConfigurations(input: $i) {
    keyConfigurations {
      id
      assetTypeId
      keyData { keys { keyId keyType value displayName ancestors } }
    }
    pagination { totalCount limit offset }
    error { message code }
  }
}

{ "i": { "assetTypeId": "<assetTypeId>" } }

Filter the response for the variants you want (e.g. keyType: "CARD_GRADE", value: "10") and collect the keyIds.

Input field	Type	Description
assetTypeId	UUID	Restrict to one asset type
ids	[UUID!]	Specific key configuration IDs
pagination	SimplePaginationInput	{ limit, offset }

KeyOption

Field	Type	Description
keyId	UUID!	The ID you pass into keyCriteria
keyType	KeyType!	Variant category — see below
value	String!	Raw value ("10" for PSA 10, "FLOOR" for a section)
displayName	String	Human-readable label ("PSA 10")
ancestors	[UUID!]!	Parent key IDs in the hierarchy; empty for top-level keys

Key types

keyType	Description
CARD_GRADING_COMPANY	Grading company — PSA, BGS, CGC, or RAW
CARD_GRADE	Graded card variant — PSA_10, PSA_9.5
CARD_AUTO_GRADE	Autograph grade attached to a graded card. Each auto grade key has a corresponding CARD_GRADE key in the same configuration
RAW_CARD_CONDITION	Condition variant for ungraded cards
SEALED_CONDITION	Sealed-product condition for sealed TCG, sealed wax and LEGO — MINT, NEAR_MINT, DAMAGED
WATCH_CONDITION	Condition variants for watches
SEATMAP_ZONE / SEATMAP_SECTION / SEATMAP_ROW	Venue zone, section, and row for tickets

To target autographed grades, find the CARD_AUTO_GRADE key and pair it with its CARD_GRADE key via requiredKeyIds — the pattern is worked through in Strategies → Grade targeting.