Skip to main content

Don't have an API key yet?

Sign-up to Moralis to get your free API key and start building today.

Get Your Free API Key
Version: 2.0

How to get all transfers of an NFT

Prerequisites​

Before getting started, make sure you have the following ready:

  • Node v.14+ or Python
  • NPM/Yarn or Pip

Step 1: Setup Moralis​

First register your Moralis account and get your Moralis API Key.

Once you have your Moralis API Key, install the Moralis SDK in your project.

npm install moralis @moralisweb3/common-evm-utils

Step 2: Get All Transfers Of An NFT​

In order to get all the transfers of an NFT, Moralis provides you with an getNFTTransfers endpoint.

Here you'll need three parameters: address, tokenId, and chain.

Once you have obtained the address, tokenId and chain, you can copy the following code:

const Moralis = require("moralis").default;
const { EvmChain } = require("@moralisweb3/common-evm-utils");

const runApp = async () => {
await Moralis.start({
apiKey: "YOUR_API_KEY",
// ...and any other configuration
});

const address = "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d";

const tokenId = "1";

const chain = EvmChain.ETHEREUM;

const response = await Moralis.EvmApi.nft.getNFTTransfers({
address,
tokenId,
chain,
});

console.log(response.toJSON());
};

runApp();

Step 3: Run the script​

To run the script, enter the following command:

node index.js

In your terminal, you should see the following JSON response:

{
"total": 2,
"page": 0,
"page_size": 100,
"cursor": null,
"result": [
{
"block_number": "12344148",
"block_timestamp": "2021-04-30T21:11:46.000Z",
"block_hash": "0xa367b094366bc68de295ae6167797afc55eeb8383869363a6d7eb143c31d8274",
"transaction_hash": "0xe93e858f9330afa4581e260198195623aa7f5cd2809012440ea291d317be9f2f",
"transaction_index": 154,
"log_index": 328,
"value": "0",
"contract_type": "ERC721",
"transaction_type": "Single",
"token_address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
"token_id": "1",
"from_address": "0xaba7161a7fb69c88e16ed9f455ce62b791ee4d03",
"to_address": "0x46efbaedc92067e6d60e84ed6395099723252496",
"amount": "1",
"verified": 1,
"operator": null
},
{
"block_number": "12292922",
"block_timestamp": "2021-04-22T23:13:40.000Z",
"block_hash": "0xe2d521d11856591b77506a383033cf85e1d46f1669321859154ab38643244293",
"transaction_hash": "0xcfb197f62ec5c7f0e71a11ec0c4a0e394a3aa41db5386e85526f86c84b3f2796",
"transaction_index": 21,
"log_index": 86,
"value": "0",
"contract_type": "ERC721",
"transaction_type": "Single",
"token_address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
"token_id": "1",
"from_address": "0x0000000000000000000000000000000000000000",
"to_address": "0xaba7161a7fb69c88e16ed9f455ce62b791ee4d03",
"amount": "1",
"verified": 1,
"operator": null
}
],
"block_exists": true
}

Congratulations πŸ₯³ You just got all the transfers of an NFT with just a few lines of code using the Moralis NFT API!

API Reference​

If you want to know more details on the endpoint and optional parameters, check out:

Support​

If you face any trouble following the tutorial, feel free to reach out to our community engineers in our Discord or Forum to get 24/7 developer support.