Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.0xradar.app/llms.txt

Use this file to discover all available pages before exploring further.

​
Rate Limits

Rate limits are enforced per API key. Exceeding a limit returns 429 Too Many Requests.

​
Limits by tier

TierRequests / minuteRequests / day
Free10100
Dev10010,000
Pro600100,000
Limits reset on a rolling window.

​
Handling 429

When you hit a limit, back off and retry with exponential jitter: 
import time, random, httpx

def get_with_backoff(url, headers, params, max_retries=3):
    for attempt in range(max_retries):
        r = httpx.get(url, headers=headers, params=params)
        if r.status_code != 429:
            return r
        sleep = (2 ** attempt) + random.uniform(0, 1)
        time.sleep(sleep)
    raise Exception("Rate limited")

​
Tips

  • Cache /chains — it rarely changes
  • Use /portfolio instead of looping /balances across chains
  • Consider webhooks (Phase 2) instead of polling for alerts

​
Error response

{"detail":"Rate limit exceeded: 100/min for tier 'dev'. Retry after 42s."}
Response header: Retry-After: 42