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