Sign in

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

get/{runtime}/evm_tokens

Request

  • Base URL: https://nexus.oasis.io/v1
  • URL: https://nexus.oasis.io/v1/{runtime}/evm_tokens
  • Auth: none declared

Path parameters

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

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. If multiple names are provided, the token must match all of them.

sort_by'total_holders' | 'market_cap'

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

type'ERC20' | 'ERC721'

The type of a EVM token.

The type of tokens to return.

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",
      "neby_derived_price": "12345.678901234567890123",
      "num_holders": 123,
      "ref_swap": {
        "reserve0": "1234567890123456789012",
        "reserve1": "1234567890123456789012"
      },
      "ref_token": {
        "name": "Wrapped ROSE",
        "symbol": "wROSE",
        "decimals": 18
      }
    }
  ]
}

Changes