Overview
Retrieve account balance information for a specific wallet address. This endpoint provides real-time balance data including available funds, withdrawable balance, and deposit/withdrawal history.This is a public endpoint that does not require authentication. You can query any wallet address to view its balance information.
Path Parameters
string
required
The wallet address to get balance information for.Format: Ethereum address (0x prefixed)
Example: “0x742d35cc6c6c7532b1140da4c8a2f6c8ecfc9b46”
Example: “0x742d35cc6c6c7532b1140da4c8a2f6c8ecfc9b46”
Response Fields
string
Current account balance available for trading (USD)
string
Amount available for withdrawal (USD) - excludes reserved margin
string
Total amount deposited to this account (USD)
string
Total amount withdrawn from this account (USD)
Balance Components
Account Balance
Total funds in the account:Withdrawable Amount
Funds available for withdrawal (excludes margin reserved in open positions):Reserved Margin
Margin locked in open positions (calculated separately, not returned by this endpoint):Error Responses
object
Invalid wallet address format
object
Failed to retrieve balance data
Caching and Performance
- Real-time updates: Balance reflects latest transactions
- Optimized queries: Fast response times for frequent polling
- No rate limits: Public endpoint with minimal restrictions
Related Endpoints
- Dashboard - Comprehensive account overview including positions
- Get Positions - View positions affecting withdrawable balance
- Deposit - Add funds to account (requires authentication)
- Withdraw - Withdraw available balance (requires authentication)
Notes
- This endpoint provides public balance information for transparency
- For private operations (deposits, withdrawals, trading), use authenticated endpoints
- Balance updates immediately after deposits, withdrawals, and position settlements
- Withdrawable amount may be less than total balance if margin is reserved in open positions