Get all NFTs ever held by a specific address
Authorization required to use this endpoint
To get your API key, follow the instruction here.
The Address Inventory History endpoint allows you to obtain data on all the NFTs that previously belonged to a particular EOA address. As the results are sorted in descending order, the last transferred NFT owned by the address will appear first. To refine your search, specify a contract address as a query parameter. You can also include the metadata
and sale_price
information by setting their field values to true
.
A successful request to the endpoint will return a JSON response with the data on previously owned NFTs marked as items. The items will contain their id
, token_id
, the collection
and transfer
data, along with the metadata
and sale_price
information if you choose to include them in your response. Not only will the transfer
data consist of block_number
, block_timestamp
, and transaction_hash
, but it will also have from_address
, to_address
, and origin
.
The cURL request demonstrated 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/0xb6042f438D63181E7E220A72e9fff845062EB48d/history' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY'