Authentication
0xRadar uses an API key passed in the X-API-Key header. All v1 endpoints except /health and /chains require authentication.
Getting an API key
- Sign up at 0xradar.app
- Navigate to Dashboard → API Keys
- Click Generate Key
- Copy the key — it is shown only once
Store your API key in a secrets manager. Never commit it to version control.
Using the key
curl -H "X-API-Key: 0xr_pro_YOUR_KEY_HERE" \
https://api.0xradar.app/v1/wallet/0x.../balances?chain=ethereum
Query parameter ?api_key= is not supported for security reasons (URL exposure in logs, browser history).
Tiers
| Tier | Rate Limit | Daily Cap | Best For |
|---|
| Free | 10 requests/min | 100/day | Prototyping, personal dashboards |
| Dev | 100 requests/min | 10,000/day | Startups, small integrations |
| Pro | 600 requests/min | 100,000/day | Production apps, high-frequency polling |
Error responses
| Status | Meaning | Resolution |
|---|
| 401 Unauthorized | Missing or invalid key | Check header spelling and key validity |
| 403 Forbidden | Key valid but tier scope denied | Upgrade tier |
| 429 Too Many Requests | Rate limit exceeded | Back off and retry with exponential jitter |
| 503 Service Unavailable | Rate limiter temporarily down | Retry after 5-10 sec |
Next steps