Skip to main content
GET
/
nft
/
{address}
/
transfers
Get NFT transfers by contract address
curl --request GET \
  --url https://deep-index.moralis.io/api/v2.2/nft/{address}/transfers \
  --header 'X-API-Key: <api-key>'
{
  "page": "2",
  "page_size": "100",
  "cursor": "<string>",
  "result": [
    {
      "token_address": "0x057Ec652A4F150f7FF94f089A38008f49a0DF88e",
      "token_id": "15",
      "contract_type": "ERC721",
      "block_number": "88256",
      "block_timestamp": "2021-06-04T16:00:15",
      "block_hash": "<string>",
      "transaction_hash": "0x057Ec652A4F150f7FF94f089A38008f49a0DF88e",
      "log_index": 123,
      "possible_spam": "false",
      "token_name": "Tether USD",
      "token_symbol": "USDT",
      "from_address_entity": "Opensea",
      "from_address_entity_logo": "https://opensea.io/favicon.ico",
      "from_address": "0x057Ec652A4F150f7FF94f089A38008f49a0DF88e",
      "from_address_label": "Binance 1",
      "to_address_entity": "Beaver Build",
      "to_address_entity_logo": "https://beaverbuild.com/favicon.ico",
      "to_address": "0x057Ec652A4F150f7FF94f089A38008f49a0DF88e",
      "to_address_label": "Binance 2",
      "value": "1000000000000000",
      "amount": "1",
      "transaction_type": "<string>",
      "transaction_index": 123,
      "operator": "0x057Ec652A4F150f7FF94f089A38008f49a0DF88e",
      "verified_collection": "false",
      "last_sale": {
        "transaction_hash": "0x19e14f34b8f120c980f7ba05338d64c00384857fb9c561e2c56d0f575424a95c",
        "block_timestamp": "2023-04-04T15:59:11.000Z",
        "buyer_address": "0xcb1c1fde09f811b294172696404e88e658659905",
        "seller_address": "0x497a7dee2f13db161eb2fec060fa783cb041419f",
        "price": "7300000000000000",
        "price_formatted": "0.0073",
        "payment_token": {
          "token_name": "Ether",
          "token_symbol": "ETH",
          "token_logo": "https://cdn.moralis.io/eth/0x.png",
          "token_decimals": "18",
          "token_address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"
        },
        "usd_price_at_sale": "13.61",
        "current_usd_value": "15.53",
        "token_address": "0xe8778996e096b39705c6a0a937eb587a1ebbda17",
        "token_id": "170"
      }
    }
  ],
  "block_exists": true,
  "index_complete": true
}
Endpoint cost: CUs. Learn more about compute units.

Authorizations

​
X-API-Key
string
header
default:test
required

Path Parameters

​
address
string
required

The address of the NFT contract

Example:

"0x306b1ea3ecdf94ab739f1910bbda052ed4a9f949"

Query Parameters

​
chain
enum<string>
default:eth

The chain to query

Available options:
eth,
0x1,
sepolia,
0xaa36a7,
polygon,
0x89,
bsc,
0x38,
bsc testnet,
0x61,
avalanche,
0xa86a,
fantom,
0xfa,
cronos,
0x19,
arbitrum,
0xa4b1,
chiliz,
0x15b38,
chiliz testnet,
0x15b32,
gnosis,
0x64,
gnosis testnet,
0x27d8,
base,
0x2105,
base sepolia,
0x14a34,
optimism,
0xa,
polygon amoy,
0x13882,
linea,
0xe708,
moonbeam,
0x504,
moonriver,
0x505,
moonbase,
0x507,
linea sepolia,
0xe705,
flow,
0x2eb,
flow-testnet,
0x221,
ronin,
0x7e4,
ronin-testnet,
0x7e5,
lisk,
0x46f,
lisk-sepolia,
0x106a,
pulse,
0x171,
sei-testnet,
0x530,
sei,
0x531,
monad,
0x8f
Example:

"eth"

​
from_block
integer

The minimum block number from where to get the transfers

  • Provide the param 'from_block' or 'from_date'
  • If 'from_date' and 'from_block' are provided, 'from_block' will be used.
Required range: x >= 0
​
to_block
integer

The maximum block number from where to get the transfers.

  • Provide the param 'to_block' or 'to_date'
  • If 'to_date' and 'to_block' are provided, 'to_block' will be used.
Required range: x >= 0
​
from_date
string

The date from where to get the transfers (format in seconds or datestring accepted by momentjs)

  • Provide the param 'from_block' or 'from_date'
  • If 'from_date' and 'from_block' are provided, 'from_block' will be used.
​
to_date
string

Get transfers up until this date (format in seconds or datestring accepted by momentjs)

  • Provide the param 'to_block' or 'to_date'
  • If 'to_date' and 'to_block' are provided, 'to_block' will be used.
​
format
enum<string>
default:decimal

The format of the token ID

Available options:
decimal,
hex
Example:

"decimal"

​
include_prices
boolean
default:false

Should NFT last sale prices be included in the result?

​
limit
integer

The desired page size of the result.

Required range: x >= 0
​
order
enum<string>
default:DESC

The order of the result, in ascending (ASC) or descending (DESC)

Available options:
ASC,
DESC
Example:

"DESC"

​
cursor
string

The cursor returned in the previous response (used for getting the next page).

Response

200 - application/json

Returns a collection of NFT transfers

​
page
integer
required

The current page of the result

Example:

"2"

​
page_size
integer
required

The number of results per page

Example:

"100"

​
cursor
string
required

The cursor to get to the next page

​
result
object[]
required
​
block_exists
boolean

Indicator if the block exists

Example:

true

​
index_complete
boolean

Indicator if the block is fully indexed

Example:

true