Reference
Errors & Rate Limits
30 requests per minute per API key. Errors share one shape:
{
"error": {
"code": "FORBIDDEN",
"message": "Trial limit reached — subscribe to continue",
"timestamp": "2026-07-19T10:39:20.000Z",
"requestId": "..."
}
}Error Codes
| Status | Code | When |
|---|---|---|
| 400 | VALIDATION_ERROR | Address isn't valid for the selected chain (or ?chain= is unknown). |
| 401 | INVALID_SESSION | API key is missing, wrong, or deactivated. |
| 402 | FORBIDDEN | No active plan, inactive billing, or the free trial has been used up. |
| 429 | RATE_LIMIT_EXCEEDED | More than 30 requests/minute on this key. |
| 503 | SERVICE_UNAVAILABLE | Wallet is already being fetched by another request — retry shortly. |