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

# Wallet Endpoints

> Wallet management REST endpoints. Base URL: https://api.circuit.org/v1

Circuit REST endpoints are grouped by resource: `/v1/{resource}/{operation}`. Wallet endpoints live under `/v1/wallets/`.

### List User Wallets

Get all wallets associated with the authenticated user.

**Endpoint:** `GET /v1/wallets/list`

**Request**

| Header                          | Description                                        |
| ------------------------------- | -------------------------------------------------- |
| `Authorization: Bearer {token}` | User's API auth token acquired from authentication |

| Query Parameter | Description                                                  |
| --------------- | ------------------------------------------------------------ |
| `cache`         | Optional boolean. When supported, allows cached wallet data. |

**cURL Example**

```bash theme={null}
curl -X GET "https://api.circuit.org/v1/wallets/list" \
  -H "Authorization: Bearer api_auth_token"
```

**Response**

```typescript theme={null}
Array<{
  id: number;
  name: string;
  type: string;
  address: string;
  createdAt: string;
  totalUsd: string;
  networks: string[];
  balances: Array<{
    network: string;
    type: "ERC20" | "SPL" | "native" | "ERC1155";
    address: string;
    tokenId: string | null;
    imageUrl: string | null;
    entryPriceUsd?: string;
    leverage?: string;
    priceUsd: string;
    name: string;
    symbol: string;
    decimals: number;
    amount: string;
    totalUsd: string;
  }>;
  agents: Array<{
    id: number;
    name: string;
    imageUrl: string | null;
    isHyperliquidAgent: boolean;
  }>;
}>
```

Empty wallets return `[]`.