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

The Wallet API reads Swig wallet state through API-key guarded runtime
endpoints.

## Auth

Use an API key:

```text theme={null}
Authorization: Bearer sk_your_api_key
```

Developer-portal admin endpoints are intentionally omitted from this reference.

## List token balances

`GET /wallet/swig/{swig_config_address}/token-balances`

Query parameters:

| Parameter | Type | Description                           |
| :-------- | :--- | :------------------------------------ |
| `network` | enum | `NETWORK_DEVNET` or `NETWORK_MAINNET` |

Response fields:

| Field               | Type   | Description                              |
| :------------------ | :----- | :--------------------------------------- |
| `swigConfigAddress` | string | Swig config address                      |
| `walletAddress`     | string | Swig wallet address                      |
| `balances`          | array  | Token and native SOL balances            |
| `totalUsdValue`     | number | Total USD value across returned balances |

## List token transactions

`GET /wallet/swig/{swig_config_address}/token-transactions`

Query parameters:

| Parameter | Type   | Description                              |
| :-------- | :----- | :--------------------------------------- |
| `network` | enum   | `NETWORK_DEVNET` or `NETWORK_MAINNET`    |
| `limit`   | number | Maximum number of transactions to return |

## Get policy

`GET /wallet/policies/{policy_id}` reads a policy visible to the API-key
organization. Policy creation and policy administration are portal-admin flows,
not API-key runtime endpoints.