Authentication

Authentication

All API requests require an API key passed via the X-API-Key header.

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

Getting an API key

  1. Sign up or log in at frontrun.vc (opens in a new tab)
  2. Navigate to Settings > API
  3. Click Generate API Key
  4. Copy and store your key — it will not be displayed again
  5. Load credits to your balance

Operations are deducted from your credit balance. Check your current balance anytime with GET /v1/status.

Error responses

401 Unauthorized

{
  "error": "Missing X-API-Key header",
  "docs": "https://frontrun.vc/docs/api"
}

The X-API-Key header is missing, or the key is invalid or inactive.

402 Payment Required

{
  "error": "Insufficient balance",
  "required_cents": 5,
  "balance_cents": 0,
  "top_up": "https://frontrun.vc/api/billing"
}

Credit balance is insufficient for the requested operation. Load more credits to continue.

Security

  • API keys are bearer tokens. Treat them as secrets.
  • Do not expose keys in client-side code, public repositories, or browser requests.
  • Rotate keys immediately if compromised via your dashboard.
  • All API traffic is encrypted over HTTPS.
IntroductionPricing