LedgerReadService
Get Balances
Retrieve the latest balances for an account. Supports optional subaccount scoping and returns asset symbols with decimal amounts.
Request
curl --request GET \ \ --url 'https://api.testnet.polyester.com/v1/balances?subaccount_id=6789012345678' \ --header 'Accept: */*' \ --header 'X-API-KEY-ID: YOUR_API_KEY_ID' \ --header 'X-API-TIMESTAMP: YOUR_API_TIMESTAMP' \ --header 'X-API-SIGNATURE: YOUR_API_SIGNATURE'
Responses
{
"balances": [
{
"available": "18.446744073709551617",
"funding": "18.446744073709551617",
"fundingRevision": "1",
"reserved": "18.446744073709551617",
"symbol": "USDT",
"trading": "18.446744073709551617",
"tradingRevision": "1"
}
]
}Optional subaccount public id (base58).
Amount currently available for new trading activity at fixed 18-decimal ledger scale. This value already accounts for active reservations.
18.446744073709551617Funding balance at fixed 18-decimal ledger scale.
18.446744073709551617Opaque monotonic revision for the funding value. Higher means newer; zero means no funding state has been observed.
1Reserved amount in the trading bucket at fixed 18-decimal ledger scale.
18.446744073709551617Public unified asset id. Resolve symbol from SpotConfig; U128 amounts in this message always use fixed 18-decimal ledger scale.
USDTTrading balance at fixed 18-decimal ledger scale.
18.446744073709551617Opaque monotonic revision for the atomic trading, reserved, and available values. Higher means newer; zero means no trading state has been observed.
1| Key | Status | Error | When |
|---|---|---|---|
| unauthenticated | 401 | Unauthenticated | Authentication required. |
| permission-denied | 403 | Permission Denied | Permission denied. |
| invalid-argument | 400 | Invalid Argument | Invalid argument. |
| not-found | 404 | Not Found | Not found. |
| unavailable | 503 | Unavailable | Service unavailable. |