查询 NFT - Avata 帮助文档-测试

根据查询条件，展示 Avata 平台内的 NFT 列表。
对于使用文昌链-天舟/文昌链-天和的用户，该接口可支持查询文昌链-天舟/文昌链-天和链上的所有 NFT 数据。

请求参数

Query 参数

offset

string

游标，默认为 0

可选

limit

string

可选

每页记录数，默认为 10，上限为 50

string

NFT ID

可选

name

string

可选

NFT 名称，支持模糊查询

class_id

string

NFT 类别 ID

可选

owner

string

NFT 持有者地址

可选

tx_hash

string

可选

创建 NFT 的 Tx Hash

status

string

可选

NFT 状态：active / burned，默认为 active

start_date

string

可选

NFT 创建日期范围 - 开始，yyyy-MM-dd（UTC 时间）

end_date

string

可选

NFT 创建日期范围 - 结束，yyyy-MM-dd（UTC 时间）

sort_by

string

可选

排序规则：DATE_ASC / DATE_DESC

Header 参数

Content-Type

string

必需

固定值：application/json

X-Api-Key

string

必需

项目 API Key，用于 API 访问鉴权

X-Timestamp

string

必需

时间戳，1970年1月1日0点0分0秒到现在的毫秒数

X-Signature

string

必需

API 签名，算法为SHA256(Params+Timestamp+ApiSecret)

返回响应

🟢200successful operation

application/json

Body

data

object

正确返回值

可选

offset

integer

游标

必需

limit

integer

每页记录数

必需

total_count

integer

总记录数

必需

nfts

array[object (empty object) {10}]

NFT 列表

可选

示例

{
  "data": {
    "offset": 0,
    "limit": 0,
    "total_count": 0,
    "nfts": [
      {
        "id": "string",
        "name": "string",
        "class_id": "string",
        "class_name": "string",
        "class_symbol": "string",
        "uri": "string",
        "owner": "string",
        "status": "string",
        "tx_hash": "string",
        "timestamp": "string"
      }
    ]
  }
}

🟠400failed operation