Skip to main content
curl -X GET "https://api.strike.markets/balances/0x742d35cc6c6c7532b1140da4c8a2f6c8ecfc9b46"

{
  "balance": "1000.50",
  "withdrawable": "500.25",
  "totalDeposited": "2000.00",
  "totalWithdrawn": "499.50"
}

curl -X GET "https://api.strike.markets/balances/0x742d35cc6c6c7532b1140da4c8a2f6c8ecfc9b46"

{
  "balance": "1000.50",
  "withdrawable": "500.25",
  "totalDeposited": "2000.00",
  "totalWithdrawn": "499.50"
}

​
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

​
wallet_address
string
required
The wallet address to get balance information for.Format: Ethereum address (0x prefixed)
Example: “0x742d35cc6c6c7532b1140da4c8a2f6c8ecfc9b46”

​
Response Fields

​
balance
string
Current account balance available for trading (USD)
​
withdrawable
string
Amount available for withdrawal (USD) - excludes reserved margin
​
totalDeposited
string
Total amount deposited to this account (USD)
​
totalWithdrawn
string
Total amount withdrawn from this account (USD)

​
Balance Components

​
Account Balance

Total funds in the account: 
Balance = Total Deposits - Total Withdrawals + Realized PnL

​
Withdrawable Amount

Funds available for withdrawal (excludes margin reserved in open positions): 
Withdrawable = Account Balance - Reserved Margin

​
Reserved Margin

Margin locked in open positions (calculated separately, not returned by this endpoint): 
Reserved = Sum of all open position margins

​
Error Responses

​
400 Bad Request
object
Invalid wallet address format
{
  "detail": "Invalid wallet address format"
}
​
500 Internal Server Error
object
Failed to retrieve balance data
{
  "detail": "Failed to get balance data: {error_details}"
}

​
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
  • 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