Links

nft_circulations

Get historical records of NFT transfers without scanning the entire chain.
Through nft_circulations, you can fetch all the transfer records of the NFT you searched for, contractAddress and tokenId are necessary. If you specify the account address, the API will return transfer records related to the account. Using this API, you could which account transferred this NFT. Plus, you could also know when and how the NFT was transferred.
Supported on Ethereum, BNB Chain, Optimism, and Arbitrum.

Parameters

Object - An object with the following fields (required):
  • tokenId(string, required) - id of the NFT.
  • contractAddress(hex string, required) - the contract address of the collection. BlockVision currently support both ERC721 and ERC1155.
  • accountAddress(hex string, optional) - the account address you want to query.
  • pageSize(integer number, optional, default 20 max 50) - max number of results to return per call.
  • pageIndex(integer number, optional, default 1) - page index.

Returns

Object - An object with the following fields:
  • id(integer number) - json-rpc id.
  • jsonrpc(string) - json-rpc version.
  • result(object) - an object with the following fields:
    • nextPageIndex(integer number) - next page index.
    • data(array of object, defined below) - response data.
  • Object schema:
    • blockNumber(integer number) - block number.
    • tokenID(string) - id of the NFT.
    • contractAddress(hex string) - contract address.
    • txHash(hex string) - transaction hash.
    • blockHash(hex string) - block hash.
    • logIndex(integer number) - log index.
    • removed(boolean) - whether is removed.
    • fromAddress(hex string) - from address.
    • toAddress(hex string) - to address.
    • operator(hex string) - interactive contract address.
    • isBatch(integer number) - determine is batch or not.
    • batchIndex(integer number) - batch index.
    • value(hex string) - account balance.

Example

Request

curl
TypeScript
curl https://api.blockvision.org/v1/<api key> \
-X POST \
-H "Content-Type: application/json" \
-d '{
"id": 1,
"jsonrpc": "2.0",
"method": "nft_circulations",
"params": {
"tokenId": "1",
"contractAddress": "0xA7206d878c5c3871826DfdB42191c49B1D11F466",
"pageSize": 5,
"pageIndex": 0
}
}'
import { BlockVisionProvider, BvNetwork } from 'blockvision.js'
​
// Optional parameters, but default to eth-mainnet and default api-key.
const bv = new BlockVisionProvider(BvNetwork.ETH_MAINNET)
​
// Access the BlockVision NFT API
bv.getNFTCirculations({
tokenId: '1',
contractAddress: '0xA7206d878c5c3871826DfdB42191c49B1D11F466'
}).then(console.log)

Result

{
"jsonrpc": "2.0",
"id": 1,
"result": {
"data": [
{
"contractAddress": "0xA7206d878c5c3871826DfdB42191c49B1D11F466",
"blockNumber": 14795395,
"txHash": "0x5b3b8dde3b5e81059eaefc46741db229c176858f643f07fd844eb4ffb7c5dbb8",
"blockHash": "0xf4e2ca1131f8622d6c570f51301a5cd48d68a2b7a9b3ba448354a64ff8bc5649",
"logIndex": 380,
"from": "0xD4633a2142EE142817bae014CA7Cfc8AAd2c1899",
"to": "0x4b3406a41399c7FD2BA65cbC93697Ad9E7eA61e5",
"Operator": "0xD4633a2142EE142817bae014CA7Cfc8AAd2c1899",
"isBatch": 0,
"batchIndex": 0,
"tokenID": "1",
"value": "1"
},
{
"contractAddress": "0xA7206d878c5c3871826DfdB42191c49B1D11F466",
"blockNumber": 14795395,
"txHash": "0x5b3b8dde3b5e81059eaefc46741db229c176858f643f07fd844eb4ffb7c5dbb8",
"blockHash": "0xf4e2ca1131f8622d6c570f51301a5cd48d68a2b7a9b3ba448354a64ff8bc5649",
"logIndex": 381,
"from": "0x4b3406a41399c7FD2BA65cbC93697Ad9E7eA61e5",
"to": "0x000000000000000000000000000000000000dEaD",
"Operator": "0x4b3406a41399c7FD2BA65cbC93697Ad9E7eA61e5",
"isBatch": 0,
"batchIndex": 0,
"tokenID": "1",
"value": "1"
},
{
"contractAddress": "0xA7206d878c5c3871826DfdB42191c49B1D11F466",
"blockNumber": 14795366,
"txHash": "0x4b58def9fa2a9d7bcc435a107e4740d98947f1b28f84e42708c68bfa02d8ea97",
"blockHash": "0xd89f778057961be5dfcb1f9671c62d631d96aec74de701eee9e89a4221e62a76",
"logIndex": 85,
"from": "0x4b3406a41399c7FD2BA65cbC93697Ad9E7eA61e5",
"to": "0x000000000000000000000000000000000000dEaD",
"Operator": "0x4b3406a41399c7FD2BA65cbC93697Ad9E7eA61e5",
"isBatch": 0,
"batchIndex": 0,
"tokenID": "1",
"value": "1"
},
{
"contractAddress": "0xA7206d878c5c3871826DfdB42191c49B1D11F466",
"blockNumber": 14795366,
"txHash": "0x4b58def9fa2a9d7bcc435a107e4740d98947f1b28f84e42708c68bfa02d8ea97",
"blockHash": "0xd89f778057961be5dfcb1f9671c62d631d96aec74de701eee9e89a4221e62a76",
"logIndex": 84,
"from": "0xD4633a2142EE142817bae014CA7Cfc8AAd2c1899",
"to": "0x4b3406a41399c7FD2BA65cbC93697Ad9E7eA61e5",
"Operator": "0x9e37d984258a2D83e33649003FCB6cb27b179c38",
"isBatch": 0,
"batchIndex": 0,
"tokenID": "1",
"value": "1"
},
{
"contractAddress": "0xA7206d878c5c3871826DfdB42191c49B1D11F466",
"blockNumber": 14795366,
"txHash": "0x4b58def9fa2a9d7bcc435a107e4740d98947f1b28f84e42708c68bfa02d8ea97",
"blockHash": "0xd89f778057961be5dfcb1f9671c62d631d96aec74de701eee9e89a4221e62a76",
"logIndex": 82,
"from": "0x4b3406a41399c7FD2BA65cbC93697Ad9E7eA61e5",
"to": "0x000000000000000000000000000000000000dEaD",
"Operator": "0x4b3406a41399c7FD2BA65cbC93697Ad9E7eA61e5",
"isBatch": 0,
"batchIndex": 0,
"tokenID": "1",
"value": "1"
}
],
"nextPageIndex": 2
}
}
Last modified 1mo ago