Skip to content
Alchemy Logo

Spot metadata

This API is in private preview. Target October 2026; timing is subject to change.

Returns spot token and spot-pair definitions.

Available now. This read is served at the interim endpoint today.

POST /{apiKey}/info

ParameterTypeRequiredDescription
typestringYesSelects spotMeta.
{
  "type": "spotMeta"
}

FieldTypeDescription
tokens[]arraySpot-token definitions used by spot-pair entries.
tokens[].namestringSpot-token symbol, for example USDC.
tokens[].szDecimalsintegerNumber of decimal places accepted for order sizes.
tokens[].weiDecimalsintegerDecimal places in the token’s smallest unit.
tokens[].indexintegerZero-based index used to reference this token.
tokens[].tokenIdstringOnchain identifier assigned to the spot token.
tokens[].isCanonicalbooleanWhether this token is in the canonical spot universe.
tokens[].evmContractstring | nullEVM contract address, or null when none is assigned.
tokens[].fullNamestring | nullFull token name, or null when not supplied.
universe[]arrayOrdered spot-pair definitions.
universe[].namestringSpot-pair symbol, for example PURR/USDC.
universe[].tokensarrayIndices of the base and quote tokens in the token list.
universe[].indexintegerPair index used in the @{index} spot identifier.
universe[].isCanonicalbooleanWhether this pair belongs to the canonical spot universe.

{
  "tokens": [
    {
      "name": "USDC",
      "szDecimals": 8,
      "weiDecimals": 8,
      "index": 0,
      "tokenId": "0x6d1e7cde53ba9467b783cb7c530ce054",
      "isCanonical": true,
      "evmContract": null,
      "fullName": null
    }
  ],
  "universe": [
    { "name": "PURR/USDC", "tokens": [1, 0], "index": 0, "isCanonical": true }
  ]
}
Was this page helpful?