获取 TRC721 库存信息
1. 概述与典型用途
返回指定 TRC721 合约下的代币库存列表，包括每个 tokenId 的持有者地址、名称、描述和图片信息。
- 典型用途：TRC721 NFT 集合浏览、库存展示、NFT 持有者查询。
- 何时不要用：查询 TRC721 的转账记录用「获取 TRC721 tokenId 转账列表」；查询 TRC1155 库存用「获取 TRC1155 库存信息」。
contract为必填参数。total上限 10000，rangeTotal反映真实总数。
2. 接口与鉴权
GET /api/trc721/token
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
contract | string | 是 | — | TRC721 合约地址 |
tokenId | string | 否 | — | TRC721 中代币的 ID |
start | integer | 否 | 0 | 起始编号；start + limit ≤ 10000 |
limit | integer | 否 | 20 | 每页数量，最大 50 |
ownerAddress | string | 否 | — | TRC721 代币持有者地址 |
sort | string | 否 | — | 排序：tokenId（升序）、-tokenId（降序） |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
total | integer | 必返 | 命中总数，上限 10000 | — |
rangeTotal | integer | 必返 | 真实总数 | — |
page_size | integer | 必返 | 当前页实际数量 | — |
code | integer | 必返 | 响应状态码，200 = 成功 | — |
data | array | 必返 | 库存记录数组，见下 | — |
contractMap | object | 可选 | 地址 → 是否为合约的映射 | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
token_id | string | 必返 | 代币 ID | — |
owner_address | string | 必返 | 持有者地址 | — |
owner_address_tag | string | 可选 | 持有者地址标签 | — |
owner_address_tag_logo | string | 可选 | 持有者地址标签 Logo URL | — |
token_name | string | 可选 | 代币名称 | — |
token_description | string | 可选 | 代币描述 | — |
token_image | string | 可选 | 代币图片 URL（外部链接） | — |
token_url | string | 可选 | 代币元数据 URL | — |
token_imageInnerUrl | string | 可选 | 代币图片 URL（站内缓存） | — |
token_level | string | 可选 | 代币等级，使用 tokenId 或 ownerAddress 查询时返回：0（UNKNOWN，未知）、1（NEUTRAL，中性）、2（OK，正常）、3（SUSPICIOUS，可疑）、4（UNSAFE，不安全） | — |
latest_transfer_timestamp | integer | 必返 | 最近一次转账时间 | 毫秒 ms |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
contract必填：缺少时返回参数缺失错误。- 空结果 ≠ 错误：无匹配记录时返回
200+data: []，属于正常响应。
最后更新于: