Authentication
How to get an API key and send it with your requests
Getting a key
- Sign in with Google on the dashboard.
- Click Create API key.
- Copy the key and store it somewhere safe. It is shown once.
Keys are only issued from the dashboard. There is no signup endpoint in the API.
Using your key
Send the key as a Bearer token on every request:
Authorization: Bearer YOUR_API_KEYExample:
curl "https://api.predictionrouter.keronlabs.com/v1/markets?platform=kalshi" \
-H "Authorization: Bearer YOUR_API_KEY"Rotating a key
If a key leaks or you lose it, click Regenerate on the dashboard. You get a new key and the old one stops working immediately. We store only a SHA-256 hash of each key, so a lost key can't be recovered, only replaced.
Plans and limits
| Free | Pro ($19/month) | |
|---|---|---|
| Requests per minute | 60 | 600 |
| Requests per month | 10,000 | No cap |
The monthly count is per key holder and resets at 00:00 UTC on the 1st. Only successful requests count toward it.
On the Free plan, every response carries two headers so you can track the monthly quota:
X-Quota-Limit: 10000
X-Quota-Remaining: 8421When a key goes over a limit, the API returns 429:
- Over the per-minute limit:
RATE_LIMITEDwithRetry-After: 60. - Over the Free monthly limit:
QUOTA_EXCEEDED, withRetry-Afterset to the seconds left until the monthly reset.
Upgrade to Pro from the dashboard. The higher limits apply to your existing key right away, and you can cancel at any time. Pro stays active until the end of the billing period.
Errors
Every error has the same shape:
{ "error": { "code": "VALIDATION_ERROR", "message": "limit: Number must be less than or equal to 100" } }| Status | Code | Meaning |
|---|---|---|
| 400 | VALIDATION_ERROR | A query parameter is missing or out of range. The message names the parameter. |
| 401 | UNAUTHORIZED | The Authorization header is missing, or the key is invalid or was regenerated |
| 404 | NOT_FOUND | The ID doesn't exist on that platform, or the route doesn't exist |
| 405 | UNSUPPORTED_OPERATION | The platform doesn't offer this resource (for example, series on Polymarket) |
| 429 | RATE_LIMITED | Over the per-minute limit for your plan (60 on Free, 600 on Pro) |
| 429 | QUOTA_EXCEEDED | Free plan monthly limit of 10,000 requests reached |
| 502 | PLATFORM_ERROR | The exchange returned an error |
| 503 | PLATFORM_RATE_LIMITED | Kalshi is rate limiting us. Retry after the Retry-After header (5 seconds). |
Keep your key out of source control and client-side code.