--- updatedAt: 2026-09-10T03:47:23.000Z agentTools: projectIndex: https://apidocliquidity.readme.io/llms.txt --- # Get Account Balance Retrieve asset balances across all trade accounts accessible to the current LTP user. > **V2 alternatives:** Use [Get Funding Account Assets](/reference/get-funding-account-assets) for Funding, and [Get Trading Account Assets](/reference/get-trading-account-assets-v2) for one DMA account. For multiple DMA accounts, first retrieve the [Trading Account List](/reference/get-trading-account-list-v2) and then query each account's detail. Trading V2 does not expose `withdrawAvailable`. This V1 endpoint remains supported; see [V1-to-V2 guidance](/reference/assets-v1-account-assets#v1-to-v2-which-endpoint-should-i-use). ## Description Returns the asset balances for all LTP trade accounts (DMA accounts and the LTP Funding Account) accessible to the current LTP user. For each `accountId` and `accountType`, the response provides the total account equity in USDT (`totalUsdt`) and a detailed per-currency breakdown (`assetInfo[]`) including total balance, available amount, withdrawable amount, frozen amount, and USDT valuation. Note that the same `accountId` may appear multiple times — once per `accountType` — reflecting the sub-wallet structure of the underlying exchange (e.g. Spot, Margin-PM, Funding). ## Permission Requires `READ` permission. Supported by LTP primary user API keys and LTP sub-user API keys. RapidX portfolio API keys are not supported and cannot access this endpoint. For balance and asset details of RapidX trading portfolios, use the RapidX asset API instead. ## Request Parameters | Field | Type | Required | Description | | ----------- | -------- | -------- | ------------------------------------------------------------------------------------------------------- | | `accountId` | `String` | No | Filter by account ID. Supports comma-separated values (e.g. `10001,10002`). Omit to return all accounts | | `currency` | `String` | No | Filter by asset symbol (e.g. `USDT`, `BTC`). Only one currency can be specified at a time | ## Response Fields ### Account level (`data[]`) | Field | Type | Description | | ------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | `accountId` | `Long` | Internal LTP trade account ID. Matches the accountId returned from the trade account list API, and is used to identify this account. | | `accountNote` | `String` | Optional note or alias for this trade account (e.g. Your Note, Funding Account). May be an empty string. | | `venues` | `String` | Exchange or venue (e.g. `BINANCE`, `BYBIT`, `LTP`) | | `totalUsdt` | `String` | Total account equity **in USDT terms** for this `accountType` under the given `accountId`. Calculated by summing valueUsdt of all assets.T | | `accountType` | `String` | Sub-wallet type within the exchange (e.g. `Spot`, `Margin-PM`, `Funding`, `Trading`). Varies by exchange | | `assetInfo` | `Array` | List of per-currency asset records for this `accountId` + `accountType` combination. May be an empty array if there is no balance. | ### Asset level (`assetInfo[]`) | Field | Type | Description | | ------------------- | --------------- | -------------------------------------------------------------------------------------------------------------------- | | `currency` | `String` | Asset symbol (e.g. `USDT`, `BTC`) | | `totalBalance` | `String` | Total balance of this currency in this account type (including available + frozen). | | `available` | `String` | Available balance that can be used for trading or transfer. | | `withdrawAvailable` | `String` | Balance that is available for withdrawal. May differ from `available` due to risk or venue restrictions. | | `frozen` | `String` | Frozen balance (e.g. locked in open orders, pending withdrawals, or other holds). | | `valueUsdt` | `String` | Estimated mark-to-market value of this asset in USDT terms. | | `network` | `String / null` | Network / chain of the asset where applicable (e.g. `ERC20`, `BSC`, `BTC`). May be `null` for venue-internal assets. | # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "ltp-api", "version": "1.0" }, "servers": [ { "url": "https://api.liquiditytech.com" } ], "components": { "securitySchemes": { "sec0": { "type": "oauth2", "flows": { "clientCredentials": { "tokenUrl": "https://example.com/oauth2/token", "scopes": {} } } } } }, "security": [ { "sec0": [] } ], "paths": { "/api/v1/asset/getAccountCurrencyInfo": { "get": { "summary": "Get Account Balance", "description": "Retrieve asset balances across all trade accounts accessible to the current LTP user.", "operationId": "get-account-balance", "parameters": [ { "name": "accountId", "in": "query", "schema": { "type": "string" } }, { "name": "currency", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"code\": 200,\n \"message\": \"success\",\n \"data\": [\n {\n \"accountId\": 50004,\n \"accountNote\": \"my-binance-account\",\n \"venues\": \"BINANCE\",\n \"totalUsdt\": \"0\",\n \"accountType\": \"Spot\",\n \"assetInfo\": []\n },\n {\n \"accountId\": 50004,\n \"accountNote\": \"my-binance-account\",\n \"venues\": \"BINANCE\",\n \"totalUsdt\": \"1000.00\",\n \"accountType\": \"Margin-PM\",\n \"assetInfo\": [\n {\n \"currency\": \"USDT\",\n \"totalBalance\": \"1000.00\",\n \"available\": \"1000.00\",\n \"withdrawAvailable\": \"1000.00\",\n \"frozen\": \"0\",\n \"valueUsdt\": \"1000.00\",\n \"network\": null\n }\n ]\n },\n {\n \"accountId\": 81082,\n \"accountNote\": \"\",\n \"venues\": \"LTP\",\n \"totalUsdt\": \"5000.00\",\n \"accountType\": \"Funding Account\",\n \"assetInfo\": [\n {\n \"currency\": \"USDT\",\n \"totalBalance\": \"5000.00\",\n \"available\": \"5000.00\",\n \"withdrawAvailable\": \"5000.00\",\n \"frozen\": \"0\",\n \"valueUsdt\": \"5000.00\",\n \"network\": null\n }\n ]\n }\n ]\n}" } }, "schema": { "type": "object", "properties": { "code": { "type": "integer", "example": 200, "default": 0 }, "message": { "type": "string", "example": "success" }, "data": { "type": "array", "items": { "type": "object", "properties": { "accountId": { "type": "integer", "example": 50004, "default": 0 }, "accountNote": { "type": "string", "example": "my-binance-account" }, "venues": { "type": "string", "example": "BINANCE" }, "totalUsdt": { "type": "string", "example": "0" }, "accountType": { "type": "string", "example": "Spot" }, "assetInfo": { "type": "array", "items": { "type": "object", "properties": {} } } } } } } } } } }, "400": { "description": "400", "content": { "application/json": { "examples": { "Result": { "value": "{}" } }, "schema": { "type": "object", "properties": {} } } } } }, "deprecated": false, "security": [] } } }, "x-readme": { "headers": [], "explorer-enabled": false, "proxy-enabled": true }, "x-readme-fauxas": true } ```