Prediction Router
Getting Started

Authentication

How to get an API key and send it with your requests

Getting a key

  1. Sign in with Google on the dashboard.
  2. Click Create API key.
  3. 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_KEY

Example:

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

FreePro ($19/month)
Requests per minute60600
Requests per month10,000No 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: 8421

When a key goes over a limit, the API returns 429:

  • Over the per-minute limit: RATE_LIMITED with Retry-After: 60.
  • Over the Free monthly limit: QUOTA_EXCEEDED, with Retry-After set 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" } }
StatusCodeMeaning
400VALIDATION_ERRORA query parameter is missing or out of range. The message names the parameter.
401UNAUTHORIZEDThe Authorization header is missing, or the key is invalid or was regenerated
404NOT_FOUNDThe ID doesn't exist on that platform, or the route doesn't exist
405UNSUPPORTED_OPERATIONThe platform doesn't offer this resource (for example, series on Polymarket)
429RATE_LIMITEDOver the per-minute limit for your plan (60 on Free, 600 on Pro)
429QUOTA_EXCEEDEDFree plan monthly limit of 10,000 requests reached
502PLATFORM_ERRORThe exchange returned an error
503PLATFORM_RATE_LIMITEDKalshi is rate limiting us. Retry after the Retry-After header (5 seconds).

Keep your key out of source control and client-side code.