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
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 integer[]
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": [
        0
      ],
      "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...