---
title: "List subaccounts"
method: GET
path: "/v2/sub-accounts"
tags: ["Subaccounts"]
---

# List subaccounts

`GET /v2/sub-accounts`

Lists the authenticated master account's pending and active subaccounts, including current equity, available balance, PnL, and margin-used percentage. API-wallet traders can use the returned account_id as sub_account_id on supported trading and read endpoints.

## Response `200`

Subaccounts owned by the authenticated master account

- SubAccountsResponse
  - `sub_accounts` SubAccount[], required
    - `account_id` string, uuid, required — Subaccount ID
    - `parent_account_id` string, uuid, required — Parent/master account ID
    - `name` string, required — Display name
    - `status` 'pending' | 'active', required — Lifecycle status
    - `equity` string, required — Current equity
    - `available_balance` string, required — Balance available for new orders
    - `unrealized_pnl` string, required — Unrealized PnL
    - `total_pnl` string, required — Realized plus unrealized PnL
    - `margin_used_pct` string, required — Margin used as a percentage of equity

## Other responses

- `401` — Authentication is missing, invalid, or does not own the selected subaccount
- `500` — Internal server error

---

[API](https://skmtc.net/strikefinance/apis/strike-finance-staking-api.md) · [All operations](https://skmtc.net/strikefinance/apis/strike-finance-staking-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/strikefinance/strike-finance-staking-api/revisions/6b7d8bd51050/schema)
