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

Changed on Jul 17, 2026

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

Request

Base URL
https://nexus.oasis.io/v1
Auth
none declared
TypeScript
https://skmtc.dev/oasisprotocol/apis/oasis-nexus-api-v1/docs/:runtime/evm_tokens/:address/nfts/:id/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

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

The runtime which to query.

addressstring required

The staking address of the token contract of the NFT instance.

idstring bigint required

Example:1234567890123456789012

The ID of the NFT instance.

Response

The requested instances.

idstring bigint required

ownerstring

An Oasis-style (bech32) address.

owner_ethstring

The Ethereum address of this NFT instance's owner.

num_transfersinteger

The total number of transfers of this NFT instance.

metadata_uristring

metadata_accessedstring

metadataunknown

namestring

Identifies the asset which this NFT represents

descriptionstring

Describes the asset which this NFT represents

imagestring

A URI pointing to a resource with mime type image/* representing the asset which this NFT represents. (Additional non-descriptive text from ERC-721 omitted.)

Example response

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

Jul 17, 2026a841981f8ee1 Revision changes
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
Nov 6, 202451ea4d2cd991 Revision changes
- warning
  removed the optional property ///// from the response with the status
- warning
  removed the optional property ///// from the response with the status
- warning
  removed the optional property ///// from the response with the status
- warning
  removed the optional property ///// from the response with the status
- warning
  removed the optional property ///// from the response with the status

Operation history