Get a list of NFTsAPI-v2get_nft_list

Returns a list of the NFTs owned by the user, shown in descending order of the block_number value (the block height when the amount or owner changed). If the request is for NFTs on more than one chain, this means that the order may not be chronological. In the case of ERC1155 tokens, the block_number will update when additional NFTs are received or when all NFTs are withdrawn, but will generally remain the same if only some NFTs are withdrawn.

Request Parameters

Parameter	Type	Description
chains	array	List of networks to scan for NFTs. Options are: `POLYGON`, `FANTOM`, `ETH`, `BSC`, or `AVALANCHE`.
max	boolean	Optional, defaults to `false`. If `true`, response will return all NFTs without pagination, and will ignore the `limit` and `page_number` values.
limit	integer	Optional, defaults to `10`. The number of NFTs 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 NftFilter object.

Response Parameters

Parameter	Type	Description
nfts	list of objects	A list of standard NftInfo objects.
skipped	integer	The number of NFTs in your wallet excluded by the request filters.
total	integer	The total number of NFTs in your wallet matching the request filters.

📌 Example with no optional params

POST Get a list of NFTs get_nft_list

{
  "userpass": "RPC_UserP@SSW0RD",
  "method": "get_nft_list",
  "mmrpc": "2.0",
  "params": {
    "chains": [
      "BSC",
      "POLYGON"
    ]
  }
}

curl --url "http://127.0.0.1:7783" --data '{
  "userpass": "RPC_UserP@SSW0RD",
  "method": "get_nft_list",
  "mmrpc": "2.0",
  "params": {
    "chains": [
      "BSC",
      "POLYGON"
    ]
  }
}'

import requests
import json

url = "http://127.0.0.1:7783"
payload = {
  "userpass": "RPC_UserP@SSW0RD",
  "method": "get_nft_list",
  "mmrpc": "2.0",
  "params": {
    "chains": [
      "BSC",
      "POLYGON"
    ]
  }
}

response = requests.post(url, json=payload)
print(json.dumps(response.json(), indent=2))

