Skip to main content
GET
Get token by ID

Authorizations

Authorization
string
header
required

Send Authorization: <ApiKey>:<ApiSecret> — joined by a colon, raw. No Bearer prefix, no base64.

Get your credentials

Path Parameters

id
string
required

The token id returned by Get tokens

Pattern: ^[a-fA-F0-9]{24}$

Response

Success

icon
string
required

Token icon URL.

id
string
required

The token id. Pass this as from / to when quoting.

chain
string
required

Chain short name, e.g. ethereum. Matches shortName on chainData.

created
string<date-time>
required
chainData
object
required

The chain this token lives on.

address
string | null

Contract address. Null for a chain's native coin — see mainnet.

decimals
number<double>
default:0

On-chain decimals. Amounts in this API are decimals in the token's own units, so you only need this for on-chain work.

symbol
string
default:""
name
string
default:""
modified
string<date-time>
description
string | null

Token description from CoinGecko.

mainnet
boolean

True for the chain's native coin (e.g. ETH on Ethereum), false for an issued token (e.g. USDT). Not related to mainnet vs testnet.

enabled
boolean

False when the token is temporarily not swappable.

unverified
boolean

True when we have not reviewed this token yet — check securityScan before using it.

hasDex
boolean

True when the token can be swapped on DEX routes.

hasCex
boolean

True when the token can be swapped on private and standard routes.

hasBundler
boolean

True when the bundler can fund this token — paying for a whole multi-exchange group with one transaction instead of a deposit per order. Available on Solana, and on supported EVM chains.

hasSelfPrivate
boolean

True when the token supports self-to-self private swaps — send it and receive the same token at another address, with no on-chain link.

cexTokenId
string
default:""

The token's identifier on centralized exchanges.

rank
number<double> | null

CoinGecko market-cap rank. Null when unranked.

cgId
string | null

CoinGecko id for this token.

marketCapChange24h
number<double>

24h market cap change percentage from CoinGecko.

circulatingSupply
number<double>

Token circulating supply from CoinGecko.

price
number<double> | null

Current price in USD, from CoinGecko.

marketCap
number<double> | null

Market cap in USD, from CoinGecko.

volume
number<double> | null

24h trading volume in USD, from CoinGecko.

fdv
number<double> | null

Fully diluted valuation in USD, from CoinGecko.

change
number<double> | null

24h price change, as a percentage.

priority
number<double> | null

Display order — lower sorts first. Unrelated to rank.

warningMessage
string

Warning to show the user before swapping this token.

securityScan
object

Latest security verdict for this token. Absent until the token has been used in a swap at least once.