Sign in

Returns the list of non-fungible token (NFT) instances of an EVM (ERC-721, ...) token.

Changed on

This endpoint does not verify that address is actually an EVM token; if it is not, it will simply return an empty list.

get/{runtime}/evm_tokens/{address}/nfts

Request

  • Base URL: https://nexus.oasis.io/v1
  • URL: https://nexus.oasis.io/v1/{runtime}/evm_tokens/{address}/nfts
  • 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 for which to return the NFT instances.

Query parameters

limitinteger

The maximum numbers of items to return.

offsetinteger

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

Response

The requested instances.

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_nfts": [
    {
      "token": {
        "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
        }
      },
      "id": "1234567890123456789012",
      "owner": "oasis1qpg2xuz46g53737343r20yxeddhlvc2ldqsjh70p",
      "owner_eth": "0xDEF1009df2d6872C214cd9148c6883893B7c4D91"
    }
  ]
}

Changes

  • v1a3bdb2b65c33Revision changes
    • breaking

      the response property //////////// became optional for the status

  • v1280c490bb8a1Revision changes
    • info

      added the optional property //////////// to the response with the status