Returns a list of EVM (ERC-20, ...) tokens on the runtime.

get/{runtime}/evm_tokens

Path parameters

runtime'emerald' | 'sapphire' | 'pontusxtest' | 'pontusxdev' | 'cipher' required

The runtime which to query.

Query parameters

limitinteger

The maximum numbers of items to return.

offsetinteger

The number of items to skip before starting to collect the result set.

namestring

A filter on the name, the name or symbol must contain this value as a substring.

sort_by'total_holders' | 'market_cap'

The field to sort the tokens by. If unset, the tokens will be sorted by number of holders.

Response

The requested tokens.

total_countinteger required

The total number of records that match the query, i.e. the number of records the query would return with limit=infinity.

is_total_count_clippedboolean required

Whether total_count is clipped for performance reasons.

Example response

{
  "total_count": 412,
  "is_total_count_clipped": true,
  "evm_tokens": [
    {
      "contract_addr": "oasis1qp2hssandc7dekjdr6ygmtzt783k3gn38uupdeys",
      "name": "Uniswap",
      "symbol": "USDT",
      "decimals": 18,
      "total_supply": "1234567890123456789012",
      "num_holders": 123,
      "ref_swap": {
        "reserve0": "1234567890123456789012",
        "reserve1": "1234567890123456789012"
      },
      "ref_token": {
        "name": "Wrapped ROSE",
        "symbol": "wROSE",
        "decimals": 18
      }
    }
  ]
}

Changes

Changed in 2 of the 3 revisions of this API.66

Jul 17, 2026a841981f8ee16See the full diff
- ○
  added the new optional query request parameter sort_by
  new-optional-request-parameter
- ○
  added the optional property allOf[subschema #2]/evm_tokens/items/allOf[EvmToken]/ref_swap to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property allOf[subschema #2]/evm_tokens/items/allOf[EvmToken]/ref_token to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property allOf[subschema #2]/evm_tokens/items/allOf[EvmToken]/relative_price to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property allOf[subschema #2]/evm_tokens/items/allOf[EvmToken]/relative_token_address to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property allOf[subschema #2]/evm_tokens/items/allOf[EvmToken]/relative_total_value to the response with the 200 status
  response-optional-property-added
Oct 25, 202451ea4d2cd9916See the full diff
- ●
  deleted the query request parameter sort_by
  request-parameter-removed
- ●
  removed the optional property allOf[subschema #2]/evm_tokens/items/allOf[EvmToken]/ref_swap from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property allOf[subschema #2]/evm_tokens/items/allOf[EvmToken]/ref_token from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property allOf[subschema #2]/evm_tokens/items/allOf[EvmToken]/relative_price from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property allOf[subschema #2]/evm_tokens/items/allOf[EvmToken]/relative_token_address from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property allOf[subschema #2]/evm_tokens/items/allOf[EvmToken]/relative_total_value from the response with the 200 status
  response-optional-property-removed
This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history