Skip to main content

Get all token transfers of an NFT

Overview​

This API is a powerful tool to track the complete transfer history of any NFT. This API is invaluable for NFT creators, collectors, and marketplaces, providing detailed insights into every transaction an NFT has gone through. For collectors and investors, it enables easy tracking of an NFT’s provenance. NFT game studios and creators can also benefit from this API to monitor the distribution and movement of their assets across different users.

Get all token transfers of an NFT​

To get all token transfers list, use this get token transfers of an NFT API

It requires twp parameters (in path):

  • contractAddress: collection address
  • tokenId: NFT id

Optional parameters (in query):

  • limit: how many items can be return in a single response, maximum 200
  • cursor: the current pointer of the result set, to iterate to the next part of the results, it's returned by the previous call (nextCursor field), you get it and pass to the next call, present nextCursor means there will be more results to scroll, empty nextCursor means it reaches to the end of results
  • order: specify the order of result set. For most APIs, order might not be supported but the default value desc, otherwise you can choose between desc and asc. Desc ordering usually refers to show latest elements over older elements

Example of Ragnarok Monsters 0x029bb759353f6547fbe387e97869057849ab4d23 NFTs, tokenId 102076 :

curl --location 'https://api-gateway.skymavis.com/skynet/ronin/web3/v2/collections/0x029bb759353f6547fbe387e97869057849ab4d23/tokens/102076/transfers?limit=2' \
--header 'Accept: application/json' \
--header 'X-API-KEY: <YOUR_API_KEY>'

Response:

{
    "result": {
        "items": [
            {
                "blockNumber": 38655965,
                "logIndex": 53,
                "tokenId": "102076",
                "contractAddress": "0x029bb759353f6547fbe387e97869057849ab4d23",
                "tokenStandard": "ERC721",
                "decimals": 0,
                "from": "0x99ae854b8ca1d35498aa73738393236748d40084",
                "to": "0xc567f6ff186c4412623070a799c81fdf75e79c29",
                "value": "1",
                "blockHash": "0x97398fc21ddabc20c1094c60f06dec35dee81cc0f4224e3d123ea75f333238cb",
                "transactionHash": "0xdc9a0dc82553aa14dbdc4e85f8198269f5c2b2422b31970ea64c5d4b57ca466e",
                "blockTime": 1727807634
            },
            {
                "blockNumber": 38534941,
                "logIndex": 21,
                "tokenId": "102076",
                "contractAddress": "0x029bb759353f6547fbe387e97869057849ab4d23",
                "tokenStandard": "ERC721",
                "decimals": 0,
                "from": "0x584d6633bca1d8c125e53179727df43d81e57920",
                "to": "0x99ae854b8ca1d35498aa73738393236748d40084",
                "value": "1",
                "blockHash": "0x0a3548387de6ec74cf795d72bdce28fb673b8edc5522fcaf84f8a62e03fb5a44",
                "transactionHash": "0x92f37d5a882187299fef50515cdb00f4c425319fcd3f09c240955810c644fc2e",
                "blockTime": 1727444392
            }
        ],
        "paging": {
            "nextCursor": "Mzg1MzQ5NDE6MjE6MTAyMDc2"
        }
    }
}

The response returned from the API may vary in the future as the state of NFTs/Ownership/Collections can change.