Non-fungible tokensGet non-fungible token history

Get non-fungible token history

Retrieves the history of a non-fungible token.

GET
/extended/v1/tokens/nft/history

Non-Fungible Token history

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.

Query Parameters

asset_identifier
Required
string

token asset class identifier

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

value
Required
string

hex representation of the token's unique value

Example: "0x0100000000000000000000000000000803"

limitinteger

max number of events to fetch

Default: 50

offsetinteger

index of first event to fetch

Example: 42000Default: 0

unanchoredboolean

whether or not to include events from unconfirmed transactions

Example: trueDefault: false

tx_metadataboolean

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
Status codeDescription
200Non-Fungible Token event history
/extended/v1/tokens/nft/history

Terminal
$ 
curl -X GET "https://api.hiro.so/extended/v1/tokens/nft/history?asset_identifier=SP2X0TZ59D5SZ8ACQ6YMCHHNR2ZN51Z32E2CJ173.the-explorer-guild%3A%3AThe-Explorer-Guild&value=0x0100000000000000000000000000000803&limit=50&offset=42000&unanchored=true&tx_metadata=false"

List of Non-Fungible Token history events

{

  "limit": 200,

  "offset": 0,

  "total": 0,

  "results": [

    {

      "sender": "string",

      "recipient": "string",

      "event_index": 0,

      "asset_event_type": "string",

      "tx_id": "string"

    }

  ]

}

Non-fungible tokens

Get non-fungible token holdings