Get NFT trades by token

GEThttps://deep-index.moralis.io/api/v2.2/nft/:address/:token_id/trades

Get trades of NFTs for a given contract and token ID.

PATH PARAMS

addressstringrequired

The address of the NFT contract

token_idstringrequired

The token ID of the NFT contract

QUERY PARAMS

chainstring

The chain to query

eth0x1polygon0x89bsc0x38avalanche0xa86aarbitrum0xa4b1base0x2105optimism0xa

from_blocknumber

The minimum block number from which 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.

to_blockstring

The block number to get the trades from

from_datestring

The start date from which 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_datestring

The end date from which to get the transfers (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.

cursorstring

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

limitnumber

The desired page size of the result.

nft_metadataboolean

Should NFT metadata be included in the result?

falsetrue

Responses

API KEY

Node.js

import Moralis from 'moralis';

try {
  await Moralis.start({
    apiKey: "YOUR_API_KEY"
  });

  const response = await Moralis.EvmApi.nft.getNFTTradesByToken({
    "chain": "0x1",
    "nftMetadata": true,
    "address": "0x524cab2ec69124574082676e6f654a18df49a048",
    "tokenId": "123"
  });

  console.log(response.raw);
} catch (e) {
  console.error(e);
}

Python

from moralis import evm_api

api_key = "YOUR_API_KEY"

params = {
  "chain": "eth",
  "nft_metadata": True,
  "address": "0x524cab2ec69124574082676e6f654a18df49a048",
  "token_id": "123"
}

result = evm_api.nft.get_nft_trades_by_token(
  api_key=api_key,
  params=params,
)

print(result)

cURL

curl --request GET \
     --url 'https://deep-index.moralis.io/api/v2.2/nft/0x524cab2ec69124574082676e6f654a18df49a048/123/trades?chain=eth&nft_metadata=true' \
     --header 'accept: application/json' \
     --header 'X-API-Key: YOUR_API_KEY' 

Go

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://deep-index.moralis.io/api/v2.2/nft/0x524cab2ec69124574082676e6f654a18df49a048/123/trades?chain=eth&nft_metadata=true"

  req, _ := http.NewRequest("GET", url, payload)

  req.Header.Add("Accept", "application/json")
  req.Header.Add("X-API-Key", "YOUR_API_KEY")

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

PHP

<?php
// Dependencies to install:
// $ composer require guzzlehttp/guzzle

require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://deep-index.moralis.io/api/v2.2/nft/0x524cab2ec69124574082676e6f654a18df49a048/123/trades?chain=eth&nft_metadata=true', [
  'headers' => [
    'Accept' => 'application/json',
    'X-API-Key' => 'YOUR_API_KEY',
  ],
]);

echo $response->getBody();

Response Example

200 Returns a paginated collection of NFT transactions

{
  "page": 2,
  "page_size": 100,
  "cursor": "string",
  "result": [
    {
      "transaction_hash": "0x057Ec652A4F150f7FF94f089A38008f49a0DF88e",
      "transaction_index": "string",
      "token_ids": [
        "15"
      ],
      "seller_address": "0x057Ec652A4F150f7FF94f089A38008f49a0DF88e",
      "buyer_address": "0x057Ec652A4F150f7FF94f089A38008f49a0DF88e",
      "token_address": "0x4ad3785ec7eed7589fa86538244a4530f962434f",
      "marketplace_address": "0x057Ec652A4F150f7FF94f089A38008f49a0DF88e",
      "price_token_address": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
      "price": "1000000000000000",
      "block_timestamp": "2021-06-04T16:00:15",
      "block_number": "13680123",
      "block_hash": "0x4a7c916ca4a970358b9df90051008f729685ff05e9724a9dddba32630c37cb96"
    }
  ]
}