---
title: "Get subaccount detail"
method: GET
path: "/v1/subaccounts/{id}"
tags: ["Subaccounts"]
---

# Get subaccount detail

`GET /v1/subaccounts/{id}`

## Request

- Base URL: `https://api.predictasiax.com`
- URL: `https://api.predictasiax.com/v1/subaccounts/{id}`
- Auth: HTTP bearer

Returns subaccount config + balance + risk limits (joined from subaccount_balances + subaccount_risk_limits). Scope: portfolio:read. Only the parent user can read.

## Response `200`

Subaccount detail

- object
  - `data` object
    - `subaccount` object
      - `id` string
      - `parent_user_id` string
      - `label` string
      - `kind` 'default' | 'strategy' | 'delegated'
      - `status` 'active' | 'frozen' | 'closed'
      - `currency` string
      - `created_at_ms` integer
      - `updated_at_ms` integer
      - `frozen_at_ms` integer, nullable
      - `frozen_reason` string, nullable
      - `closed_at_ms` integer, nullable
      - `balance_free` string, nullable: Free balance as decimal string.
      - `balance_reserved` string, nullable
      - `max_open_notional_usdt` string, nullable
      - `max_daily_notional_usdt` string, nullable
      - `max_order_size_usdt` string, nullable
      - `daily_notional_used` string, nullable
  - `meta` object
    - `ts_ms` integer
    - `trace_id` string

## Other responses

- `403`: subaccount belongs to a different user
- `404`: subaccount not found

---

[API](https://skmtc.dev/predictasiax/apis/predictasiax-network-api.md) · [All operations](https://skmtc.dev/predictasiax/apis/predictasiax-network-api/llms.txt) · [OpenAPI document](https://skmtc.dev/predictasiax/apis/predictasiax-network-api/revisions/c2ed1a03ce79?raw)