v1

latestOpenAPI 3.0.32026-07-173986194.3 KB

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

get/{runtime}/evm_tokens/{address}

Path parameters

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

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

num_transfersinteger

The total number of transfers of this token.

num_holdersinteger required

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

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