Returns the list of non-fungible token (NFT) instances owned by an account.

get/{runtime}/accounts/{address}/nfts

Path parameters

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

The runtime which to query.

addressstring required

The staking address of the owner of 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.

token_addressstring

Only return NFT instances from the token contract at the given staking address.

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

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

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