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

Sign up or log in at frontrun.vc (opens in a new tab)
Navigate to Developer > API Keys
Click Create Key
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 - Pro ($99/mo, pay upfront) includes API + MCP access and 10,000 credits every month. Credits renew each billing period.
Top up - Buy additional credit packs via the developer page. Top-up credits never expire.

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 credits",
  "required_credits": 16,
  "balance_credits": 4,
  "monthly_credits": 0,
  "topup_credits": 4,
  "tier": "free",
  "top_up": "https://frontrun.vc/api/billing"
}

Credit balance is insufficient for the requested operation. Top up (or enable auto-refill) 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.

Introduction Use Cases