获取 TRC1155 tokenId 持仓信息
1. 概述与典型用途
返回 TRC1155 合约中某个 tokenId 的持有者列表及每个持有者的持仓详情。
- 典型用途：查询某个 TRC1155 NFT 的持有者分布、持仓量排行。
- 何时不要用：查询 TRC1155 合约的所有 tokenId 库存用「获取 TRC1155 库存信息」。
contract和tokenId均为必填参数。limit最大值为 50；start + limit≤ 10000。
2. 接口与鉴权
GET /api/trc1155/token/inventory
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
contract | string | 是 | — | TRC1155 合约地址 |
tokenId | string | 是 | — | TRC1155 中代币的 ID |
start | integer | 否 | 0 | 起始编号；start + limit ≤ 10000 |
limit | integer | 否 | 20 | 每页数量，最大 50 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
total | integer | 必返 | 持有者总数 | — |
rangeTotal | integer | 必返 | 过滤范围内总数 | — |
page_size | integer | 必返 | 当前页实际数量 | — |
code | integer | 必返 | 响应状态码，200 = 成功 | — |
data | array | 必返 | 持仓记录数组，见下 | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
token_id | string | 必返 | 代币 ID | — |
holder_count | string | 必返 | 该地址持有的数量 | — |
owner_address | string | 必返 | 持有者地址 | — |
token_name | string | 必返 | 代币名称 | — |
token_description | string | 可选 | 代币描述 | — |
token_image | string | 可选 | 代币图片 URL（外部链接） | — |
token_imageInnerUrl | string | 可选 | 代币图片 URL（站内缓存） | — |
token_url | string | 可选 | 代币元数据 URL | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
contract和tokenId均必填：缺少任一参数时返回参数缺失错误。- 空结果 ≠ 错误：无匹配记录时返回
200+data: []，属于正常响应。
最后更新于: