API reference
Your plan and usage
Your key's plan, per-second limit and this month's usage. Not counted as a data request, but it does pass through the per-second limit.
GET
/api/public/v1/rate-limitAPI key requiredGet plan and usage
The sample values are an example; call it with your key to see yours.
This endpoint takes no parameters.
Request
Request
curl -s 'https://api.thepredictionmarkets.com/api/public/v1/rate-limit' \
-H 'X-API-Key: tpm_demo_key_authorized_2026'Response
Example 200 response. Values are illustrative and change over time.
200 OK
{
"plan": "tier_1",
"plan_label": "Tier 1",
"requests_per_second": {
"limit": 10,
"used": 1
},
"monthly": {
"limit": 100000,
"used": 2380,
"period": "202610"
}
}Response fields
| Field | Type | Description |
|---|---|---|
| plan | string | Plan key, same as the X-RateLimit-Tier header. |
| plan_label | string | null | Display name. |
| requests_per_second.limit | integer | null | Requests allowed per second. |
| requests_per_second.used | integer | Used in the current second. |
| monthly.limit | integer | null | Monthly quota; null means no monthly quota. |
| monthly.used | integer | Requests used this month. |
| monthly.period | string | The month, as YYYYMM (UTC). |
Errors
| HTTP | Code | When |
|---|---|---|
| 503 | upstream.unavailable | Usage counters are briefly unavailable. |
| 401 | auth.missing_key | No X-API-Key header was sent. |
| 401 | auth.invalid_key | The key is wrong or was revoked. |
| 429 | rate_limit.per_second | Too many requests this second. Wait for Retry-After. |
503 upstream.unavailable
{
"error": {
"code": "upstream.unavailable",
"message": "Usage counters are unavailable; try again shortly.",
"request_id": "0f8969a6-0968-4d7c-9cbb-de379e8c19c4"
}
}All codes are listed on the errors page.
Try it
Runs a live request from your browser. Pre-filled with the shared demo key (5 requests per second for everyone); paste your own key for steadier results.
HTTP: —Time: —Rows: —Remaining this second: —Request: —
Press Send to run this request.Related
Build with TPM
Get your free API key
One key gives you Kalshi and Polymarket events, prices with freshness, price history, cross-venue gaps and the live quotes WebSocket.