Path Parameters
- walletAddressstringREQUIRED
The wallet address to fetch token balances for
Query Parameters
- chainsstring
A comma-separated list of chain names or IDs to retrieve token balances from. Defaults to all foundational chains
- limitinteger
The maximum number of token balances to return per page, up to 100
- beforestring
Pagination cursor pointing to fetch token balances before a certain point in time
- cutoff-timestampinteger
The timestamp to filter balances updated before this time
- quote-currencystring
The currency in which to return token quotes
Returns
- dataobject
The main container for the asset data
- updated_atstring
The timestamp when the data was last updated
- cursor_beforestring
Cursor pointing to the position before the current page of data
- quote_currencystring
The currency used for quoting values
- itemsarray
A list of asset items
- contract_decimalsinteger
The number of decimals used by the token contract
- contract_namestring
The name of the token contract
- contract_ticker_symbolstring
The ticker symbol of the token contract
- contract_addressstring
The address of the token contract
- supports_ercarray
A list of supported ERC standards
- contract_display_namestring
The display name of the token contract
- logo_urlsobject
URLs of logos associated with the token
- token_logo_urlstring
The URL of the token's logo
- protocol_logo_urlstring
The URL of the protocol's logo, if available
- chain_logo_urlstring
The URL of the chain's logo
- last_transferred_atstring
The timestamp of the last transfer involving the token
- typestring
The type of asset (e.g., cryptocurrency or dust)
- is_spamboolean
Indicates whether the asset is flagged as spam
- balancestring
The current balance of the token
- balance_24hstring
The balance of the token 24 hours ago
- quote_ratenumber
The quoted rate of the token in the specified currency
- quote_rate_24hnumber
The quoted rate of the token 24 hours ago in the specified currency
- quotenumber
The current value of the token in the specified currency
- pretty_quotestring
A formatted string of the current token value
- quote_24hnumber
The token value 24 hours ago in the specified currency
- pretty_quote_24hstring
A formatted string of the token value 24 hours ago
- chain_idstring
The ID of the blockchain network
- chain_namestring
The name of the blockchain network
- chain_display_namestring
The display name of the blockchain network
- is_native_tokenboolean
Indicates if the token is the native token of the blockchain
- errorboolean
Indicates if an error occurred during the request
- error_messagestring
The error message, if applicable
- error_codeinteger
The error code, if applicable
1{2"data": {3"updated_at": "2025-04-29T21:01:39.175128580Z",4"address": "0x9690c8c169dd8fc15d75593048e4c453b7cc451c",5"items": [6{7"name": "eth-mainnet",8"chain_id": "1",9"is_testnet": false,10"db_schema_name": "chain_eth_mainnet",11"label": "Ethereum Mainnet",12"category_label": "Ethereum",13"priority_label": "Foundational",14"logo_url": "https://www.datocms-assets.com/86369/1669653891-eth.svg",15"black_logo_url": "https://www.datocms-assets.com/86369/1669619544-ethereum.png",16"white_logo_url": "https://www.datocms-assets.com/86369/1669619533-ethereum.png",17"color_theme": {18"red": 94,19"green": 121,20"blue": 138,21"alpha": 255,22"hex": "#5E798A",23"css_rgb": "rgb(94 121 138)"24},25"is_appchain": false,26"appchain_of": null,27"last_seen_at": "2024-11-14T13:02:11Z"28},29{30"name": "base-mainnet",31"chain_id": "8453",32"is_testnet": false,33"db_schema_name": "chain_base_mainnet",34"label": "Base Mainnet",35"category_label": "Coinbase",36"priority_label": "Foundational",37"logo_url": "https://www.datocms-assets.com/86369/1677538323-property-1-base-icon-white.svg",38"black_logo_url": "https://www.datocms-assets.com/86369/1677538328-property-1-base-white.png",39"white_logo_url": "https://www.datocms-assets.com/86369/1677538326-base-colour.png",40"color_theme": {41"red": 15,42"green": 91,43"blue": 228,44"alpha": 255,45"hex": "#0F5BE4",46"css_rgb": "rgb(15 91 228)"47},48"is_appchain": false,49"appchain_of": null,50"last_seen_at": "2024-11-14T13:02:49Z"51}52]53},54"error": false,55"error_message": null,56"error_code": null57}
1{2"data": {3"updated_at": "2025-04-29T21:01:39.175128580Z",4"address": "0x9690c8c169dd8fc15d75593048e4c453b7cc451c",5"items": [6{7"name": "eth-mainnet",8"chain_id": "1",9"is_testnet": false,10"db_schema_name": "chain_eth_mainnet",11"label": "Ethereum Mainnet",12"category_label": "Ethereum",13"priority_label": "Foundational",14"logo_url": "https://www.datocms-assets.com/86369/1669653891-eth.svg",15"black_logo_url": "https://www.datocms-assets.com/86369/1669619544-ethereum.png",16"white_logo_url": "https://www.datocms-assets.com/86369/1669619533-ethereum.png",17"color_theme": {18"red": 94,19"green": 121,20"blue": 138,21"alpha": 255,22"hex": "#5E798A",23"css_rgb": "rgb(94 121 138)"24},25"is_appchain": false,26"appchain_of": null,27"last_seen_at": "2024-11-14T13:02:11Z"28},29{30"name": "base-mainnet",31"chain_id": "8453",32"is_testnet": false,33"db_schema_name": "chain_base_mainnet",34"label": "Base Mainnet",35"category_label": "Coinbase",36"priority_label": "Foundational",37"logo_url": "https://www.datocms-assets.com/86369/1677538323-property-1-base-icon-white.svg",38"black_logo_url": "https://www.datocms-assets.com/86369/1677538328-property-1-base-white.png",39"white_logo_url": "https://www.datocms-assets.com/86369/1677538326-base-colour.png",40"color_theme": {41"red": 15,42"green": 91,43"blue": 228,44"alpha": 255,45"hex": "#0F5BE4",46"css_rgb": "rgb(15 91 228)"47},48"is_appchain": false,49"appchain_of": null,50"last_seen_at": "2024-11-14T13:02:49Z"51}52]53},54"error": false,55"error_message": null,56"error_code": null57}