Get non-fungible token history

Retrieves the history of a non-fungible token.

GET

/extended/v1/tokens/nft/history

Retrieves all events relevant to a non-fungible token. This is useful when determining 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
Terminal
curl -X GET "https://api.mainnet.hiro.so/extended/v1/tokens/nft/history"

List of Non-Fungible Token history events

Example response
{
  "limit": 200,
  "offset": 0,
  "total": 0,
  "results": [
    {
      "sender": "string",
      "recipient": "string",
      "event_index": 0,
      "asset_event_type": "string",
      "tx_id": "string"
    }
  ]
}