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
  }
}

Changes

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

Jul 17, 2026a841981f8ee15See the full diff
- ○
  added the optional property ref_swap to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property ref_token to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property relative_price to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property relative_token_address to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property relative_total_value to the response with the 200 status
  response-optional-property-added
Oct 25, 202451ea4d2cd9915See the full diff
- ●
  removed the optional property ref_swap from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property ref_token from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property relative_price from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property relative_token_address from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property 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