> ## Documentation Index
> Fetch the complete documentation index at: https://docs.strike.markets/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Account Balance

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.strike.markets/balances/0x742d35cc6c6c7532b1140da4c8a2f6c8ecfc9b46"
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "balance": "1000.50",
    "withdrawable": "500.25",
    "totalDeposited": "2000.00",
    "totalWithdrawn": "499.50"
  }
  ```
</ResponseExample>

## 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.

<Info>
  This is a **public endpoint** that does not require authentication. You can query any wallet address to view its balance information.
</Info>

## Path Parameters

<ParamField path="wallet_address" type="string" required>
  The wallet address to get balance information for.

  **Format**: Ethereum address (0x prefixed)\
  **Example**: "0x742d35cc6c6c7532b1140da4c8a2f6c8ecfc9b46"
</ParamField>

## Response Fields

<ResponseField name="balance" type="string">
  Current account balance available for trading (USD)
</ResponseField>

<ResponseField name="withdrawable" type="string">
  Amount available for withdrawal (USD) - excludes reserved margin
</ResponseField>

<ResponseField name="totalDeposited" type="string">
  Total amount deposited to this account (USD)
</ResponseField>

<ResponseField name="totalWithdrawn" type="string">
  Total amount withdrawn from this account (USD)
</ResponseField>

## 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

<ResponseField name="400 Bad Request" type="object">
  Invalid wallet address format

  ```json theme={null}
  {
    "detail": "Invalid wallet address format"
  }
  ```
</ResponseField>

<ResponseField name="500 Internal Server Error" type="object">
  Failed to retrieve balance data

  ```json theme={null}
  {
    "detail": "Failed to get balance data: {error_details}"
  }
  ```
</ResponseField>

## 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](/api-reference/account/dashboard) - Comprehensive account overview including positions
* [Get Positions](/api-reference/positions/get-positions) - View positions affecting withdrawable balance
* [Deposit](/api-reference/account/deposit) - Add funds to account (requires authentication)
* [Withdraw](/api-reference/account/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