# Get Account Balance
Retrieves the balance information for a specified account.
# OpenAPI definition
```json
{
"info": {
"title": "Webull Open API Reference",
"description": "application.yml\\ncom\\ni18n\\nMETA-INF\\nstatic\\n\\r\\n",
"contact": {
"name": "",
"url": "",
"email": ""
},
"version": "2.0",
"x-logo": {
"url": "static/png/logo.png"
}
},
"servers": [
{
"url": "https://broker-api.sandbox.webull.com"
}
],
"path": "/broker/assets/balances/get",
"method": "get",
"tags": [
"Assets"
],
"description": "Retrieves the balance information for a specified account.",
"operationId": "accountBalance",
"parameters": [
{
"name": "account_id",
"in": "query",
"description": "Account identifier.",
"required": true,
"schema": {
"type": "String"
},
"example": "LOJOQITOD49R6G9BPQM489CISA"
},
{
"name": "x-app-key",
"in": "header",
"description": "A unique identifier issued to a developer for accessing an application's API.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "x-app-secret",
"in": "header",
"description": "A unique key issued to developers to access the application's API.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "x-timestamp",
"in": "header",
"description": "Timestamp of the request, follows ISO8601 format: YYYY-MM-DDThh:mm:ssZ, e.g. 2023-07-16T19:23:51Z, only supports UTC time zone.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "x-signature-version",
"in": "header",
"description": "Signature algorithm version, default is 1.0.",
"required": true,
"schema": {
"type": "string",
"default": "1.0"
},
"examples": {
"1.0": {
"value": "1.0"
}
}
},
{
"name": "x-signature-algorithm",
"in": "header",
"description": "Signature algorithm, default is HMAC-SHA1.",
"required": true,
"schema": {
"type": "string",
"default": "HMAC-SHA1"
},
"examples": {
"HMAC-SHA1": {
"value": "HMAC-SHA1"
}
}
},
{
"name": "x-signature-nonce",
"in": "header",
"description": "Signature unique random number.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "x-version",
"in": "header",
"description": "API interface version. Supported values: `v2`, `v3`.",
"required": true,
"schema": {
"type": "string",
"default": "v3"
},
"examples": {
"v3": {
"value": "v3"
}
}
},
{
"name": "x-signature",
"in": "header",
"description": "A signature is a unique digital fingerprint, typically encrypted, that verifies the authenticity and integrity of a message or transaction, ensuring it has not been tampered with during transmission.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"required": [
"account_currency_assets",
"total_asset_currency",
"total_cash_balance"
],
"type": "object",
"properties": {
"total_asset_currency": {
"type": "string",
"description": "Currency",
"example": "USD",
"enum": [
"USD"
]
},
"total_cash_balance": {
"type": "string",
"description": "Cash Balance, ",
"example": "485705.0"
},
"total_market_value": {
"type": "string",
"description": "Total holding market value",
"example": "995705.0"
},
"total_unrealized_profit_loss": {
"type": "string",
"description": "The unrealized profit or loss of open positions for the specified account.",
"example": "227689.0"
},
"total_net_liquidation_value": {
"type": "string",
"description": "Net Account Value, ",
"example": "727687.04"
},
"total_day_profit_loss": {
"type": "string",
"description": "Day's P&L
Not returned at the Omnibus master account level.",
"example": "11798.6"
},
"maintenance_margin": {
"type": "string",
"description": "Maintenance Margin（Margin Account）
Only returned for margin accounts.",
"example": "0.0"
},
"open_margin_calls": {
"type": "string",
"description": "Open Margin Calls:
Only returned for margin accounts.
RM: An RM call is triggered when an account's margin equity falls below the maintenance requirement, often due to a decline in the value of the account's positions or an increase in margin requirements for the holdings.\n
RT: A Reg T call occurs when there is not enough equity in an account to cover the 50% initial margin requirement. This can happen due to open positions depreciating or from holding positions overnight that were opened with day trade buying power.\n
EM: An EM call is triggered when a flagged Pattern Day Trader (PDT) account closes the prior business day below the $25,000 minimum Net Account Value (NAV) requirement. Only positions held in the margin account will count toward this requirement. Crypto, futures, event contracts, and any assets held outside the margin account are excluded from the calculation.\n
DT: A Day Trade (DT) Call is issued when you exceed your available Day Trading Buying Power (DTBP) and then place a day trade. A DT call may also occur if you execute a day trade while an Equity Maintenance (EM) call is still active on your account. Exceeding day trade buying power most commonly results from trading on intraday profits. For more details on how buying power is replenished, please refer to our Margin Buying Power page.",
"example": "['EM']",
"enum": [
"EM",
"RM",
"RT",
"DT"
]
},
"account_currency_assets": {
"type": "array",
"description": "Currency assets Details",
"items": {
"required": [
"cash_balance",
"currency"
],
"type": "object",
"properties": {
"currency": {
"type": "string",
"description": "Currency",
"example": "USD",
"enum": [
"USD"
]
},
"cash_balance": {
"type": "string",
"description": "Cash Balance.",
"example": "485705.95"
},
"settled_cash": {
"type": "string",
"description": "Settled Cash，
Not returned for event contract accounts.
Not returned for margin accounts.",
"example": "485705.95"
},
"unsettled_cash": {
"type": "string",
"description": "Unsettled Cash，
Not returned for event contract accounts.
Not returned for margin accounts.",
"example": "0.0"
},
"market_value": {
"type": "string",
"description": "holding market value",
"example": "0.0"
},
"held_amount": {
"type": "string",
"description": "In-transit funds
Not returned for event contract accounts.",
"example": "0.0"
},
"buying_power": {
"type": "string",
"description": "Buying Power
Not returned for margin accounts.",
"example": "484551"
},
"day_buying_power": {
"type": "string",
"description": "Day-Trade Buying Power（Margin Account）
Only returned for margin accounts.",
"example": "0.0"
},
"overnight_buying_power": {
"type": "string",
"description": "Overnight BP（Margin Account）
Only returned for margin accounts.",
"example": "0.0"
},
"night_trading_buying_power": {
"type": "string",
"description": "Night Trading Buying Power
Not returned for event contract accounts.",
"example": "0.0"
},
"day_profit_loss": {
"type": "string",
"description": "Day's P&L
Not returned at the Omnibus master account level.",
"example": "0.0"
},
"unrealized_profit_loss": {
"type": "string",
"description": "Open P&L",
"example": "227689"
},
"available_withdrawal": {
"type": "string",
"description": "The amount of funds currently available for withdrawal.",
"example": "3.0558743194E8"
},
"interests_unpaid": {
"type": "string",
"description": "Interest to be paid
Not returned for event contract accounts.",
"example": "0.0"
},
"net_liquidation_value": {
"type": "string",
"description": "Net Account Value",
"example": "0.0"
}
},
"description": "Currency assets Details",
"title": "AssetsCurrencyAssets"
}
}
},
"description": "Account Balance",
"title": "AssetsBalanceResult"
}
}
}
},
"401": {
"description": "Unauthorized: Authentication required",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"error_code": {
"type": "string",
"description": "Internal logic error code",
"example": "UNAUTHORIZED"
},
"message": {
"type": "string",
"description": "Error message",
"example": "Insufficient permission"
}
}
}
}
}
},
"417": {
"description": "A business logic error triggered when the request cannot be processed due to domain-specific constraints.",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"error_code": {
"type": "string",
"description": "Internal logic error code",
"example": "INVALID_PARAMETER"
},
"message": {
"type": "string",
"description": "Error message",
"example": "Parameter error, phone"
}
}
}
}
}
},
"500": {
"description": "Internal Server Error.",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"error_code": {
"type": "string",
"description": "Internal logic error code",
"example": "SYSTEM_ERROR"
},
"message": {
"type": "string",
"description": "Error message",
"example": "Internal Server Error"
}
}
}
}
}
}
},
"postman": {
"name": "Get Account Balance",
"description": {
"content": "Retrieves the balance information for a specified account.",
"type": "text/plain"
},
"url": {
"path": [
"broker",
"assets",
"balances",
"get"
],
"host": [
"{{baseUrl}}"
],
"query": [
{
"disabled": false,
"description": {
"content": "(Required) Account identifier.",
"type": "text/plain"
},
"key": "account_id",
"value": ""
}
],
"variable": []
},
"header": [
{
"disabled": false,
"description": {
"content": "(Required) A unique identifier issued to a developer for accessing an application's API.",
"type": "text/plain"
},
"key": "x-app-key",
"value": ""
},
{
"disabled": false,
"description": {
"content": "(Required) A unique key issued to developers to access the application's API.",
"type": "text/plain"
},
"key": "x-app-secret",
"value": ""
},
{
"disabled": false,
"description": {
"content": "(Required) Timestamp of the request, follows ISO8601 format: YYYY-MM-DDThh:mm:ssZ, e.g. 2023-07-16T19:23:51Z, only supports UTC time zone.",
"type": "text/plain"
},
"key": "x-timestamp",
"value": ""
},
{
"disabled": false,
"description": {
"content": "(Required) Signature algorithm version, default is 1.0.",
"type": "text/plain"
},
"key": "x-signature-version",
"value": ""
},
{
"disabled": false,
"description": {
"content": "(Required) Signature algorithm, default is HMAC-SHA1.",
"type": "text/plain"
},
"key": "x-signature-algorithm",
"value": ""
},
{
"disabled": false,
"description": {
"content": "(Required) Signature unique random number.",
"type": "text/plain"
},
"key": "x-signature-nonce",
"value": ""
},
{
"disabled": false,
"description": {
"content": "(Required) API interface version. Supported values: `v2`, `v3`.",
"type": "text/plain"
},
"key": "x-version",
"value": ""
},
{
"disabled": false,
"description": {
"content": "(Required) A signature is a unique digital fingerprint, typically encrypted, that verifies the authenticity and integrity of a message or transaction, ensuring it has not been tampered with during transmission.",
"type": "text/plain"
},
"key": "x-signature",
"value": ""
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "GET"
}
}
```