Skip to main content

Authentication

All API requests authenticate with a single header:

curl -H "X-Api-Key: pb_yourkey" https://polybk.com/v1/coverage

Creating keys​

Keys are created in your dashboard. You can have multiple keys — label them by project (my-bot, backtester) and revoke any of them at any time.

Keys are shown once

The full key is displayed only at creation. Store it immediately — the dashboard shows only the prefix afterwards (e.g. pb_a1b2c3…).

Rules​

  • One header: X-Api-Key: <key>. No OAuth, no tokens-in-URL.
  • Treat keys like passwords. Anyone with your key can use your plan's quota.
  • Lost a key? Revoke it in the dashboard and create a new one — takes seconds.

Rate limits​

Limits are per key, by plan:

PlanRequests / minute
Starter300
Pro600

Exceeding the limit returns 429 — wait a minute and retry. For bulk work, prefer /v1/windows.csv (one request downloads a whole market window) over row-by-row calls.