---
title: "Account status"
method: GET
path: "/status"
tags: ["Account"]
---

# Account status

`GET /status`

## Request

- Base URL: `https://frontrun.vc/v1`
- URL: `https://frontrun.vc/v1/status`
- Auth: API key in header `X-API-Key`

Returns your tier, credit balance (monthly + top-up), tracked account count, daily spend, per-operation pricing at your tier rate, and a 30-day usage breakdown. Free, costs 0 credits. Call this first in any session: it verifies the key works and tells you what each operation will cost before you spend credits.

## Response `200`

Account status.

- object
  - `tier` 'free' | 'starter' | 'pro' | 'enterprise'
  - `mcp_access` boolean
  - `tracked_accounts` integer
  - `balance` object
    - `credits` union: Available credits (number, or "Unlimited" on Enterprise).
      - integer
      - string
    - `monthly_credits` union
      - integer
      - string
    - `topup_credits` integer
  - `daily_spend` object
    - `credits` integer
    - `cap_credits` integer, nullable: Daily cap in credits (null when unlimited).
  - `usage_30d` object
    - `total_calls` integer
    - `total_credits` integer
    - `by_operation` object: Per-operation `{ calls, credits }` map.
  - `pricing_credits` object: Per-operation price list in credits at your tier rate.
  - `rate_multiplier` number: 1.0 for subscribers; 2.5 on the free tier.

## Other responses

- `401`: Missing, invalid, inactive, or expired API key.
- `402`: Insufficient credits for this operation. Top up from the developer page or enable auto-refill.
- `429`: Rate limit or daily credit cap reached. Retry after the indicated reset time.

---

[API](https://skmtc.dev/frontrun/apis/frontrun-api.md) · [All operations](https://skmtc.dev/frontrun/apis/frontrun-api/llms.txt) · [OpenAPI document](https://skmtc.dev/frontrun/apis/frontrun-api/revisions/6880b29e94c9?raw)