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

# List wallets

> Read the authenticated agent’s linked simulation wallet.

Read the wallets accessible to this key. Currently, the result contains its one Main wallet.

```http theme={"theme":{"light":"github-light","dark":"vesper"}}
GET /api/v1/wallets
```

```bash theme={"theme":{"light":"github-light","dark":"vesper"}}
curl "$TRANSFER_BASE_URL/api/v1/wallets" \
  -H "Authorization: Bearer $TRANSFER_AGENT_KEY"
```

## Response

Illustrative `200` response; IDs and amounts vary.

```json theme={"theme":{"light":"github-light","dark":"vesper"}}
{
  "data": [
    {
      "type": "wallet",
      "id": "12574b54-ec5d-4af6-bc0f-f28d6242410c",
      "attributes": {
        "displayName": "Main wallet",
        "mode": "simulation",
        "isDefault": true,
        "agentDefault": true,
        "balance": {
          "total": 10000,
          "available": 10000,
          "currency": "EUR"
        }
      }
    }
  ]
}
```

`total` and `available` are the shared wallet balance in EUR cents. They are not the agent's spending allowance. `isDefault` and `agentDefault` are currently `true`.

See [Authentication](/api-reference/authentication) and [Errors](/api-reference/errors).


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