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

# List Subaccounts

> Lists all subaccounts associated with a main (parent) account. Returns address, balance, and other account details for each subaccount.

```http theme={null}
POST /api/v1/account/subaccount/list
```

#### Request Body

<table><thead><tr><th width="176">Field</th><th width="98">Type</th><th width="95">Need</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td><code>"account"</code></td><td>string</td><td>required</td><td>Main account wallet address</td><td><code>42trU9A5...</code></td></tr><tr><td><code>"signature"</code></td><td>string</td><td>required</td><td>Main account signature</td><td><code>5j1Vy9Uq...</code></td></tr><tr><td><code>"timestamp"</code></td><td>integer</td><td>required</td><td>Current timestamp in milliseconds</td><td><code>1716200000000</code></td></tr><tr><td><code>"agent\_wallet"</code></td><td>string</td><td>optional</td><td>Agent wallet address</td><td><code>69trU9A5...</code></td></tr><tr><td><code>"expiry\_window"</code></td><td>integer</td><td>optional</td><td>Signature expiry in milliseconds</td><td><code>30000</code></td></tr></tbody></table>

```json theme={null}
{
  "account": "42txU9As...",
  "signature": "5j1Vy9Uq...",
  "timestamp": 1716200000000,
  "expiry_window": 30000
}
```

#### Response

* Status 200: Subaccounts listed successfully

```json theme={null}
{
  "success": true,
  "data": {
    "subaccounts": [
      {
        "address": "69txU9As...",
        "balance": "1000.50",
        "pending_balance": "0.00",
        "fee_level": 1,
        "fee_mode": "auto",
        "created_at": 1716200000000,
        "nickname": "Trading Bot"
      }
    ]
  },
  "error": null,
  "code": null
}
```

| Field               | Type           | Description                                                                                             |
| ------------------- | -------------- | ------------------------------------------------------------------------------------------------------- |
| `'address'`         | string         | Current account balance, defined as amount of USD in account before settlement                          |
| `'balance'`         | decimal string | Subaccount balance in USD                                                                               |
| `'pending_balance'` | decimal string | Amount of subaccount balance in pending status (deposit request is successful, waiting on confirmation) |
| `'fee_level'`       | integer        | Current fee tier of account, determined by trading volume                                               |
| `'fee_mode'`        | string         | `"auto"` by default                                                                                     |
| `'created_at'`      | integer        | Creation timestamp in milliseconds                                                                      |
| `'nickname'`        | string or null | Optional subaccount nickname (omitted when not set)                                                     |

* Status 400: Bad request

```json theme={null}
{
  "success": false,
  "data": null,
  "error": "Invalid signature format",
  "code": null
}
```

* Status 401: Unauthorized

```json theme={null}
{
  "success": false,
  "data": null,
  "error": "Signature verification failed",
  "code": null
}
```