> ## Documentation Index
> Fetch the complete documentation index at: https://docs.renaiss.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# 钱包收藏与活动

> 通过 Users API 读取钱包的藏品、估值和链上活动。

在后端使用 `x-builder-api-key` 调用 `/v2/users`。钱包地址是查询条件，无需钱包签名或钱包访问令牌。请查询实际持有卡牌的地址。签名人的地址和合约钱包的地址可能持有不同藏品。

| GET 路径 | 返回内容 |
| - | - |
| [`/v2/users/{walletAddress}`](https://docs.renaiss.xyz/cn/api-reference/wallets/get-collection-value) | 藏品数量、RIX 估值（FMV）总和（美分），以及暂无估值的卡牌数。 |
| [`/v2/users/{walletAddress}/collectibles`](https://docs.renaiss.xyz/cn/api-reference/wallets/list-collectibles) | 钱包在链上持有的卡牌，以及通过你的应用抽中且尚未交付的卡牌。 |
| [`/v2/users/{walletAddress}/activities`](https://docs.renaiss.xyz/cn/api-reference/wallets/list-activities) | 钱包的链上事件，按新到旧排列，包括符合条件的抽卡、回购、转账、交易和兑换。 |

## 展示钱包收藏

用 `limit` 和 `offset` 分页读取 `collectibles`。摘要与未筛选列表的统计范围一致。只要该钱包已在链上持有卡牌，卡牌就会出现在列表中，无论它来自哪里。尚未到账的抽卡藏品仅对售出卡包的开发者可见。

钱包通过你的应用抽中的卡牌会在 `pull` 中显示抽卡详情。其他已持有的卡牌（包括通过其他开发者抽中并到账的卡牌）返回 `pull: null`。

根据 `state.status` 决定展示哪种操作。

| 状态 | 展示内容 |
| - | - |
| `IN_BUYBACK_WINDOW` | 展示[当前档位金额与加成](https://docs.renaiss.xyz/cn/gacha.md#回购价值与加成)，签名前刷新[回购报价](https://docs.renaiss.xyz/cn/api-reference/gacha/list-buybacks.md)。 |
| `AWAITING_DELIVERY` | 提示用户等待卡牌转入钱包。 |
| `IN_WALLET` | 显示该钱包为卡牌的链上持有人。 |

最多可传入 20 个不同的十进制代币 ID，写法为 `?tokenIds=1,2` 或 `?tokenIds=1&tokenIds=2`。列表和 `pagination.total` 只统计匹配的藏品。单独查询[钱包摘要](https://docs.renaiss.xyz/cn/api-reference/wallets/get-collection-value.md)时，返回的仍是整个收藏的统计值。

## 分页读取活动

动态可能包含非本开发者交易产生的链上事件。将响应的 `nextCursor` 作为下一次请求的 `cursor`。即使当前页为空，只要仍有游标就继续请求。`nextCursor` 为 null 时结束。一笔交易可以包含多个事件，并跨页返回。

要查看归属于当前开发者的抽卡，请查[钱包抽卡记录](https://docs.renaiss.xyz/cn/gacha.md#两类抽卡记录)。私有配送信息见[实物兑换](https://docs.renaiss.xyz/cn/redeem.md)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.