Now available: NFT Transfers API


October 11, 2022


← Back

We are pleased to announce that asset transfer data is now available at Center.

The Get asset transfers of an asset endpoint allows users to retrieve the following information for all transfers:

  • Network
  • Collection address
  • Token ID
  • ‘From’ Address
  • ‘To’ Address
  • Block number

Queries can also be tailored to only return transfers to or from specific addresses.

Check out a few examples below, or the full documentation. What will you build?

Demo: View all transfers for BAYC #10

Request

curl "<https://api.center.dev/v1/ethereum-mainnet/transfers?collection=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D&tokenID=10>"

Response

{
  "items": [
    {
      "network": "ethereum-mainnet",
      "address": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
      "tokenId": "10",
      "from": "0x6B92686c40747C85809a6772D0eda8e22a77C60c",
      "to": "0xC883A79E8e4594C4f89434EDb754a10Da2311139",
      "blockNumber": 14124528,
      "logIndex": 95
    },
    {
      "network": "ethereum-mainnet",
      "address": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
      "tokenId": "10",
      "from": "0xD33BC4Ab17AD58626fa74A8286D610EA16E731d8",
      "to": "0x1d3a44F4ac3A7f603C58C0d8E4a4749Ea1757AF8",
      "blockNumber": 13978459,
      "logIndex": 210
    },
    {
      "network": "ethereum-mainnet",
      "address": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
      "tokenId": "10",
      "from": "0x1d3a44F4ac3A7f603C58C0d8E4a4749Ea1757AF8",
      "to": "0xD33BC4Ab17AD58626fa74A8286D610EA16E731d8",
      "blockNumber": 13746677,
      "logIndex": 249
    },
    {
      "network": "ethereum-mainnet",
      "address": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
      "tokenId": "10",
      "from": "0xD33BC4Ab17AD58626fa74A8286D610EA16E731d8",
      "to": "0x1d3a44F4ac3A7f603C58C0d8E4a4749Ea1757AF8",
      "blockNumber": 13740547,
      "logIndex": 253
    },
    {
      "network": "ethereum-mainnet",
      "address": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
      "tokenId": "10",
      "from": "0x1d3a44F4ac3A7f603C58C0d8E4a4749Ea1757AF8",
      "to": "0xD33BC4Ab17AD58626fa74A8286D610EA16E731d8",
      "blockNumber": 13695544,
      "logIndex": 389
    },
    {
      "network": "ethereum-mainnet",
      "address": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
      "tokenId": "10",
      "from": "0x893a3701952f0ee5782d9E8b7b08f375A7e1CFfB",
      "to": "0x1d3a44F4ac3A7f603C58C0d8E4a4749Ea1757AF8",
      "blockNumber": 13622499,
      "logIndex": 90
    },
    {
      "network": "ethereum-mainnet",
      "address": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
      "tokenId": "10",
      "from": "0x9eE5E3Ff06425CF972E77c195F70Ecb18aC23d7f",
      "to": "0x893a3701952f0ee5782d9E8b7b08f375A7e1CFfB",
      "blockNumber": 13622160,
      "logIndex": 62
    },
    {
      "network": "ethereum-mainnet",
      "address": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
      "tokenId": "10",
      "from": "0xb905576A1D9Bff3b7F3A69764913037ea18F01dA",
      "to": "0x9eE5E3Ff06425CF972E77c195F70Ecb18aC23d7f",
      "blockNumber": 13500209,
      "logIndex": 496
    },
    {
      "network": "ethereum-mainnet",
      "address": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
      "tokenId": "10",
      "from": "0xaBA7161A7fb69c88e16ED9f455CE62B791EE4D03",
      "to": "0xb905576A1D9Bff3b7F3A69764913037ea18F01dA",
      "blockNumber": 13225878,
      "logIndex": 252
    },
    {
      "network": "ethereum-mainnet",
      "address": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
      "tokenId": "10",
      "from": "0x0000000000000000000000000000000000000000",
      "to": "0xaBA7161A7fb69c88e16ED9f455CE62B791EE4D03",
      "blockNumber": 12292922,
      "logIndex": 95
    }
  ],
  "paging": {
    "offset": 0,
    "limit": 10,
    "onLastPage": true
  }
}

Demo: View all transfers for BAYC 10 from a specified address

Request

curl -XGET "<https://api.center.dev/v1/ethereum-mainnet/transfers?collection=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D&tokenID=10&fromAddress=0xD33BC4Ab17AD58626fa74A8286D610EA16E731d8>"

Response

{
  "items": [
    {
      "network": "ethereum-mainnet",
      "address": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
      "tokenId": "10",
      "from": "0xD33BC4Ab17AD58626fa74A8286D610EA16E731d8",
      "to": "0x1d3a44F4ac3A7f603C58C0d8E4a4749Ea1757AF8",
      "blockNumber": 13978459,
      "logIndex": 210
    },
    {
      "network": "ethereum-mainnet",
      "address": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
      "tokenId": "10",
      "from": "0xD33BC4Ab17AD58626fa74A8286D610EA16E731d8",
      "to": "0x1d3a44F4ac3A7f603C58C0d8E4a4749Ea1757AF8",
      "blockNumber": 13740547,
      "logIndex": 253
    }
  ],
  "paging": {
    "offset": 0,
    "limit": 10,
    "onLastPage": true
  }
}

Other requests or ideas? Please submit a feature request or reach out to our support team.