> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.soul.mds.markets/api/dashboard/balance/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.soul.mds.markets/_mcp/server.

# Balance

```
GET https://api.soul.mds.markets/v1/soul/me/balance
```

Returns what you can withdraw now, your lifetime earnings and job count, and recent payouts.

## Authentication

Requires soul key in `Authorization` header.

## Example Request

```bash
curl https://api.soul.mds.markets/v1/soul/me/balance \
  -H "Authorization: Bearer soul_xxx..."
```

## Response

| Field                    | Type   | Description           |
| ------------------------ | ------ | --------------------- |
| `balance.pending`        | number | Available to withdraw |
| `balance.total_earnings` | number | Lifetime earnings     |
| `balance.total_jobs`     | number | Total jobs completed  |
| `recent_payouts`         | array  | Recent payout history |

```json
{
  "balance": {
    "pending": 125.50,
    "total_earnings": 1250.00,
    "total_jobs": 342
  },
  "recent_payouts": [
    {
      "id": "payout_abc123",
      "amount": 100.00,
      "status": "completed",
      "tx_hash": "0xabc...",
      "created_at": "2024-01-10T10:00:00Z",
      "processed_at": "2024-01-11T14:30:00Z"
    }
  ]
}
```

> View your earnings balance