Get NFT History by Address

Overview

The Get NFT History by Address endpoint obtains data on all NFTs previously owned by an EOA wallet, whose address is a required path parameter. Results are sorted in descending order, so the most recently transferred NFT that the address had owned will appear at the top. To refine your search, you can add a contract address as a query parameter. Additionally, metadata and sale_price can be included by setting their field values to true.

A successful request to the endpoint returns a JSON response with data on previously owned NFTs, labeled as items. These items include their id, token_id, collection and transfer data, along with metadata and sale_price if you opt to include them in your response. The transfer data features the following fields: block_number, block_timestamp, tx_hash, from_address, to_address, and origin.

Querying via Postman

If you prefer querying via Postman, the description of PARSIQ Endpoints for Get NFT History by Address (opens in a new tab) might come in handy. There you will find examples and responses for good and bad requests as well as parameter definitions and their example values.

Usage

In this example, we receive data on all NFTs previously owned by the EOA wallet's address 0xb6042f438D63181E7E220A72e9fff845062EB48d.

import * as Parsiq from '@parsiq/parsiq.js';
 
const client = Parsiq.createClient(process.env.API_KEY, Parsiq.ChainId.ETH_MAINNET);
 
const nftHistoryByAddress = client.nft.getAddressHistory(
    '0xb6042f438D63181E7E220A72e9fff845062EB48d',
    {metadata: true, sale_price: true},
    {limit: 1}
);
 
for await (const nft of nftHistoryByAddress) {
    console.log(nft);
}

Output:

{
  id: '0000000000e27dd7-013b-0000000a-00000',
  token_id: '5550',
  collection: {
    address: '0x36d7b711390d34e8fe26ad8f2bb14e7c8f0c56e9',
    total_supply: '5555',
    symbol: 'ODYC',
    name: 'Okay Duck Yacht Club',
    standard: 'ERC721'
  },
  transfer: {
    from: '0xbea2bde77dded2336fa2a86bcf0e2a5b167ec67e',
    to: '0xb6042f438d63181e7e220a72e9fff845062eb48d',
    origin: '0xb6042f438d63181e7e220a72e9fff845062eb48d',
    block_number: 14843351,
    block_timestamp: 1653502217,
    tx_hash: '0xd6dfddfe14d89ef11756969dd76718fa90cf4faf98c0ceb1acca5c60fec469e0'
  },
  metadata: {
    content: {
      name: 'Okay Duck Yacht Club #5550',
      description: "Ducks are quackin'. Join the Yacht Club and be Okay.",
      image: 'ipfs://QmUmnn8CrWyukriFL2ZMA4jVGVTAYMgwfGXxWVvBEGQ3nu/5550.png',
      dna: '3576afebf1c9216be4b0d1e0f7b8a1ee9664b8e5',
      edition: 5550,
      attributes: [Array]
    },
    is_json: true,
    token_uri: 'ipfs://QmUapkBYTtVpahj7gmZiAGDeSmBy5hG4HkUW1yiye1eQNC/5550.json'
  },
  sale_price: {
    value_raw: '110000000000000000',
    value_calculated: '0.11',
    token_address: null,
    token_decimals: null,
    token_symbol: null
  }
}

Parameters

Path params

chainId

string

REQUIRED

version

string

REQUIRED

address

string

REQUIRED

Query params

contract

string

metadata

boolean

sale_price

boolean

offset

string

limit

number

estimate_cu

boolean

Get NFT by Address Get NFT History