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

# Wallet State

> Read token movements, roles, policies, and the rent recipient.

Use these reads to explain token movements and inspect
wallet configuration. Send your server API key and use the Swig **config address**
in wallet routes.

## What you can query

| Data | Endpoint | Result |
| :- | :- | :- |
| Token movements | `GET /wallet/swig/{swig_config_address}/token-transactions` | Recent wallet-relative inflows and outflows, including sub-account attribution |
| Roles | `GET /wallet/swig/{swig_config_address}/roles` | Role IDs, authorities, and permission actions |
| Policy | `GET /wallet/policies/{policy_id}` | A policy visible to your API-key organization |
| Rent recipient | `GET /transaction/wallet/{swig_address}/rent-claimer` | The configured V2 rent recipient, when present |

## Filters and results

* Set `network=NETWORK_MAINNET` or `network=NETWORK_DEVNET` on wallet and
  rent-recipient reads. Policy lookup takes its ID, without a network.
* Token history accepts `limit`: the default is 25 and the maximum is 100.
  It returns recent entries without a continuation cursor.
* Use decimal-string `amountRaw` for exact token arithmetic. Display amounts and
  USD values serve presentation; token movements are relative to the wallet,
  while [DEX actions](https://build.onswig.com/query/dex.md) describe individual venue operations.
* Token-history and role reads use recorded wallet data. The
  rent-recipient endpoint reads finalized chain state; an absent recipient on a
  valid config differs from an account or RPC error.

## Quota

Each admitted call consumes **one API request**, including a retry or a call
that later returns an error. These reads share the plan's API-request allowance
with other metered operations; they do not use DEX queries. See
[pricing and quotas](https://build.onswig.com/query.md#pricing-and-included-usage).

## Reference and SDK examples

* [Wallet REST fields](https://build.onswig.com/developer-api/wallets)
* [Read balances](https://build.onswig.com/query/balances.md) for holdings and USD values
* [Wallet-read SDK examples](https://build.onswig.com/developer-sdk/wallet-reads)
* [Rent-recipient REST fields](https://build.onswig.com/developer-api/transactions#read-the-recipient)
* [Rent-claimer SDK examples](https://build.onswig.com/developer-sdk/rent-claimers.md)
* [Public wallet lookup and status](https://build.onswig.com/query/public) for client-side wallet discovery


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