Skip to main content
Intention’s API returns structured error responses with stable codes that clients can branch on. This page will document the error model — the response shape, the error code namespace, and the categories used by REST, WebSocket, and integration endpoints.
Status: not yet published. The error code list will be finalized alongside the first stable API release. Treat the descriptions below as planning documentation.

​
What this page will contain

  • Response shape. The canonical JSON structure of an error response on REST and WebSocket.
  • Categories. Validation errors, signing errors, sequencing errors, rate-limit errors, market-state errors, and protocol-level errors.
  • Stable codes. The full list of error codes, each with a short description and a pointer to the relevant policy or convention page.
  • Retryability. Which errors are retryable, which are not, and how to back off safely after a 429 or a transient 503.
  • Cross-references. How errors interact with nonces, signing, tick and lot, and rate limits.
For early integration questions, email contact@intention.xyz.