const payload = {
  "userpass": "RPC_UserP@SSW0RD",
  "method": "get_nft_list",
  "mmrpc": "2.0",
  "params": {
    "chains": [
      "BSC",
      "POLYGON"
    ]
  }
};

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_list",
  "mmrpc": "2.0",
  "params": {
    "chains": [
      "BSC",
      "POLYGON"
    ]
  }
}
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_list","mmrpc":"2.0","params":{"chains":["BSC","POLYGON"]}}`)

	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_list",
  "mmrpc": "2.0",
  "params": {
    "chains": [
      "BSC",
      "POLYGON"
    ]
  }
}

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": {
    "nfts": [
      {
        "chain": "BSC",
        "token_address": "0x5c7d6712dfaf0cb079d48981781c8705e8417ca0",
        "token_id": "0",
        "amount": "1",
        "owner_of": "0xf622a6c52c94b500542e2ae6bcad24c53bc5b6a2",
        "token_hash": "b34ddf294013d20a6d70691027625839",
        "block_number_minted": 25465916,
        "block_number": 25919780,
        "contract_type": "ERC1155",
        "name": null,
        "symbol": null,
        "token_uri": "https://tikimetadata.s3.amazonaws.com/tiki_box.json",
        "token_domain": "tikimetadata.s3.amazonaws.com",
        "metadata": "{\"name\":\"Tiki box\",\"description\":\"Born to usher in Bull markets. Tiki JumpStarters are crazed guardians that worship NGU technology. Tiki guardians attach themselves to their owners to guide and protect them from the evils of the crypto industry. Manifested by the power of community and infused with unlimited creativity, the Unlockable Road Map summons powerful gifts and surprises to all Tiki Holders. Booyaaah!!\",\"external_url\":\"\",\"image\":\"https://tikimetadata.s3.amazonaws.com/tiki_box.png\",\"attributes\":[{\"trait_type\":\"Crypto Logo\",\"value\":\"TIKI NFT CRYPTOLOGO SCAR\"}],\"properties\":{\"category\":\"image\",\"creators\":[]}}",
        "last_token_uri_sync": "2023-02-07T17:10:08.402Z",
        "last_metadata_sync": "2023-02-07T17:10:16.858Z",
        "minter_address": "ERC1155 tokens don't have a single minter",
        "possible_spam": false,
        "possible_phishing": false,
        "uri_meta": {
          "image": "https://tikimetadata.s3.amazonaws.com/tiki_box.png",
          "image_url": "https://tikimetadata.s3.amazonaws.com/tiki_box.png",
          "image_domain": "tikimetadata.s3.amazonaws.com",
          "name": "Tiki box",
          "description": "Born to usher in Bull markets. Tiki JumpStarters are crazed guardians that worship NGU technology. Tiki guardians attach themselves to their owners to guide and protect them from the evils of the crypto industry. Manifested by the power of community and infused with unlimited creativity, the Unlockable Road Map summons powerful gifts and surprises to all Tiki Holders. Booyaaah!!",
          "attributes": [
            {
              "trait_type": "Crypto Logo",
              "value": "TIKI NFT CRYPTOLOGO SCAR"
            }
          ],
          "animation_url": null,
          "animation_domain": null,
          "external_url": "",
          "external_domain": null,
          "image_details": null
        }
      },
      {
        "chain": "POLYGON",
        "token_address": "0x48c75fbf0452fa8ff2928ddf46b0fe7629cca2ff",
        "token_id": "5",
        "amount": "1",
        "owner_of": "0xf622a6c52c94b500542e2ae6bcad24c53bc5b6a2",
        "token_hash": "28f970585fd743b056859a6e41f50a8e",
        "block_number_minted": 36781490,
        "block_number": 42491885,
        "contract_type": "ERC1155",
        "name": null,
        "symbol": null,
        "token_uri": "https://app.thesmurfssociety.com/metadata/public/metadata/cauldron/5",
        "token_domain": "app.thesmurfssociety.com",
        "metadata": "{\"name\":\"Forest Mushrooms\",\"description\":\"Sweet and nutty with distinct earthy tones, these forest mushrooms will make a fine addition to all your soups, salads, and potions.\",\"image\":\"https://metadata.thesmurfssociety.com/ingredients/nft/5.Forest_Mushrooms.jpg\",\"animation_url\":null,\"external_url\":\"https://app.thesmurfssociety.com/detail/ingredients/5\",\"attributes\":[{\"trait_type\":\"Type\",\"value\":\"Ingredient\"},{\"trait_type\":\"Category\",\"value\":\"COMMON\"}]}",
        "last_token_uri_sync": "2022-12-13T13:12:50.840Z",
        "last_metadata_sync": "2023-05-15T07:30:04.882Z",
        "minter_address": "ERC1155 tokens don't have a single minter",
        "possible_spam": false,
        "possible_phishing": false,
        "uri_meta": {
          "image": "https://metadata.thesmurfssociety.com/ingredients/nft/5.Forest_Mushrooms.jpg",
          "image_url": "https://metadata.thesmurfssociety.com/ingredients/nft/5.Forest_Mushrooms.jpg",
          "image_domain": "metadata.thesmurfssociety.com",
          "name": "Forest Mushrooms",
          "description": "Sweet and nutty with distinct earthy tones, these forest mushrooms will make a fine addition to all your soups, salads, and potions.",
          "attributes": [
            {
              "trait_type": "Type",
              "value": "Ingredient"
            },
            {
              "trait_type": "Category",
              "value": "COMMON"
            }
          ],
          "animation_url": null,
          "animation_domain": null,
          "external_url": "https://app.thesmurfssociety.com/detail/ingredients/5",
          "external_domain": "app.thesmurfssociety.com",
          "image_details": null
        }
      }
    ],
    "skipped": 0,
    "total": 2
  },
  "id": null
}

📌 Example with optional limit & page_number params

POST Get a list of NFTs get_nft_list

{
  "userpass": "RPC_UserP@SSW0RD",
  "method": "get_nft_list",
  "mmrpc": "2.0",
  "params": {
    "chains": [
      "BSC",
      "POLYGON"
    ],
    "limit": 1,
    "page_number": 2
  }
}

curl --url "http://127.0.0.1:7783" --data '{
  "userpass": "RPC_UserP@SSW0RD",
  "method": "get_nft_list",
  "mmrpc": "2.0",
  "params": {
    "chains": [
      "BSC",
      "POLYGON"
    ],
    "limit": 1,
    "page_number": 2
  }
}'

import requests
import json

url = "http://127.0.0.1:7783"
payload = {
  "userpass": "RPC_UserP@SSW0RD",
  "method": "get_nft_list",
  "mmrpc": "2.0",
  "params": {
    "chains": [
      "BSC",
      "POLYGON"
    ],
    "limit": 1,
    "page_number": 2
  }
}

response = requests.post(url, json=payload)
print(json.dumps(response.json(), indent=2))

