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

StatusCode(s)Meaning
401API_KEY_MISSING · API_KEY_INVALID · API_KEY_REVOKEDNo key, an unknown key, or a revoked key.
403SUBSCRIPTION_INACTIVE · ACCOUNT_SUSPENDED · API_KEY_SCOPE_FORBIDDENNo active paid plan; a suspended account; or a credential issued for the MCP endpoint used on a REST endpoint.
403SIGNALS_API_REQUIRES_PRO · NOT_ENTITLEDThe Signals API needs Pro; or a paid strategy you do not subscribe to.
404NOT_FOUNDThe strategy or position doesn’t exist or isn’t yours.
409NO_SIGNAL · STRATEGY_HALTED · SIGNAL_UNSUPPORTEDSignals 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.
409FEATURE_COMING_SOONA feature that is not available yet: today, creating an external-signal strategy or opening a position with the Trading API.
409already closedModifying or closing a position that’s already closed.
422VALIDATION · INVALID_BODYBad JSON, a missing field, a malformed query value, or an out-of-range asset / size / tp / sl.
429RATE_LIMITEDPer-key rate limit exceeded; see Retry-After.
500INTERNALUnexpected 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.