Search NFTs

Get NFTs that match a given metadata search query.

Search NFTs

Get NFTs that match a given metadata search query.

get

/api/nfts/search

Query parameters

from_blockinteger · default: 0

The minimum block number from which to start the search

to_blockinteger · default: 0

The maximum block number from which to end the search

chainall ofrequired

The chain to query

An enumeration.

formatall of · default: decimal

The format of the token ID

An enumeration.

qstring · min: 3 · max: 256required

The search string

filterall of · default: name

What fields the search should match on. To look into the entire metadata set the value to "global". To have a better response time you can look into a specific field like name

An enumeration.

addressesstring[] · default:

The addresses to get metadata for

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/api/nfts/search?chain=eth&q=text'

200

404

422

200

{
  "status": "SYNCED",
  "total": 0,
  "page": 0,
  "page_size": 0,
  "cursor": "",
  "result": [
    {
      "token_address": "text",
      "name": "",
      "symbol": "",
      "contract_type": "text",
      "token_id": "",
      "amount": "",
      "token_hash": "",
      "owner_of": "",
      "block_number_minted": "text",
      "block_number": "text",
      "token_uri": "",
      "last_token_uri_sync": "",
      "last_metadata_sync": "",
      "minter_address": "",
      "metadata": ""
    }
  ]
}

Successful Response