---
title: Usage & Limits
description: What your account is consuming and where the ceilings are.
---

### GET /account

One endpoint for the whole account picture: identity, plan, entitlements, and live consumption against them — an agent needs a single small read to know where it stands.

Authenticate with `x-api-key: <API key>` or `Authorization: Bearer <session token>`.

**Response — `200`**

```json
{
  "id": "acct_01j8xq2v9…",
  "email": "operator@example.com",
  "plan": "free",
  "created_at": "2026-07-28T09:12:00Z",
  "limits": {
    "active_deployments": 3,
    "concurrent_backtests": 3,
    "requests_per_day": 10000,
    "api_keys": 10
  },
  "usage": {
    "period": "2026-07-28",
    "requests": { "used": 1893, "limit": 10000 },
    "deployments": { "active": 2, "limit": 3 },
    "backtests": { "running": 0, "limit": 3 },
    "by_key": [
      { "key_id": "key_01j8xq2v9…", "api_key_start": "st_live_a1b2c3...", "requests": 1240 },
      { "key_id": "key_01j8xr8m1…", "api_key_start": "st_live_d4e5f6...", "requests": 653 }
    ]
  }
}
```

`usage.period` is the current UTC day; [what counts against budget](/reference/rate-limits) is defined with the limits. Each row includes the API key's ID and its non-secret `api_key_start`, without exposing the full secret.

### GET /account/usage

Returns the same live `usage` object directly when identity and plan details are not needed.

**Response — `200`**

```json
{
  "period": "2026-07-28",
  "requests": { "used": 1893, "limit": 10000 },
  "deployments": { "active": 2, "limit": 3 },
  "backtests": { "running": 0, "limit": 3 },
  "by_key": [
    { "key_id": "key_01j8xq2v9…", "api_key_start": "st_live_a1b2c3...", "requests": 1240 }
  ]
}
```

Endpoint availability is checked against the unified API OpenAPI document. Routes
that are not in the live spec are marked **Coming soon**. See the full generated
reference at [/openapi](/openapi).

## Plans & pricing

| | Free | Pro |
|---|---|---|
| Price | **$0** | announced at launch |
| Active deployments | 3 | 6 |
| Concurrent backtests | 2 | 6 |
| Requests / day | 10,000 | 100,000 |
| Context data reads | standard | priority + bulk CSV |

The Free tier is real, not a trial: 3 deployments, full API access, paper trading, backtests — enough to run a small live desk at $0. Pro pricing is set at launch and will be published here first; there are no per-request or per-deployment-hour charges in either tier at launch. (These entitlement numbers are the design target and are being confirmed against current account tiers — tracked in the [design log](/reference/design-log).)

Plan changes happen at [account.superior.trade](https://account.superior.trade); the API reflects them immediately. The `usage` object is deliberately shaped so meters can be added later without breaking readers.