# Get account info

```
GET /api/v1/account
```

#### Query Parameters

<table><thead><tr><th width="176">Field</th><th width="98">Type</th><th width="95">Need</th><th width="189">Description</th><th>Example</th></tr></thead><tbody><tr><td><code>"account"</code></td><td>string</td><td>required</td><td>Account address</td><td><code>42trU9A5...</code></td></tr></tbody></table>

```
/api/v1/account?account=42trU9A5...
```

#### Response

* Status 200: Successfully retrieved account information

```json
{
  "success": true,
  "data": {
    "balance": "2000.000000",
    "fee_level": 0,
    "maker_fee": "0.00015",
    "taker_fee": "0.0004",
    "account_equity": "2150.250000",
    "available_to_spend": "1800.750000",
    "available_to_withdraw": "1500.850000",
    "pending_balance": "0.000000",
    "pending_interest": "0.000000",
    "spot_collateral": "0.000000",
    "cross_account_equity": "2100.500000",
    "spot_market_value": "250.000000",
    "total_margin_used": "349.500000",
    "cross_mmr": "420.690000",
    "positions_count": 2,
    "orders_count": 3,
    "stop_orders_count": 1,
    "updated_at": 1716200000000,
    "spot_balances": [
      {
        "symbol": "SOL",
        "amount": "1.50000000",
        "available_to_withdraw": "1.00000000",
        "pending_balance": "0.50000000",
        "daily_withdraw_amount_usd": "250.000000",
        "effective_daily_deposit_limit_usd": "50000.000000",
        "effective_daily_withdraw_limit_usd": "250000.000000"
      }
    ]
  },
  "error": null,
  "code": null
}
```

| Field                     | Type                   | Description                                                                                          |
| ------------------------- | ---------------------- | ---------------------------------------------------------------------------------------------------- |
| `'balance'`               | decimal string         | Current account balance, defined as amount of USD in account before settlement                       |
| `'fee_level'`             | integer                | Current fee tier of account, determined by trading volume                                            |
| `'maker_fee'`             | decimal string         | Current maker fee rate of account, determined by trading volume                                      |
| `'taker_fee'`             | decimal string         | Current taker fee rate of account, determined by trading volume                                      |
| `'account_equity'`        | decimal string         | Account balance + unrealized PnL + isolated margin + raw spot market value                           |
| `'available_to_spend'`    | decimal string         | Amount of account equity that is available to used to margin for open positions and orders           |
| `'available_to_withdraw'` | decimal string         | Amount that is available to withdraw out from the exchange                                           |
| `'pending_balance'`       | decimal string         | Amount of account balance in pending status (deposit request is successful, waiting on confirmation) |
| `'total_margin_used'`     | decimal string         | Amount of account equity currently being used to margin for open positions and orders                |
| `'cross_mmr'`             | decimal string         | The maintenance margin required under the cross mode                                                 |
| `'positions_count'`       | integer                | Number of open positions (isolated and cross)                                                        |
| `'orders_count'`          | integer                | Number of open orders across all markets (excludes stop orders)                                      |
| `'stop_orders_count'`     | integer                | Number of open stop orders across markets                                                            |
| `'pending_interest'`      | decimal string         | Accrued loan interest not yet repaid                                                                 |
| `'spot_collateral'`       | decimal string         | Total USD value of spot assets used as collateral for unified margin                                 |
| `'cross_account_equity'`  | decimal string or null | Cross-margin equity after applying unified-margin collateral rules. `null` if not applicable         |
| `'spot_market_value'`     | decimal string         | Raw marked-to-market value of positive spot balances before collateral haircuts                      |
| `'spot_balances'`         | array                  | List of spot asset balances held by the account (see below)                                          |
| `'updated_at'`            | integer                | Timestamp in milliseconds of last account info update                                                |

**Spot Balance Fields**

| Field                                  | Type           | Description                         |
| -------------------------------------- | -------------- | ----------------------------------- |
| `'symbol'`                             | string         | Spot asset symbol                   |
| `'amount'`                             | decimal string | Total amount of the spot asset held |
| `'available_to_withdraw'`              | decimal string | Amount available to withdraw        |
| `'pending_balance'`                    | decimal string | Amount pending confirmation         |
| `'daily_withdraw_amount_usd'`          | decimal string | USD value of withdrawals made today |
| `'effective_daily_deposit_limit_usd'`  | decimal string | Daily deposit limit in USD          |
| `'effective_daily_withdraw_limit_usd'` | decimal string | Daily withdrawal limit in USD       |

* Status 400: Invalid request parameters
* Status 401: Unauthorized access
* Status 500: Internal server error

#### Code Example (Python)

```python
import requests

response = requests.get(
    "/api/v1/account?account=42trU9A5...",
    headers={"Accept": "*/*"},
)

data = response.json()
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://pacifica.gitbook.io/docs/api-documentation/api/rest-api/account/get-account-info.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.