---
title: "Get Account Balance"
method: GET
path: "/api/v1/account/balance"
tags: ["Account"]
---

# Get Account Balance

`GET /api/v1/account/balance`

## Request

- Base URL: `https://api.ekiden.fi`
- URL: `https://api.ekiden.fi/api/v1/account/balance`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/ekidenfi/apis/ekiden-gateway/docs/api/v1/account/balance/get.ts> (a function with typed inputs; its response is checked against the schema)

Query account balances. Returns all subaccounts' vault balances.

## Response `200`

Balances

- GetAccountBalanceResponse: Account balance response structure.
  - `list` AccountBalance[], required
    - `account_type` string, required: Account type (e.g. Funding, Trading)
    - `accrued_interest` string, required: Accrued interest
    - `available_balance` string, required: The amount of an asset that can be used to open USDC Perpetual positions (USDC)
    - `equity` string, required: Equity under the account without considering the collateral value ratio (calculated in USDC). Equity = Vault Balance + Perp & Futures Unrealized P&L + Unrealized Funding
    - `margin_balance` string, required: Amount that can be used as margin under the account after considering the collateral value ratio (calculated in USDC) Total Vault Balance + Perp Unrealized P&L
    - `realised_pnl_cum` string, required: Cumulative Realised P&L
    - `sub_account_address` string, required: Sub-Account address (the owner of the technical vault)
    - `total_order_im` string, required: Pre-occupied margin for order. Locked balance (USDC)
    - `total_position_im` string, required: Sum of initial margin of all positions.
    - `total_position_mm` string, required: Sum of maintenance margin for all positions, including estimated close fees.
    - `unrealised_pnl` string, required: Unrealised P&L
    - `unrealized_funding` string, required: Aggregated unrealized funding across all positions (USDC)
    - `vault_balance` string, required: Vault Balance (USDC)

## Changes

- **2026-01-29** `16fe50636aa5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ekidenfi/apis/ekiden-gateway/changes/api/v1/account/balance/get.md)

---

[API](https://skmtc.dev/ekidenfi/apis/ekiden-gateway.md) - [All operations](https://skmtc.dev/ekidenfi/apis/ekiden-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/ekidenfi/apis/ekiden-gateway/revisions/fad9eecaba2e?raw)