Sign in

Returns info on an EVM (ERC-20, ...) token on the runtime.

Changed on
get/{runtime}/evm_tokens/{address}

Request

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

Path parameters

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

The runtime which to query.

addressstring required

The staking address of the token contract.

Response

The requested token.

contract_addrstring required

The Oasis address of this token's contract.

eth_contract_addrstring required

The Ethereum address of this token's contract.

namestring

Name of the token, as provided by token contract's name() method.

symbolstring

Symbol of the token, as provided by token contract's symbol() method.

decimalsinteger

The number of least significant digits in base units that should be displayed as decimals when displaying tokens. tokens = base_units / (10**decimals). Affects display only. Often equals 18, to match ETH.

type'ERC20' | 'ERC721' required

The type of a EVM token.

total_supplystring bigint
neby_derived_pricestring decimal
num_transfersinteger

The total number of transfers of this token.

May be omitted if the number of transfers cannot be known (e.g. private ERC20 tokens such as BitUSD).

num_holdersinteger

The number of addresses that have a nonzero balance of this token.

May be omited if the number of holders cannot be known (e.g. private ERC20 tokens such as BitUSD).

relative_token_addressstring

The relative price and relative total value are expressed in this reference token's base unit.

relative_pricenumber double

The relative price of one base unit of this token is this many of the relative token's base unit.

relative_total_valuenumber double

The relative price of this token multiplied by this token's total supply, in the relative token's base unit.

is_verifiedboolean required

Whether the contract has been successfully verified by Sourcify. Additional information on verified contracts is available via the /{runtime}/accounts/{address} endpoint. DEPRECATED: This field will be removed in the future in favor of verification_level

verification_level'partial' | 'full'

The level of verification of a smart contract, as defined by Sourcify. An absence of this field means that the contract has not been verified. See also https://docs.sourcify.dev/docs/full-vs-partial-match/

Example response

{
  "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