Rate Limits & Plans

Limits are enforced per API key. Each plan has a per-second burst limit (requests-per-second) and a monthly request quota. Arb and EV signals have their own separate monthly quota.

Plan Limits

Metric

Free

Dev

$49/mo

Pro

$249/mo

Enterprise

Custom

Burst

1 req/sec

20 req/sec

100 req/sec

Custom

Monthly

1,000/mo

1M/mo

5M/mo

Unlimited

Signals

—

500/mo

5,000/mo

Unlimited

Support

Discord

Priority

Dedicated

Need more? View all plan details or email api@predictionhunt.com for enterprise pricing.

Rate Limit Headers

Every response includes these headers so you can track your usage:

X-RateLimit-LimitYour plan's per-second request limit.

X-RateLimit-RemainingRequests remaining in the current second.

X-RateLimit-ResetUnix timestamp when the current window resets.

Retry-AfterSeconds to wait before retrying (only on 429 responses).

Handling 429 Too Many Requests

When you exceed the burst limit, the API returns a 429 with a Retry-After header. Use exponential backoff to respect this limit:

exponential backoff (python)

python

import time, requests

def call_with_backoff(url, headers, max_retries=5):
    for attempt in range(max_retries):
        resp = requests.get(url, headers=headers)
        if resp.status_code == 429:
            wait = int(resp.headers.get("Retry-After", 2 ** attempt))
            time.sleep(wait)
            continue
        resp.raise_for_status()
        return resp.json()
    raise Exception("Max retries exceeded")

Upgrade Your Plan

Hitting your limits? Upgrade on the pricing page — changes take effect immediately.

View Plans & Pricing