> For the complete documentation index, see [llms.txt](https://pacifica.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pacifica.gitbook.io/docs/api-documentation/api/rest-api/subaccounts/list-subaccounts.md).

# List subaccounts

```
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>"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
{
  "account": "42txU9As...",
  "signature": "5j1Vy9Uq...",
  "timestamp": 1716200000000,
  "expiry_window": 30000
}
```

#### Response

* Status 200: Subaccounts listed successfully

```json
{
  "success": true,
  "data": {
    "subaccounts": [
      {
        "address": "69txU9As...",
        "balance": "1000.50",
        "pending_balance": "0.00",
        "fee_level": 1,
        "fee_mode": "auto",
        "use_ltp_for_stop_orders": false,
        "created_at": 1716200000000
      }
    ]
  },
  "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                                                                                     |
| `'use_ltp_for_stop_orders'` | boolean        | Does this subaccount use last traded price to trigger stop orders?                                      |
| `'created_at'`              | integer        | Creation timestamp in milliseconds                                                                      |

* Status 400: Bad request

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

* Status 401: Unauthorized

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