Authentication
How to get and use your PredictorSDK API key.
PredictorSDK uses scoped API keys for authentication. Each key is scoped with permissions that control which endpoints you can access.
Getting an API key
- Sign up at app.predictorsdk.com
- Navigate to API Keys in your dashboard
- Click Create API Key and give it a name
- Copy the key immediately — it won't be shown again
Using your API key
Include the key in the Authorization header as a Bearer token:
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.predictorsdk.com/v1/matching-markets/sports"Or use the TypeScript SDK:
import { PredictorSDKClient } from "@predictorsdk/client";
const client = new PredictorSDKClient({
token: "YOUR_API_KEY",
});See SDK Installation for all supported languages.
Permissions
API keys are created with scoped permissions:
| Permission | Grants access to |
|---|---|
markets.matching.read | GET /v1/matching-markets/sports, GET /v1/matching-markets/sports/lookup |
markets.read | GET /v1/markets, GET /v1/categories, GET /v1/markets/{market_id} |
events.read | GET /v1/events/{event_id} |
crypto.prices.read | GET /v1/crypto-prices/binance |
polymarket.wallet.read | GET /v1/polymarket/wallet |
polymarket.positions.read | GET /v1/polymarket/wallet/positions |
Key management
You can manage your keys from the dashboard at app.predictorsdk.com. Create, revoke, or reroll keys directly from the API Keys page.
Rate limits
If a key hits an enforced limit, the API returns 429 with Retry-After in
seconds. Authenticated responses also include X-RateLimit-Limit,
X-RateLimit-Remaining, and X-RateLimit-Reset; reset is a Unix timestamp in
seconds.
X-RateLimit-Limit is your plan's rate_limit_per_min over a rolling
60 seconds, and it is the number to pace against. X-RateLimit-Remaining is
advisory only — the budget recovers continuously rather than refilling at
X-RateLimit-Reset, so it can repeat or even increase while you are spending
it. See Error Handling for
how to build a limiter that works, and for retry guidance.