Skip to main content
GET
GET /v1/asset · 1 credit One asset and all its tokens across chains: BTC with WBTC, cbBTC and BTCB, ETH with the native coin of every chain and its WETH, USDC with its bridged copies. Look it up by id, or by chain and address of any of its tokens, and add variant to keep one product of it. POST twin on the same path for batches (≤100, billed as one call per 25 items served).
Every token of an asset is worth one unit of the asset, so balances can be summed as is. kind says how: native (the asset itself: a chain’s native coin or the issuer’s own contract), wrapped (a 1:1 wrapper: WETH, WBTC, cbBTC), bridged (a 1:1 copy moved by a bridge: USDC.e, USDbC, Binance-Peg ETH).
Staked and yield-bearing versions (stETH, wstETH, LBTC, jitoSOL, sUSDe) are never inside the asset they stake, since their value drifts from it: each is its own asset with category: "staked" and underlying set to that asset’s id. List them with GET /v1/assets?underlying=eth.
variants lists the products inside an asset (WBTC by BitGo, cbBTC by Coinbase, BTCB by Binance), each token names its variant. An asset holds tokens on our supported chains only.
variant (an id from variants) keeps the tokens of that product only, on every chain: ?id=btc&variant=wbtc lists every WBTC, ?id=usdt&variant=usdt0 every USDT0; variants then holds that product alone. It works from a token too (?chain=evm:8453&address=…&variant=cbbtc). A variant id is not an asset id (?id=wbtc answers 404), and a variant the asset does not have answers 404 NOT_FOUND with the asset’s variants in the message.
On Arc and Stable, the chain’s native coin and its ERC-20 contract are the same balance seen twice (0x0000…0000 and 0x3600…0000 for USDC on Arc, 0x0000…0000 and 0x779d…3736 for USDT0 on Stable): both map to the asset, count only one of them.
A token that no asset groups answers 404 NOT_FOUND. Prices are per token: POST /v1/token/price.

Authorizations

​
Authorization
string
header
required

Your raw API key (not needed on the demo server).

Query Parameters

​
id
string

Asset id, as listed by GET /v1/assets. Either id, or chain and address.

​
chain
string

Public chain id of one of the asset's tokens (with address).

​
address
string

Any token of the asset on chain: 0x0000000000000000000000000000000000000000 (or 0xeeee…eeee) is the chain's native coin.

​
variant
string

Keep the tokens of one product of the asset only, an id from its variants (wbtc in btc, usdt0 in usdt). A variant id alone is not an asset id.

Response

200

Standard { data, meta } envelope.