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 Developer > API Keys
  3. Click Create Key
  4. Copy and store your key — it will not be displayed again

Getting credits

Your key needs credits to make billable calls. There are two ways:

  • Subscribe (recommended) — Starter ($49/mo) gets $25/mo credits, Pro ($99/mo) gets $75/mo credits. Credits renew each billing period.
  • Pay-as-you-go — Load credits once via the developer page. Free tier pays 2.5x standard rates.

Operations deduct from monthly subscription credits first, then from your top-up balance. Check your current balance anytime with GET /v1/status.

Full pricing →

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.
IntroductionUse Cases