Non Fungible Tokens

Read-only endpoints to obtain non-fungible token details

Non-Fungible Token holdings

get

Retrieves the list of Non-Fungible Tokens owned by the given principal (STX address or Smart Contract ID). Results can be filtered by one or more asset identifiers and can include metadata about the transaction that made the principal own each token.

    More information on Non-Fungible Tokens on the Stacks blockchain can be found [here](https://docs.stacks.co/write-smart-contracts/tokens#non-fungible-tokens-nfts).
Authorizations
Query parameters
principalany ofRequired
stringOptional

STX Address

Example: ["SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP"]Pattern: ^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}
or
stringOptional

Smart Contract ID

Example: ["SP000000000000000000002Q6VF78.pox-3"]Pattern: ^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$
asset_identifiersstring[]Optional

identifiers of the token asset classes to filter for

Example: ["SPQZF23W7SEYBFG5JQ496NMY0G7379SRYEDREMSV.Candy::candy"]
limitinteger · max: 200Optional

max number of tokens to fetch

Default: 50
offsetintegerOptional

index of first tokens to fetch

Default: 0
tx_metadatabooleanRequired

whether or not to include the complete transaction metadata instead of just tx_id. Enabling this option can affect performance and response times.

Default: false
Responses
200
List of Non-Fungible Token holdings
application/json
get
GET /extended/v1/tokens/nft/holdings HTTP/1.1
Host: stacks.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "limit": 20,
  "offset": 0,
  "total": 1,
  "results": [
    {
      "asset_identifier": "text",
      "value": {
        "hex": "text",
        "repr": "text"
      },
      "block_height": 1,
      "tx_id": "text"
    }
  ]
}

Non-Fungible Token history

get

Retrieves all events relevant to a Non-Fungible Token. Useful to determine the ownership history of a particular asset.

    More information on Non-Fungible Tokens on the Stacks blockchain can be found [here](https://docs.stacks.co/write-smart-contracts/tokens#non-fungible-tokens-nfts).
Authorizations
Query parameters
asset_identifierstringRequired

asset class identifier

Example: SP2X0TZ59D5SZ8ACQ6YMCHHNR2ZN51Z32E2CJ173.the-explorer-guild::The-Explorer-Guild
valuestringRequired

hex representation of the token's unique value

Example: 0x0100000000000000000000000000000803
limitinteger · max: 200Optional

max number of events to fetch

Default: 50
offsetintegerOptional

index of first event to fetch

Default: 0
unanchoredbooleanOptional

Include data from unanchored (i.e. unconfirmed) microblocks

Default: falseExample: true
tx_metadatabooleanRequired

whether or not to include the complete transaction metadata instead of just tx_id. Enabling this option can affect performance and response times.

Default: false
Responses
200
List of Non-Fungible Token history events
application/json
get
GET /extended/v1/tokens/nft/history HTTP/1.1
Host: stacks.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "limit": 20,
  "offset": 0,
  "total": 1,
  "results": [
    {
      "sender": "text",
      "recipient": "text",
      "event_index": 1,
      "asset_event_type": "text",
      "tx_id": "text"
    }
  ]
}

Non-Fungible Token mints

get

Retrieves all mint events for a Non-Fungible Token asset class. Useful to determine which NFTs of a particular collection have been claimed.

    More information on Non-Fungible Tokens on the Stacks blockchain can be found [here](https://docs.stacks.co/write-smart-contracts/tokens#non-fungible-tokens-nfts).
Authorizations
Query parameters
asset_identifierstringRequired

asset class identifier

Example: SP2X0TZ59D5SZ8ACQ6YMCHHNR2ZN51Z32E2CJ173.the-explorer-guild::The-Explorer-Guild
limitinteger · max: 200Optional

max number of events to fetch

Default: 50
offsetintegerOptional

index of first event to fetch

Default: 0
unanchoredbooleanOptional

Include data from unanchored (i.e. unconfirmed) microblocks

Default: falseExample: true
tx_metadatabooleanRequired

whether or not to include the complete transaction metadata instead of just tx_id. Enabling this option can affect performance and response times.

Default: false
Responses
200
List of Non-Fungible Token mint events for an asset identifier
application/json
get
GET /extended/v1/tokens/nft/mints HTTP/1.1
Host: stacks.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "limit": 20,
  "offset": 0,
  "total": 1,
  "results": [
    {
      "recipient": "text",
      "event_index": 1,
      "value": {
        "hex": "text",
        "repr": "text"
      },
      "tx_id": "text"
    }
  ]
}
PreviousNamesNextSearch