Rate limits

curl -s -H "X-API-Key: $POLYORDERBOOKS_API_KEY" \
  "https://api.polyorderbooks.com/v1/usage" | jq

{
  "plan": "starter",
  "organization": "acme-research",
  "limits": {
    "requests_per_minute": 60,
    "requests_remaining": 55,
    "granularity_allowed": "60s",
    "max_history_days": 7,
    "data_points": {
      "metrics": true,
      "prices": true,
      "books": true
    }
  },
  "reset_at": 1754140860
}

{
  "detail": "Rate limit exceeded. Please try again later."
}

{
  "detail": "Daily request limit exceeded. Limit resets at midnight UTC."
}

{
  "error": "forbidden",
  "message": "Resolution '1s' is not available on your starter plan. Finest allowed: 60s."
}

{
  "error": "forbidden",
  "message": "History window exceeds your starter plan (max 7 days). Earliest allowed start_ts is …"
}

import time
import requests

def get_with_retry(url, *, headers, params, max_retries=5):
    delay = 1.0
    for attempt in range(max_retries):
        response = requests.get(url, headers=headers, params=params, timeout=60)
        if response.status_code == 429:
            retry_after = int(response.headers.get("Retry-After", delay))
            time.sleep(retry_after)
            delay = min(delay * 2, 30.0)
            continue
        response.raise_for_status()
        return response.json()
    response.raise_for_status()