Search NFTs by metadata

API Deprecation Notice

This API endpoint will be deprecated by the end of Q1 2025 as part of Skynet sunsetting. Please migrate to the Moralis alternative: Get NFTs by Traits

POST 
/nfts/:contractAddress/metadata/search

Search NFTs by metadata

Request

Path Parameters

contractAddress stringrequired

ContractAddress address. Example: 0x32950db2a7164ae833121501c797d79e7b79d74c

Query Parameters

limit integer

Paging limit

cursor string

Paging cursor

application/json

Body

required

Request body

name string
traitsobject[]

Array [

trait string

values string,number,boolean,date[]

]

rangeTraits

object[]

Array [

trait string

from number

to number

]

Responses

200

OK

application/json

Schema

Schema

result

object

items

object[]

Array [

tokenId string

contractAddress string

name string

symbol string

standard string

tokenUri string

metadata object

]

paging

object

nextCursor string

Example (from schema)

{
  "result": {
    "items": [
      {
        "tokenId": "string",
        "contractAddress": "string",
        "name": "string",
        "symbol": "string",
        "standard": "string",
        "tokenUri": "string",
        "metadata": {}
      }
    ],
    "paging": {
      "nextCursor": "string"
    }
  }
}

500

internal error

application/json

Schema

Schema

errorCode integer
message string

Example (from schema)

{
  "errorCode": 0,
  "message": "string"
}

Loading...