REST API
Errors
HTTP status codes and the error format.
Errors use standard HTTP status codes and always have the same shape:
{
"error": {
"code": "INVALID_PARAM",
"message": "interval must be one of 1min, 5min, 15min, 30min, 60min, 1d, 1w, 1mo.",
"param": "interval"
}
}code is stable, so branch on it. message is for people and may change. param is there when one parameter caused the error.
| Status | Code | Meaning |
|---|---|---|
| 400 | INVALID_PARAM | A parameter is missing, the wrong type, or out of range. |
| 401 | AUTH_REQUIRED | No API key was sent. |
| 401 | INVALID_API_KEY | The API key is wrong or revoked. |
| 403 | PLAN_LIMIT | Your plan doesn’t include this endpoint, option or history. |
| 404 | NOT_FOUND | No resource with that ID. |
| 404 | INVALID_SYMBOL | No listed company with that symbol or ISIN. |
| 409 | AMBIGUOUS_IDENTIFIER | The identifier matches more than one security. |
| 429 | RATE_LIMITED | Daily or per-minute limit reached. See Retry-After. |
| 500 | SERVER_ERROR | Something went wrong on our side. Retry with backoff. |
| 503 | UNAVAILABLE | Temporarily unavailable, e.g. during maintenance. |
Every response has an X-Request-Id header. Include it when you contact support.