Search for NFTs by metadata attributes

POST 
/ronin/nfts/metadata/search

Search for NFTs that match the specified metadata attributes.

Request

application/json

Body

required

Request body

contractAddress stringrequired

Required

includes string[]

Optional

metadata

object

required

attributes

object[]

required

Possible values: >= 1

Required

Array [

traitType stringrequired

Required, doesn't support null traitType searches.

value stringrequired

Required, doesn't support null value searches.

]

paging

object

Only offset or cursor need to be present.

cursor string

limit integer

Possible values: <= 200

offset integer

Possible values: <= 10000

pagingStyle string

Possible values: [cursor, offset]

If pagingStyle is not cursor, then it's offset.

Responses

200

OK

application/json

Schema

Schema

items

object[]

Array [

contractAddress string

createdAtBlock integer

createdAtBlockTime string

ownerAddresses string[]

rawMetadata object

tokenId string

tokenName string

tokenStandard string

tokenSymbol string

tokenURI string

updatedAtBlock integer

updatedAtBlockTime string

]

paging

object

nextCursor string

total integer

Example (from schema)

{
  "items": [
    {
      "contractAddress": "string",
      "createdAtBlock": 0,
      "createdAtBlockTime": "string",
      "ownerAddresses": [
        "string"
      ],
      "rawMetadata": {},
      "tokenId": "string",
      "tokenName": "string",
      "tokenStandard": "string",
      "tokenSymbol": "string",
      "tokenURI": "string",
      "updatedAtBlock": 0,
      "updatedAtBlockTime": "string"
    }
  ],
  "paging": {
    "nextCursor": "string",
    "total": 0
  }
}

400

Invalid parameter

application/json

Schema

Schema

errorCode integer
message string

Example (from schema)

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

500

Internal server error

application/json

Schema

Schema

errorCode integer
message string

Example (from schema)

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

Loading...