const payload = {
  "userpass": "RPC_UserP@SSW0RD",
  "method": "get_nft_list",
  "mmrpc": "2.0",
  "params": {
    "chains": [
      "BSC",
      "POLYGON"
    ],
    "limit": 1,
    "page_number": 2
  }
};

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_list",
  "mmrpc": "2.0",
  "params": {
    "chains": [
      "BSC",
      "POLYGON"
    ],
    "limit": 1,
    "page_number": 2
  }
}
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_list","mmrpc":"2.0","params":{"chains":["BSC","POLYGON"],"limit":1,"page_number":2}}`)

	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_list",
  "mmrpc": "2.0",
  "params": {
    "chains": [
      "BSC",
      "POLYGON"
    ],
    "limit": 1,
    "page_number": 2
  }
}

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": {
    "nfts": [
      {
        "chain": "POLYGON",
        "token_address": "0x48c75fbf0452fa8ff2928ddf46b0fe7629cca2ff",
        "token_id": "5",
        "amount": "1",
        "owner_of": "0xf622a6c52c94b500542e2ae6bcad24c53bc5b6a2",
        "token_hash": "28f970585fd743b056859a6e41f50a8e",
        "block_number_minted": 36781490,
        "block_number": 42491885,
        "contract_type": "ERC1155",
        "name": null,
        "symbol": null,
        "token_uri": "https://app.thesmurfssociety.com/metadata/public/metadata/cauldron/5",
        "token_domain": "app.thesmurfssociety.com",
        "metadata": "{\"name\":\"Forest Mushrooms\",\"description\":\"Sweet and nutty with distinct earthy tones, these forest mushrooms will make a fine addition to all your soups, salads, and potions.\",\"image\":\"https://metadata.thesmurfssociety.com/ingredients/nft/5.Forest_Mushrooms.jpg\",\"animation_url\":null,\"external_url\":\"https://app.thesmurfssociety.com/detail/ingredients/5\",\"attributes\":[{\"trait_type\":\"Type\",\"value\":\"Ingredient\"},{\"trait_type\":\"Category\",\"value\":\"COMMON\"}]}",
        "last_token_uri_sync": "2022-12-13T13:12:50.840Z",
        "last_metadata_sync": "2023-05-15T07:30:04.882Z",
        "minter_address": "ERC1155 tokens don't have a single minter",
        "possible_spam": false,
        "possible_phishing": false,
        "uri_meta": {
          "image": "https://metadata.thesmurfssociety.com/ingredients/nft/5.Forest_Mushrooms.jpg",
          "image_url": "https://metadata.thesmurfssociety.com/ingredients/nft/5.Forest_Mushrooms.jpg",
          "image_domain": "metadata.thesmurfssociety.com",
          "name": "Forest Mushrooms",
          "description": "Sweet and nutty with distinct earthy tones, these forest mushrooms will make a fine addition to all your soups, salads, and potions.",
          "attributes": [
            {
              "trait_type": "Type",
              "value": "Ingredient"
            },
            {
              "trait_type": "Category",
              "value": "COMMON"
            }
          ],
          "animation_url": null,
          "animation_domain": null,
          "external_url": "https://app.thesmurfssociety.com/detail/ingredients/5",
          "external_domain": "app.thesmurfssociety.com",
          "image_details": null
        }
      }
    ],
    "skipped": 1,
    "total": 1
  },
  "id": null
}

📌 Example with optional spam protection

POST Get a list of NFTs get_nft_list

{
  "userpass": "RPC_UserP@SSW0RD",
  "method": "get_nft_list",
  "mmrpc": "2.0",
  "params": {
    "chains": [
      "BSC",
      "POLYGON"
    ],
    "protect_from_spam": true,
    "filters": {
      "exclude_spam": true,
      "exclude_phishing": true
    }
  }
}

curl --url "http://127.0.0.1:7783" --data '{
  "userpass": "RPC_UserP@SSW0RD",
  "method": "get_nft_list",
  "mmrpc": "2.0",
  "params": {
    "chains": [
      "BSC",
      "POLYGON"
    ],
    "protect_from_spam": true,
    "filters": {
      "exclude_spam": true,
      "exclude_phishing": true
    }
  }
}'

import requests
import json

url = "http://127.0.0.1:7783"
payload = {
  "userpass": "RPC_UserP@SSW0RD",
  "method": "get_nft_list",
  "mmrpc": "2.0",
  "params": {
    "chains": [
      "BSC",
      "POLYGON"
    ],
    "protect_from_spam": true,
    "filters": {
      "exclude_spam": true,
      "exclude_phishing": true
    }
  }
}

