> ## 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.

# 更新日志

> 按 UTC 发布日期查看 Renaiss API v2 的更新。

**2026年10月29日**

通过请求 ID 跟踪抽卡和回购

* **抽卡。** `POST /v2/gacha/pull/request` 受理请求后返回 HTTP `202` 和 `requestId`。连接关闭后，抽卡仍会继续。使用 [`GET /v2/gacha/pull/status`](https://docs.renaiss.xyz/cn/api-reference/gacha/get-pull-status) 查询进度。
* **回购。** 每次调用 `POST /v2/gacha/buyback/request` 都会生成一个独立请求。请求结束后，[`GET /v2/gacha/buyback/status`](https://docs.renaiss.xyz/cn/api-reference/gacha/get-buyback-status) 返回 `COMPLETED` 或 `FAILED`。
* **流式抽卡。** `POST /v2/gacha/pull/stream` 的 `pull_started` 事件现在会返回 `requestId`。
* **重试。** 付款尚未确认时，重发同一份已签名的抽卡请求，状态会保持为 `PENDING_PAYMENT`。

**2026年10月25日**

修复钱包活动查询

* **钱包活动。** 修复了 [`GET /v2/users/{walletAddress}/activities`](https://docs.renaiss.xyz/cn/api-reference/wallets/list-activities) 读取部分记录时出错的问题，并更正了响应中的部分地址和标识符。

**2026年10月23日**

钱包筛选参数更名，新增回购加成明细

* **代币筛选。** 钱包藏品接口将参数 `tokenId` 更名为 `tokenIds`。继续使用 `tokenId` 会收到 HTTP `400` 和错误码 `WRONG_REQUEST_PARAMS`。
* **回购加成明细。** `GET /v2/gacha/draw-status` 的抽卡结果和事件流的 `draws_resolved` 事件新增 `buybackBonus`，返回加成前的价值，并通过 `bonusBps` 给出加成比例。钱包活动、卡包公开抽卡记录以及回购期内的钱包藏品也提供此字段。
* **回购金额已含加成。** 如果卡牌有加成，返回的基础价值（`buybackBaseValueInUSD` 或 `buybackBaseValueInUsd`）和 `buybackTiers` 各档金额均已包含加成。`GET /v2/gacha/buyback/offers` 返回的各档报价也已包含加成，可直接使用。[回购价值与加成](https://docs.renaiss.xyz/cn/gacha.md#回购价值与加成)

**2026年10月22日**

按代币 ID 筛选钱包藏品

* **代币筛选。** [`GET /v2/users/{walletAddress}/collectibles`](https://docs.renaiss.xyz/cn/api-reference/wallets/list-collectibles) 新增 `tokenId` 参数，支持最多 20 个 ID。分页总数统计匹配的藏品。


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