GET /v1/status

Returns your tier, credit balance, tracked account count, daily spend, and 30-day usage breakdown.

Cost: Free

curl https://frontrun.vc/v1/status \
  -H "X-API-Key: your_api_key"

Response

{
  "tier": "pro",
  "mcp_access": true,
  "tracked_accounts": 12,
  "balance": {
    "credits": 9840,
    "monthly_credits": 8400,
    "topup_credits": 1440
  },
  "daily_spend": {
    "credits": 320,
    "cap_credits": 80000
  },
  "usage_30d": {
    "total_calls": 347,
    "total_credits": 6428,
    "by_operation": {
      "follows_new": { "calls": 280, "credits": 4480 },
      "track_setup": { "calls": 12, "credits": 48 },
      "convergence": { "calls": 30, "credits": 1800 },
      "follows_snapshot": { "calls": 25, "credits": 100 }
    }
  },
  "pricing_credits": {
    "track_setup": 4,
    "follows_new": 16,
    "follows_snapshot": 4,
    "convergence": 60,
    "classification": 16
  },
  "rate_multiplier": 1.0
}

Response fields

Field	Type	Description
`tier`	string	Your subscription tier: `free`, `pro`, or `enterprise`.
`mcp_access`	boolean	Whether your plan includes MCP access.
`tracked_accounts`	integer	Number of accounts currently being monitored.
`balance`	object	Available credits. `monthly_credits` is your subscription allowance (resets each billing period); `topup_credits` is purchased balance (never expires); `credits` is the total.
`daily_spend`	object	Credits spent today and your daily cap (`cap_credits` is `null` when no cap applies).
`usage_30d`	object	Usage for the last 30 days, grouped by operation, in credits.
`pricing_credits`	object	Current per-operation pricing in credits, at your tier's rate.
`rate_multiplier`	number	`2.5` on the free tier, `1.0` for subscribers.

Use Cases Track Accounts