Sign in

v1

latestOpenAPI 3.0.02026-07-26268286602.5 KB
tokens

List tokens with optional filtering by name, symbol, or type

Retrieves a paginated list of tokens with optional filtering by name, symbol, or type.

get/{chain_id}/api/v2/tokens/

Path parameters

chain_idstring required

The ID of the blockchain

Query parameters

string
OR
string

Filter by token type. Comma-separated list of:

  • ERC-20 - Fungible tokens
  • ERC-721 - Non-fungible tokens
  • ERC-1155 - Multi-token standard
  • ERC-404 - Hybrid fungible/non-fungible tokens

Example: ERC-20,ERC-721 to show both fungible and NFT transfers

qstring nullable

Search query filter

limitinteger nullable

Limit result items in the response

sort'fiat_value' | 'holders_count' | 'circulating_market_cap'

Sort results by:

  • fiat_value - Sort by fiat value
  • holders_count - Sort by number of token holders
  • circulating_market_cap - Sort by circulating market cap of the token Should be used together with order parameter.
order'asc' | 'desc'

Sort order:

  • asc - Ascending order
  • desc - Descending order Should be used together with sort parameter.
items_countinteger

Number of items per page

contract_address_hashstring nullable

Contract address hash for paging

string
OR
string
OR
string

Fiat value for paging

string
OR
string
OR
string

Number of holders returned per page

is_name_nullboolean

Is name null for paging

string
OR
string
OR
string

Market cap for paging

namestring

Name for paging

Response

List of tokens matching the filter criteria, with pagination.

next_page_paramsobject nullable required

Example response

{
  "items": [
    {
      "icon_url": "https://example.com"
    }
  ],
  "next_page_params": {
    "contract_address_hash": "0xbe9895146f7af43049ca1c1ae358b0541ea49704",
    "fiat_value": "4724.32",
    "holders_count": 59731,
    "is_name_null": false,
    "market_cap": "570958125.135513",
    "name": "Wrapped Staked ETH"
  }
}