API Reference
GET /v1/status

GET /v1/status

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

Cost: Free

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

Response

{
  "balance": {
    "cents": 4850,
    "dollars": "48.50"
  },
  "tracked_accounts": 12,
  "usage_30d": {
    "total_calls": 347,
    "total_spent_cents": 1150,
    "total_spent_dollars": "11.50",
    "by_operation": {
      "follows_new": { "calls": 280, "cost_cents": 1400 },
      "track_setup": { "calls": 12, "cost_cents": 120 },
      "convergence": { "calls": 30, "cost_cents": 300 },
      "follows_snapshot": { "calls": 25, "cost_cents": 50 }
    }
  },
  "pricing": {
    "track_setup": 10,
    "follows_new": 5,
    "follows_snapshot": 2,
    "convergence": 10,
    "classification": 3
  }
}

Response fields

FieldTypeDescription
balanceobjectCurrent credit balance in cents and dollars.
tracked_accountsintegerNumber of accounts currently being monitored.
usage_30dobjectUsage breakdown for the last 30 days, grouped by operation.
pricingobjectCurrent per-operation pricing in cents.