> For the complete documentation index, see [llms.txt](https://www.pionex.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.pionex.com/docs/api-docs/wallet-api/wallet.md).

# Wallet

Account balance query (private)

## Get full account balances overview

> Query all account balances overview including Spot (Bot Account) and Futures (Trader Account) dimensions,\
> with price information for each coin and total USDT/BTC valuations. Weight: 1.<br>

```json
{"openapi":"3.0.3","info":{"title":"Pionex Wallet Open API","version":"1.0.0"},"tags":[{"name":"Wallet","description":"Account balance query (private)"}],"servers":[{"url":"https://api.pionex.com","description":"Production"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"PIONEX-KEY","description":"API Key for authentication. Signature must be provided in PIONEX-SIGNATURE header."}},"parameters":{"Timestamp":{"name":"timestamp","in":"query","required":true,"description":"Request timestamp in milliseconds. Any timestamp older than 20,000 milliseconds or in the future is invalid.","schema":{"type":"integer","format":"int64"}}},"schemas":{"BaseResponse":{"type":"object","properties":{"result":{"type":"boolean","description":"Success indicator"},"timestamp":{"type":"integer","format":"int64","description":"Response timestamp in milliseconds"},"code":{"type":"string","description":"Error code (present only on failure)"},"message":{"type":"string","description":"Error message (present only on failure)"}}},"BalancesFullResponse":{"type":"object","description":"Full account balances overview","properties":{"prices":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/BalancePrice"},"description":"Price information for each coin, keyed by coin symbol (e.g. BTC, ETH)"},"totalInUsdt":{"type":"string","description":"Total USDT valuation across all accounts"},"totalInBtc":{"type":"string","description":"Total BTC valuation across all accounts"},"botAccount":{"$ref":"#/components/schemas/BotAccountBalanceDetail"},"traderAccount":{"$ref":"#/components/schemas/TraderAccountDetail"}}},"BalancePrice":{"type":"object","description":"Coin price information","properties":{"priceInUsd":{"type":"string","description":"Price in USD"},"priceInBtc":{"type":"string","description":"Price in BTC"},"change24hInUsd":{"type":"string","description":"24h price change in USD"},"change24hInBtc":{"type":"string","description":"24h price change in BTC"},"fullName":{"type":"string","description":"Full name of the coin"}}},"BotAccountBalanceDetail":{"type":"object","description":"Bot (Spot) account balance detail","properties":{"totalInUsdt":{"type":"string","description":"Total USDT valuation of Bot account"},"detail":{"type":"array","items":{"$ref":"#/components/schemas/BalanceDetail"},"description":"Categorized balance detail list"}}},"BalanceDetail":{"type":"object","description":"Balance category detail","properties":{"type":{"type":"string","description":"Category type"},"title":{"type":"string","description":"Category title"},"totalInUsdt":{"type":"string","description":"USDT valuation for this category"},"list":{"type":"array","items":{"type":"object"},"description":"Balance entries (structure depends on type)"},"hasMore":{"type":"boolean","description":"Whether more data is available"},"count":{"type":"integer","description":"Total number of entries"}}},"TraderAccountDetail":{"type":"object","description":"Trader (Futures) account balance detail","properties":{"totalInUsdt":{"type":"string","description":"Total USDT valuation of Trader account"},"title":{"type":"string","description":"Account title"},"detail":{"type":"array","items":{"$ref":"#/components/schemas/FutureDetail"},"description":"Futures account categorized detail"}}},"FutureDetail":{"type":"object","description":"Futures account category detail","properties":{"type":{"type":"string","description":"Category type"},"title":{"type":"string","description":"Category title"},"totalInUsdt":{"type":"string","description":"USDT valuation for this category"},"riskState":{"type":"string","description":"Risk control state"},"balances":{"type":"array","items":{"type":"object"},"description":"Futures balance list"},"positions":{"type":"array","items":{"type":"object"},"description":"Position list"},"quoteRisks":{"type":"array","items":{"type":"object"},"description":"Quote risk list"}}}},"responses":{"BadRequest":{"description":"Bad Request - Invalid parameters","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/BaseResponse"}]}}}},"Unauthorized":{"description":"Unauthorized - Missing or invalid API key or signature","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/BaseResponse"}]}}}}}},"paths":{"/api/v1/wallet/balancesFull":{"get":{"tags":["Wallet"],"summary":"Get full account balances overview","description":"Query all account balances overview including Spot (Bot Account) and Futures (Trader Account) dimensions,\nwith price information for each coin and total USDT/BTC valuations. Weight: 1.\n","operationId":"getBalancesFull","parameters":[{"$ref":"#/components/parameters/Timestamp"},{"name":"appLang","in":"query","required":false,"description":"Application language (takes priority over sysLang)","schema":{"type":"string"}},{"name":"sysLang","in":"query","required":false,"description":"System language (used as fallback when appLang is empty)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/BaseResponse"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/BalancesFullResponse"}}}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}}}}
```