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 '' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY'
Click Try It! to start a request and see the response here!