Get non-fungible token history

Retrieves the history of a non-fungible token.

GET

Parameters

Query Parameters

asset_identifier
REQUIRED
string asset class identifier
value
REQUIRED
string hex representation of the token's unique value
limit
integer max number of events to fetch
offset
integer index of first event to fetch
unanchored
boolean Include data from unanchored (i.e. unconfirmed) microblocks
tx_metadata
REQUIRED
boolean whether or not to include the complete transaction metadata instead of just `tx_id`. Enabling this option can affect performance and response times.
Status codeDescription
200List of Non-Fungible Token history events
4XXDefault Response
cURL
curl -L \

  "https://api.hiro.so/extended/v1/tokens/nft/history?asset_identifier=SP2X0TZ59D5SZ8ACQ6YMCHHNR2ZN51Z32E2CJ173.the-explorer-guild::The-Explorer-Guild&value=0x0100000000000000000000000000000803&limit={limit}&offset={offset}&unanchored=true&tx_metadata={tx_metadata}" \

  -H 'Accept: application/json'
Response
{

  "limit": 20,

  "offset": 0,

  "total": 1,

  "results": [

    {

      "sender": "SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP",

      "recipient": "SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP",

      "event_index": 0,

      "asset_event_type": "transfer",

      "tx_id": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"

    }

  ]

}

How is this guide?