# engy account read API

Programmatic, read-only access to your account — check your balance, spending/usage, and the live model catalog. Requires a read token (rk-engy-…) issued from the dashboard; it can read these details but cannot spend, and is separate from your sk-engy- inference key.

## Auth
Every request: `Authorization: Bearer rk-engy-<your read token>`
Issue an account token in the dashboard → Account tokens. Shown once; cannot spend.
Rate limit: 120 requests per minute per token (429 with Retry-After when exceeded).

## Endpoints
GET /api/v1/balance — Current balance and available (post-holds) balance in µUSD.
GET /api/v1/usage — Requests and spend, aggregated by day and by model.
  ?days — window in days: 7 or 30 (default 30)
  ?model — optional filter
GET /api/v1/models — Live model catalog with per-1k-token pricing and context limits.

## Example
```
curl -H 'Authorization: Bearer rk-engy-…' https://engy.ai/api/v1/balance
```

Responses are `{ "data": …, "meta": … }`; errors are `{ "error": { "code", "message" } }`.
Money is integer micro-USD (1 USD = 1_000_000). A `_usd` string is included for convenience.