Get all addresses a specific NFT has belonged to
Authorization required to use this endpoint
To get your API key, follow the instruction here.
The Token Ownership History endpoint helps retrieve data on all the addresses that previously owned a specific NFT. As the results are sorted in ascending order, the initial owner of the token will appear first. To perform a search, it is necessary to provide both the tokenId
parameter and the address of the contract
being searched. Additionally, the metadata
and sale_price
information can be included by setting their field values to true
.
A successful request to the endpoint will return a JSON response with the data on token ownership history marked as items. The items will contain their id
and transfer
data, along with metadata
and sale_price
information if you choose to include them in your response. The transfer
data will consist of the following fields: from_address
, to_address
, origin
, block_number
, block_timestamp
, and transaction_hash
.
The cURL request shown below can give you the gist of how the endpoint operates. Be sure to replace YOUR_API_KEY
with your actual API key.
curl --location 'https://api.parsiq.net/nft/eip155-1/v1/0x282BDD42f4eb70e7A9D9F40c8fEA0825B7f68C5D/5340/history' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY'