DocsErrors

Reference

Errors

Every failure has a stable code and a message that says how to fix it. No error is ever charged a credit.

Error body

REST and MCP errors share one shape. Validation errors add the path of each bad field.

{
  "detail": {
    "code": "INVALID_REQUEST",
    "message": "positions[0]: holding quantity must be non-zero",
    "errors": [{ "path": "positions[0]", "msg": "holding quantity must be non-zero" }]
  }
}

Codes

HTTPCodeMeaningCharged
400KEY_IN_QUERYkey sent in the URLNo
400INVALID_JSONMCP body is not a JSON-RPC objectNo
401AUTHENTICATION_REQUIREDmissing or invalid key where one is neededNo
403PLAN_REQUIREDfeature needs a higher plan; see required_planNo
404NOT_FOUNDno route at that pathNo
404KEY_NOT_FOUNDno such key on this account, or it is already revokedNo
405METHOD_NOT_ALLOWEDwrong HTTP method for the routeNo
409BILLING_DISABLEDpaid plans are not open yet; the free plan still worksNo
409ALREADY_SUBSCRIBEDthis key already has a paid plan; use the billing portalNo
409NO_BILLING_ACCOUNTstart a paid plan before managing billingNo
409KEY_LIMITthe account already has 10 active keys; revoke one firstNo
409LAST_KEYthe account's last active key; create or rotate before revokingNo
410RECOVERY_LINK_INVALIDrecovery link expired or already usedNo
422INVALID_REQUESTbody failed validation; see errors[].pathNo
422PRICES_REQUIREDno history and not a demo tickerNo
422POSITION_LIMITmore tickers or positions than this caller's per-call limitNo
422INSTRUMENT_NOT_ELIGIBLE_AT_TIMEno valuation closeNo
429RATE_LIMITEDdaily limit used; Retry-After seconds until 00:00 UTCNo
503DEPENDENCY_UNAVAILABLEkeys or database downNo
503BILLING_PROVIDER_ERRORthe payment provider did not answer; retry laterNo
503RECOVERY_UNAVAILABLErecovery email is not switched on yetNo

Retries

  • 429 RATE_LIMITED carries Retry-After: the seconds until the daily limit resets at 00:00 UTC.
  • 503 errors are temporary. Retry with backoff.
  • 4xx errors other than 429 fail the same way every time until the request changes.

Null values are not errors

A factor Creo cannot compute for a holding comes back null with a reason, inside a successful response. See Missing data.