API · Errors
Errors
Every error returns a JSON envelope with a machine-readable error code and a human message. Some errors add fields, listed below.
Error envelope
{ "error": "API_KEY_INVALID", "message": "Invalid API key." }Status codes
| Status | Code(s) | Meaning |
|---|---|---|
| 401 | API_KEY_MISSING · API_KEY_INVALID · API_KEY_REVOKED | No key, an unknown key, or a revoked key. |
| 403 | SUBSCRIPTION_INACTIVE · ACCOUNT_SUSPENDED · API_KEY_SCOPE_FORBIDDEN | No active paid plan; a suspended account; or a credential issued for the MCP endpoint used on a REST endpoint. |
| 403 | SIGNALS_API_REQUIRES_PRO · NOT_ENTITLED | The Signals API needs Pro; or a paid strategy you do not subscribe to. |
| 404 | NOT_FOUND | The strategy or position doesn’t exist or isn’t yours. |
| 409 | NO_SIGNAL · STRATEGY_HALTED · SIGNAL_UNSUPPORTED | Signals API: no signal for the current bar (retryable says whether asking again can get one, retryAfterMs the suggested wait); a strategy that is halted, for example until its builder retrains its model (close any position you hold for it); or a backtest-only strategy, which has no live signal. |
| 409 | FEATURE_COMING_SOON | A feature that is not available yet: today, creating an external-signal strategy or opening a position with the Trading API. |
| 409 | already closed | Modifying or closing a position that’s already closed. |
| 422 | VALIDATION · INVALID_BODY | Bad JSON, a missing field, a malformed query value, or an out-of-range asset / size / tp / sl. |
| 429 | RATE_LIMITED | Per-key rate limit exceeded; see Retry-After. |
| 500 | INTERNAL | Unexpected server error. |
409 NO_SIGNAL (Signals API)
{
"error": "NO_SIGNAL",
"message": "The bar that just closed is not available yet. Retry shortly.",
"retryable": true,
"retryAfterMs": 5000
}In a Signals API batch, each failed id carries its own error as an object: { "code": "NOT_ENTITLED", "message": "…" }.
Siloing & opacity
Two security rules shape these errors. Siloing: a key only ever sees its owner's data, so referencing another user's strategy or position returns 404, never their data. Opacity: the Signals API returns a strategy's results, its signal and the order to place for it (never its underlying rules), and a paid strategy you do not subscribe to returns 403 NOT_ENTITLED.