跳转到主要内容
GET
列出钱包藏品
抽卡详情。 仅当该钱包通过你的应用抽中这张卡,且仍是当前抽卡记录时,才会返回 pull 详情。其余已持有的卡牌返回 pull: null。卖出、回售、转出或兑换后,卡牌会移出收藏。若合约钱包最终无法接收交付,该卡会从列表和统计中移除,也不会退款或生成交付失败动态。分页。 接口先按 tokenIds 筛选,再排序、分页并计算 pagination.total。钱包摘要始终统计完整收藏。签名地址和 Safe 钱包需要分别查询。Renaiss 托管钱包的列表为空。

请求

需要开发者密钥

响应

错误码

在下表中查找接口返回的 HTTP 状态码和响应原文。有关各接口通用的处理建议,请参阅错误码含义与处理方式。

授权

x-builder-api-key
string
header
必填

已获准使用的开发者 API 密钥,仅在后端保存。抽卡和市场的写入操作还需钱包签名,实物兑换还需钱包签署登录消息后由 API 签发的 Bearer 令牌。

路径参数

walletAddress
string
必填

只查询传入的这个钱包地址。

查询参数

sortBy
enum<string>
默认值:pulledAt

pulledAt 表示钱包在当前开发者处抽到藏品的时间;rixPriceInUsd 为藏品的 RIX 估值(FMV);buybackExpiresAt 取 state.buybackTiers 中第一个未过期档位的 expiresAt,之后可能还有其他档位。正序或倒序均把缺少相应值的藏品排在末尾。

可用选项:
pulledAt,
rixPriceInUsd,
buybackExpiresAt
sortOrder
enum<string>
默认值:desc
可用选项:
asc,
desc
limit
integer
默认值:20
必填范围: 1 <= x <= 100
offset
integer | null
默认值:0
必填范围: 0 <= x <= 10000
tokenIds
string[]

最多 20 个十进制代币 ID。可用逗号分隔(?tokenIds=1,2)或重复传参。去除首尾空格、空值及重复字符串后检查数量。省略或为空表示不筛选。先筛选再排序和分页,pagination.total 为筛选后的总数。不属于列表的 ID 不返回结果。

Pattern: ^\d+$

响应

成功

collectibles
object[]
必填
pagination
object
必填