nfts

Get NFT transfers by token

get/v1/nfts/transfers/{contract_address}/{token_id}

Request

Base URL: https://insight.thirdweb.com
URL: https://insight.thirdweb.com/v1/nfts/transfers/{contract_address}/{token_id}
Auth: API key in header x-client-id

Path parameters

contract_addressstring required

Example:vitalik.eth

token_idstring required

Query parameters

chainnumber[]

Use chain_id instead

[
  20,
  56,
  1
]

chain_idnumber[]

The chain ID(s) to request the data for. You can specify multiple chain IDs, up to a maximum of 55. Use repeated query parameters, e.g., ?chain_id=20&chain_id=56. Optional, because a single chain can as well be specified as a subdomain

[
  20,
  56,
  1
]

limitinteger

The number of items to return

Example:20

pageinteger nullable

Page number (0-indexed)

metadata'true' | 'false'

Whether to include metadata for the tokens

Example:false

include_owners'true' | 'false'

Whether to include owner addresses in the NFT metadata (only if metadata is requested)

Example:false

number

string

number

string

block_timestamp_frominteger

Filter by block timestamp greater than or equal to

Example:1749768884

block_timestamp_tointeger

Filter by block timestamp less than or equal to

Example:1749768884

owner_addressstring

Example:vitalik.eth

sort_order'asc' | 'desc'

Sort order (asc or desc)

Example:desc

sales'true' | 'false'

Whether to include sale details for NFT transfers

Example:false

resolve_metadata_links'true' | 'false'

Whether to resolve metadata IPFS or Arweave links

Example:false

Response

Success

Example response

{
  "data": [
    {
      "nft_metadata": {
        "contract": {
          "chain_id": 1,
          "address": "vitalik.eth"
        }
      },
      "nft_sale": {
        "items_sold": [
          {
            "token_address": "vitalik.eth",
            "from_address": "vitalik.eth",
            "to_address": "vitalik.eth"
          }
        ],
        "payment": [
          {
            "token_address": "vitalik.eth",
            "from_address": "vitalik.eth",
            "to_address": "vitalik.eth"
          }
        ]
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.