Get a list of NFT transfers
Returns a list of the NFT transfers involving the user, shown in descending order of the block_timestamp value of the NFT’s last transfer.
Request Parameters
| Parameter | Type | Description |
|---|---|---|
| chains | array | List of chains to scan for NFTs. |
| max | boolean | Optional, defaults to false. If true, response will return all NFT transfers without pagination, and will ignore the limit and page_number values. |
| limit | integer | Optional, defaults to 10. The number of NFT transfers displayed per page in response. |
| page_number | integer | Optional, defaults to 1. The page offset for items in response. |
| protect_from_spam | boolean | Optional, defaults to false. If true, any potential spam link found in collection name, token name, symbol will be replaced with URL redacted for user protection |
| filters | object | Optional. A standard NftTransferFilter object. |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| transfer_history | list of objects | A list of standard NftTransfer objects. |
| total | integer | The total number of NFT transfers in your wallet matching the request filters. |
| skipped | integer | The number of NFT transfers in your wallet excluded by the request filters. |
📌 Example with date and send filters
POST Get a list of NFT transfers
get_nft_transfers {
"userpass": "RPC_UserP@SSW0RD",
"method": "get_nft_transfers",
"mmrpc": "2.0",
"params": {
"chains": [
"POLYGON"
],
"max": true,
"filters": {
"receive": true,
"from_date": 1678233600
},
"protect_from_spam": true
}
}curl --url "http://127.0.0.1:7783" --data '{
"userpass": "RPC_UserP@SSW0RD",
"method": "get_nft_transfers",
"mmrpc": "2.0",
"params": {
"chains": [
"POLYGON"
],
"max": true,
"filters": {
"receive": true,
"from_date": 1678233600
},
"protect_from_spam": true
}
}'import requests
import json
url = "http://127.0.0.1:7783"
payload = {
"userpass": "RPC_UserP@SSW0RD",
"method": "get_nft_transfers",
"mmrpc": "2.0",
"params": {
"chains": [
"POLYGON"
],
"max": true,
"filters": {
"receive": true,
"from_date": 1678233600
},
"protect_from_spam": true
}
}
response = requests.post(url, json=payload)
print(json.dumps(response.json(), indent=2))const payload = {
"userpass": "RPC_UserP@SSW0RD",
"method": "get_nft_transfers",
"mmrpc": "2.0",
"params": {
"chains": [
"POLYGON"
],
"max": true,
"filters": {
"receive": true,
"from_date": 1678233600
},
"protect_from_spam": true
}
};
const response = await fetch("http://127.0.0.1:7783", {
method: "POST",
body: JSON.stringify(payload),
});
console.log(await response.json());<?php
$payload = <<<'JSON'
{
"userpass": "RPC_UserP@SSW0RD",
"method": "get_nft_transfers",
"mmrpc": "2.0",
"params": {
"chains": [
"POLYGON"
],
"max": true,
"filters": {
"receive": true,
"from_date": 1678233600
},
"protect_from_spam": true
}
}
JSON;
$ch = curl_init("http://127.0.0.1:7783");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
$response = curl_exec($ch);
curl_close($ch);
echo $response;package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
payload := []byte(`{"userpass":"RPC_UserP@SSW0RD","method":"get_nft_transfers","mmrpc":"2.0","params":{"chains":["POLYGON"],"max":true,"filters":{"receive":true,"from_date":1678233600},"protect_from_spam":true}}`)
resp, err := http.Post("http://127.0.0.1:7783", "application/json", bytes.NewBuffer(payload))
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require 'net/http'
require 'json'
require 'uri'
uri = URI("http://127.0.0.1:7783")
payload = {
"userpass": "RPC_UserP@SSW0RD",
"method": "get_nft_transfers",
"mmrpc": "2.0",
"params": {
"chains": [
"POLYGON"
],
"max": true,
"filters": {
"receive": true,
"from_date": 1678233600
},
"protect_from_spam": true
}
}
response = Net::HTTP.post(uri, payload.to_json, 'Content-Type' => 'application/json')
puts JSON.pretty_generate(JSON.parse(response.body))Show Response
{
"mmrpc": "2.0",
"result": {
"transfer_history": [
{
"block_hash": "0xfd012e9dc2c7fa652ae3c0923599a9e6196520ac46e55f0f467d3a1ce84b8580",
"transaction_hash": "0x4063c4ae3e56a06b6c8768ad76e0cb1523e671cf06e4325517106497778ede9e",
"transaction_index": 87,
"log_index": 468,
"value": "0",
"transaction_type": "Single",
"token_address": "0x48c75fbf0452fa8ff2928ddf46b0fe7629cca2ff",
"from_address": "0xf622a6c52c94b500542e2ae6bcad24c53bc5b6a2",
"to_address": "0xf622a6c52c94b500542e2ae6bcad24c53bc5b6a2",
"amount": "2",
"verified": 1,
"operator": "0xf622a6c52c94b500542e2ae6bcad24c53bc5b6a2",
"possible_spam": false,
"chain": "POLYGON",
"token_id": "5",
"block_number": 44506464,
"block_timestamp": 1688107346,
"contract_type": "ERC1155",
"token_uri": "https://app.thesmurfssociety.com/metadata/public/metadata/cauldron/5",
"token_domain": "app.thesmurfssociety.com",
"collection_name": null,
"image_url": "https://metadata.thesmurfssociety.com/ingredients/nft/5.Forest_Mushrooms.jpg",
"image_domain": "metadata.thesmurfssociety.com",
"token_name": "Forest Mushrooms",
"status": "Receive",
"possible_phishing": false,
"fee_details": {
"coin": "MATIC",
"gas": 40249,
"gas_price": "0.000000153160317706",
"total_fee": "0.006164549627348794"
},
"confirmations": 5775855
}
],
"skipped": 0,
"total": 1
},
"id": null
}