# Wallet

> Read your Raywake wallet through the API, including available funds, funds reserved for running jobs and any outstanding debt.

Canonical: https://raywake.si/docs/reference/wallet
Last updated: 2026-10-13

`GET /v1/wallet`

Amounts in `*_usd` fields are decimal strings in US dollars. Older numeric amount fields remain integer US cents for existing integrations: 100 equals $1.00.

Requires `wallet:read`.

**Example**

cURL:

```bash
curl -s https://api.raywake.com/v1/wallet \
  -H "Authorization: Bearer $RAYWAKE_API_KEY"
```

Python:

```python
import json, os, requests

response = requests.get(
    "https://api.raywake.com/v1/wallet",
    headers={"Authorization": f"Bearer {os.environ['RAYWAKE_API_KEY']}"},
)
print(response.json())
```

JavaScript:

```javascript
const response = await fetch("https://api.raywake.com/v1/wallet", {
  method: "GET",
  headers: { Authorization: `Bearer ${process.env.RAYWAKE_API_KEY}` },
});
console.log(await response.json());
```

**Response fields**

| Name | Type | Description |
| --- | --- | --- |
| `available_usd` | string | Spendable USD balance. |
| `reserved_usd` | string | USD amount held by running generations. |
| `debt_usd` | string | Owed after a payment reversal; cleared first by new funds. |

## Related

- [API documentation](https://raywake.si/docs)
