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

# Wallet collections and activity

> Read a wallet's collection, estimated value and on-chain activity through the Users API.

Use the `/v2/users` HTTP routes from your backend with `x-builder-api-key`. The wallet address is a filter. These reads require no wallet signature or wallet access token. Query the address that holds the cards. A person's signer and their contract wallet can have different collections.

| GET route | Result |
| - | - |
| [`/v2/users/{walletAddress}`](https://docs.renaiss.xyz/api-reference/wallets/get-collection-value) | Card count, total RIX price (estimated FMV) in USD cents, and count of cards without an estimate. |
| [`/v2/users/{walletAddress}/collectibles`](https://docs.renaiss.xyz/api-reference/wallets/list-collectibles) | Cards the wallet owns on chain and cards it drew through your integration that are awaiting delivery. |
| [`/v2/users/{walletAddress}/activities`](https://docs.renaiss.xyz/api-reference/wallets/list-activities) | On-chain events for the wallet, newest first, including eligible pulls, buybacks, transfers, trades and redemptions. |

## Show the collection

Page through `collectibles` with `limit` and `offset`. The summary covers the same cards as the unfiltered list. Once the wallet owns a card on chain, it appears regardless of where the wallet acquired it. Undelivered draws are visible only to the selling builder.

Read `pull` for details of a card the wallet drew through your integration. For other owned cards, including draws through another builder, the field is `null`.

Use `state.status` to decide which action to show.

| Status | What the wallet can do |
| - | - |
| `IN_BUYBACK_WINDOW` | Show the [current tier and any bonus](https://docs.renaiss.xyz/gacha.md#buyback-values-and-bonuses). Refresh the [available offers](https://docs.renaiss.xyz/api-reference/gacha/list-buybacks.md) before signing. |
| `AWAITING_DELIVERY` | Wait for the card to transfer to the wallet. |
| `IN_WALLET` | Show the wallet as the card’s on-chain owner. |

To look up specific cards, pass up to 20 distinct decimal token IDs as `?tokenIds=1,2` or `?tokenIds=1&tokenIds=2`. The list and `pagination.total` include only matches. The separate [wallet summary](https://docs.renaiss.xyz/api-reference/wallets/get-collection-value.md) still covers the whole collection.

## Page through activity

The activity feed can include on-chain events outside your builder's sales. Use `nextCursor` from one response as the next request's `cursor`. Continue through an empty page if it has a cursor. Stop when `nextCursor` is null. A transaction can contain several events and span multiple pages.

Use [wallet pull history](https://docs.renaiss.xyz/gacha.md#two-kinds-of-history) when you need draws attributed to your builder. Use [Redeem](https://docs.renaiss.xyz/redeem.md) for private shipping information.


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