跳转到主要内容
GET
列出该 EOA 可兑换的藏品
每单可选择同一金库地区最多 50 张卡。使用所选卡牌的代币 ID,按收货地址查询运费。

请求

需要开发者密钥和钱包访问令牌

响应

错误码

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

授权

x-builder-api-key
string
header
必填

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

Authorization
string
header
必填

钱包访问令牌,用于实物兑换的 Bearer 身份验证。

查询参数

Maximum string length: 200
countryCode
string
Pattern: ^[A-Z]{2}$
sortBy
enum<string>
默认值:rixPriceInUsd

将 sortBy 设为 rixPriceInUsd,即可按 RIX 估值(FMV)排序。

可用选项:
createdAt,
rixPriceInUsd
sortOrder
enum<string>
默认值:desc
可用选项:
asc,
desc
page
integer
默认值:1
必填范围: x >= 1
limit
integer
默认值:50
必填范围: 1 <= x <= 50

响应

成功

collectibles
object[]
必填
total
integer
必填
page
integer
必填
hasMore
boolean
必填