response = requests.post(url, json=payload)
print(json.dumps(response.json(), indent=2))

const payload = {
  "userpass": "RPC_UserP@SSW0RD",
  "method": "get_nft_list",
  "mmrpc": "2.0",
  "params": {
    "chains": [
      "BSC",
      "POLYGON"
    ],
    "protect_from_spam": true,
    "filters": {
      "exclude_spam": true,
      "exclude_phishing": 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_list",
  "mmrpc": "2.0",
  "params": {
    "chains": [
      "BSC",
      "POLYGON"
    ],
    "protect_from_spam": true,
    "filters": {
      "exclude_spam": true,
      "exclude_phishing": 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_list","mmrpc":"2.0","params":{"chains":["BSC","POLYGON"],"protect_from_spam":true,"filters":{"exclude_spam":true,"exclude_phishing":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_list",
  "mmrpc": "2.0",
  "params": {
    "chains": [
      "BSC",
      "POLYGON"
    ],
    "protect_from_spam": true,
    "filters": {
      "exclude_spam": true,
      "exclude_phishing": 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": {
    "nfts": [
      {
        "chain": "POLYGON",
        "token_address": "0x48c75fbf0452fa8ff2928ddf46b0fe7629cca2ff",
        "token_id": "5",
        "amount": "1",
        "owner_of": "0xf622a6c52c94b500542e2ae6bcad24c53bc5b6a2",
        "token_hash": "28f970585fd743b056859a6e41f50a8e",
        "block_number_minted": 36781490,
        "block_number": 42491885,
        "contract_type": "ERC1155",
        "name": null,
        "symbol": null,
        "token_uri": "https://app.thesmurfssociety.com/metadata/public/metadata/cauldron/5",
        "token_domain": "app.thesmurfssociety.com",
        "metadata": "{\"name\":\"Forest Mushrooms\",\"description\":\"Sweet and nutty with distinct earthy tones, these forest mushrooms will make a fine addition to all your soups, salads, and potions.\",\"image\":\"https://metadata.thesmurfssociety.com/ingredients/nft/5.Forest_Mushrooms.jpg\",\"animation_url\":null,\"external_url\":\"https://app.thesmurfssociety.com/detail/ingredients/5\",\"attributes\":[{\"trait_type\":\"Type\",\"value\":\"Ingredient\"},{\"trait_type\":\"Category\",\"value\":\"COMMON\"}]}",
        "last_token_uri_sync": "2022-12-13T13:12:50.840Z",
        "last_metadata_sync": "2023-05-15T07:30:04.882Z",
        "minter_address": "ERC1155 tokens don't have a single minter",
        "possible_spam": false,
        "possible_phishing": false,
        "uri_meta": {
          "image": "https://metadata.thesmurfssociety.com/ingredients/nft/5.Forest_Mushrooms.jpg",
          "image_url": "https://metadata.thesmurfssociety.com/ingredients/nft/5.Forest_Mushrooms.jpg",
          "image_domain": "metadata.thesmurfssociety.com",
          "name": "Forest Mushrooms",
          "description": "Sweet and nutty with distinct earthy tones, these forest mushrooms will make a fine addition to all your soups, salads, and potions.",
          "attributes": [
            {
              "trait_type": "Type",
              "value": "Ingredient"
            },
            {
              "trait_type": "Category",
              "value": "COMMON"
            }
          ],
          "animation_url": null,
          "animation_domain": null,
          "external_url": "https://app.thesmurfssociety.com/detail/ingredients/5",
          "external_domain": "app.thesmurfssociety.com",
          "image_details": null
        }
      }
    ],
    "skipped": 0,
    "total": 1
  },
  "id": null
}

📌 Error responses

Unsupported Chain Type

The supported chains are

{
  "mmrpc":"2.0",
  "error":"Error parsing request: UnsupportedChainType",
  "error_path":"dispatcher",
  "error_trace":"dispatcher:109]",
  "error_type":"InvalidRequest",
  "error_data":"UnsupportedChainType",
  "id":null
}

Get a list of NFTsAPI-v2get_nft_list#

Request Parameters#

Response Parameters#

📌 Example with no optional params#

📌 Example with optional limit & page_number params#

📌 Example with optional spam protection#

📌 Error responses#

Unsupported Chain Type#

Get a list of NFTsAPI-v2get_nft_list

Request Parameters

Response Parameters

📌 Example with no optional params

📌 Example with optional limit & page_number params

📌 Example with optional spam protection

📌 Error responses

Unsupported Chain Type