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

# Account

> Balance, budget, and statistics

## Get Balance

<ParamField query="GET" path="/balance">
  Get raw wallet balance (live from chain).
</ParamField>

### Example

```bash theme={null}
curl "https://luckylobster.io/api/agent/v1/balance" \
  -H "Authorization: Bearer ll_..."
```

```json Response theme={null}
{
  "success": true,
  "data": {
    "usdc": 93.16,
    "address": "0x1234...",
    "walletType": "proxy"
  }
}
```

| Field        | Description                            |
| ------------ | -------------------------------------- |
| `usdc`       | USDC balance for trading               |
| `walletType` | `proxy` (Polymarket) or `eoa` (direct) |

***

## Get Budget

<ParamField query="GET" path="/budget">
  Get how much you can spend. **Check this before placing orders.**
</ParamField>

Budget = min(wallet balance, fixed limit, % of wallet)

### Example

```bash theme={null}
curl "https://luckylobster.io/api/agent/v1/budget" \
  -H "Authorization: Bearer ll_..."
```

```json Response theme={null}
{
  "success": true,
  "data": {
    "usdc": 46.58,
    "limitedBy": "percent",
    "wallet": 93.16,
    "config": {
      "fixedLimit": null,
      "budgetPercent": 50,
      "maxPositionValue": null,
      "used": 0
    }
  }
}
```

| Field       | Description                                                             |
| ----------- | ----------------------------------------------------------------------- |
| `usdc`      | **What you can spend** (accounts for all limits)                        |
| `limitedBy` | Why you're capped: `wallet`, `fixed_limit`, `percent`, `position_limit` |
| `wallet`    | Raw wallet balance                                                      |
| `config`    | Your budget settings (configured at Dashboard > Manage Agents)          |

***

## Get Stats

<ParamField query="GET" path="/stats">
  Get trading performance statistics.
</ParamField>

### Example

```bash theme={null}
curl "https://luckylobster.io/api/agent/v1/stats" \
  -H "Authorization: Bearer ll_..."
```

```json Response theme={null}
{
  "success": true,
  "data": {
    "totalOrders": 150,
    "filledOrders": 142,
    "totalVolume": 25000.00,
    "realizedPnL": 1250.75,
    "unrealizedPnL": 320.50,
    "winRate": 62.5,
    "avgTradeSize": 166.67
  }
}
```