Error handling

{
  "detail": "Authentication required."
}

{
  "detail": "Invalid API key."
}

{
  "error": "bad_request",
  "message": "start_ts is required"
}

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

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

import requests

response = requests.get(url, params=params, headers=headers, timeout=60)

if response.status_code == 429:
    retry_after = int(response.headers.get("Retry-After", 60))
    # time.sleep(retry_after) and retry — see rate-limits.mdx

if not response.ok:
    try:
        payload = response.json()
        msg = payload.get("message") or payload.get("detail") or response.text
    except Exception:
        msg = response.text
    raise RuntimeError(f"API error {response.status_code}: {msg}")

payload = response.json()