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

> Get account balance and transaction information

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

  ```javascript JavaScript theme={null}
  const walletAddress = "0x742d35cc6C6C7532B1140Da4C8A2f6C8ECfC9B46";

  const response = await fetch(`https://api.strike.markets/account/${walletAddress}`);
  const accountData = await response.json();

  console.log('Account information:', accountData);
  ```

  ```python Python theme={null}
  import requests

  wallet_address = "0x742d35cc6C6C7532B1140Da4C8A2f6C8ECfC9B46"

  response = requests.get(f'https://api.strike.markets/account/{wallet_address}')
  account_data = response.json()

  print('Account information:', account_data)
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "balances": {
      "withdrawable": "750.25",
      "total": "1250.25",
      "reserved": "500.00"
    },
    "deposits": [
      {
        "amount": "1000.0",
        "txHash": "0x1234567890abcdef1234567890abcdef12345678901234567890abcdef123456",
        "timestamp": "2024-01-15T14:30:00Z"
      },
      {
        "amount": "500.0",
        "txHash": "0x1234567890abcdef1234567890abcdef12345678901234567890abcdef123457",
        "timestamp": "2024-01-10T10:15:00Z"
      }
    ],
    "withdrawals": [
      {
        "amount": "250.0",
        "txHash": "0x1234567890abcdef1234567890abcdef12345678901234567890abcdef123458",
        "timestamp": "2024-01-12T16:20:00Z"
      }
    ]
  }
  ```
</ResponseExample>

## Overview

Retrieve comprehensive account information for a specific wallet address, including balance breakdown, deposit history, and withdrawal history.

<Note>
  This endpoint does NOT require authentication and can be called for any wallet address. All balance and transaction information is publicly accessible.
</Note>

## Path Parameters

<ParamField path="wallet_address" type="string" required>
  Ethereum wallet address to retrieve account information for.

  **Format**: 42-character hex string starting with "0x"\
  **Example**: "0x742d35cc6C6C7532B1140Da4C8A2f6C8ECfC9B46"
</ParamField>

## Response Fields

### Balances Object

<ResponseField name="balances" type="object">
  Comprehensive balance breakdown for the account

  <Expandable title="Balance Properties">
    <ResponseField name="withdrawable" type="string">
      Amount available for immediate withdrawal (not reserved as margin)
    </ResponseField>

    <ResponseField name="total" type="string">
      Total account balance (withdrawable + reserved)
    </ResponseField>

    <ResponseField name="reserved" type="string">
      Amount reserved as margin for open positions
    </ResponseField>
  </Expandable>
</ResponseField>

### Deposits Array

<ResponseField name="deposits" type="array">
  Historical record of all deposits to the account

  <Expandable title="Deposit Properties">
    <ResponseField name="amount" type="string">
      Deposit amount in USD
    </ResponseField>

    <ResponseField name="txHash" type="string">
      Ethereum transaction hash for the deposit
    </ResponseField>

    <ResponseField name="timestamp" type="string">
      ISO timestamp when the deposit was recorded
    </ResponseField>
  </Expandable>
</ResponseField>

### Withdrawals Array

<ResponseField name="withdrawals" type="array">
  Historical record of all withdrawals from the account

  <Expandable title="Withdrawal Properties">
    <ResponseField name="amount" type="string">
      Withdrawal amount in USD
    </ResponseField>

    <ResponseField name="txHash" type="string">
      Ethereum transaction hash for the withdrawal
    </ResponseField>

    <ResponseField name="timestamp" type="string">
      ISO timestamp when the withdrawal was recorded
    </ResponseField>
  </Expandable>
</ResponseField>

## Balance Breakdown

### Understanding Balance Types

#### Total Balance

```
Total Balance = Withdrawable + Reserved
```

The complete sum of all funds in your Strike Protocol account.

#### Withdrawable Balance

```
Withdrawable = Total - Reserved - Pending Operations
```

Funds available for:

* Immediate withdrawal
* Opening new positions (as margin)
* Other account operations

#### Reserved Balance

```
Reserved = Sum of all active position margins
```

Funds locked as margin for open positions:

* Cannot be withdrawn
* Used to maintain position health
* Released when positions are closed

### Balance Calculation Example

**Scenario**: User has 2 open positions

* Position 1: \$300 margin
* Position 2: \$200 margin
* Total account deposits: \$1,500
* Total withdrawals: \$250

**Calculation**:

```
Total Balance = $1,500 - $250 = $1,250
Reserved Balance = $300 + $200 = $500
Withdrawable Balance = $1,250 - $500 = $750
```

## Transaction History

### Deposits

All successful deposits are tracked with:

* **Transaction verification**: On-chain validation
* **Amount recording**: Exact deposited amounts
* **Timestamp tracking**: When deposit was processed
* **Hash storage**: Blockchain transaction reference

### Withdrawals

All completed withdrawals include:

* **Amount tracking**: Withdrawn amounts
* **Transaction hashes**: Blockchain references
* **Processing time**: When withdrawal was recorded
* **Balance impact**: Effect on account balance

### Chronological Ordering

* Transactions are ordered by timestamp (newest first)
* Each transaction includes complete audit trail
* All amounts are tracked in USD equivalent

## Error Responses

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

  ```json theme={null}
  {
    "error": 400,
    "message": "Invalid wallet address format"
  }
  ```
</ResponseField>

<ResponseField name="404 Not Found" type="object">
  Wallet address not found in system (no activity)

  ```json theme={null}
  {
    "error": 404,
    "message": "Account not found"
  }
  ```
</ResponseField>

## Related Endpoints

* **[Dashboard](/api-reference/account/dashboard)** - More comprehensive account overview with analytics
* **[Positions](/api-reference/positions/get-positions)** - View positions that contribute to reserved balance

## Managing Deposits and Withdrawals

<Note>
  For deposits and withdrawals, please use the Strike Protocol frontend interface. The API endpoints for recording these transactions have been removed - all deposit and withdrawal operations should be performed directly through the web application.
</Note>

<Tip>
  Use this endpoint to verify your account state before making trading decisions or planning withdrawals.
</Tip>

<Note>
  Account information is updated in real-time as deposits, withdrawals, and trading operations occur.
</Note>


## OpenAPI

````yaml GET /account/{wallet_address}
openapi: 3.1.0
info:
  title: Strike Protocol API
  description: >-
    Strike Protocol is a perpetual futures trading platform that allows users to
    trade with leverage (1-1000x) on various crypto assets. This API provides
    access to trading operations, account management, market data, analytics,
    and user systems.
  version: 1.0.0
  contact:
    name: Strike Protocol
    url: https://strike.markets
  license:
    name: MIT
servers:
  - url: https://api.strike.markets
    description: Production server
security:
  - apiKeyAuth: []
paths:
  /account/{wallet_address}:
    get:
      summary: Get Account Information
      description: Get account balance and transaction information
      operationId: getAccount
      parameters:
        - name: wallet_address
          in: path
          required: true
          description: Ethereum wallet address
          schema:
            type: string
            pattern: ^0x[a-fA-F0-9]{40}$
      responses:
        '200':
          description: Account information retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountResponse'
      security: []
components:
  schemas:
    AccountResponse:
      type: object
      properties:
        balances:
          type: object
          properties:
            withdrawable:
              type: string
            total:
              type: string
            reserved:
              type: string
        deposits:
          type: array
          items:
            type: object
            properties:
              amount:
                type: string
              txHash:
                type: string
              timestamp:
                type: string
                format: date-time
        withdrawals:
          type: array
          items:
            type: object
            properties:
              amount:
                type: string
              txHash:
                type: string
              timestamp:
                type: string
                format: date-time
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: Strike Protocol API key authentication

````