Get non-fungible token history

Query Parameters

asset_identifierstring

asset class identifier

valuestring

hex representation of the token's unique value

limit?Limit

max number of events to fetch

Default50

Rangevalue <= 200

offset?Offset

index of first event to fetch

Default0

unanchored?boolean

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

Defaultfalse

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.

Defaultfalse

Response Body

List of Non-Fungible Token history events

TypeScript Definitions

Use the response body type in TypeScript.

limitinteger

offsetinteger

totalinteger

resultsarray<NonFungibleTokenHistoryEvent>

Default Response

TypeScript Definitions

Use the response body type in TypeScript.

errorstring

message?string

[key: string]any

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=0&unanchored=true&tx_metadata=false"

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

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {
  url := "https://api.hiro.so//extended/v1/tokens/nft/history?asset_identifier=SP2X0TZ59D5SZ8ACQ6YMCHHNR2ZN51Z32E2CJ173.the-explorer-guild%3A%3AThe-Explorer-Guild&value=0x0100000000000000000000000000000803&limit=50&offset=0&unanchored=true&tx_metadata=false"

  req, _ := http.NewRequest("GET", url, nil)
  
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}

import requests

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

response = requests.request("GET", url)

print(response.text)

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

{
  "error": "string",
  "message": "string"
}