INVALID_REQUEST | 400 | - | NEVER | The body, a path parameter or a header is malformed or fails validation. field_violations names invalid body fields; for an RFQ leg whose market refuses new positions now, /legs/{i}/outcome_id, with the reason in the message. NEVER means the same request will fail again; the leg’s market can become eligible later, so before a new RFQ read its live eligibility and, for a Combo leg, combo.state and combo.reason (combo.opens_at is set only for an OUTSIDE_WINDOW refusal whose window has a known time). |
INVALID_QUERY | 400 | - | NEVER | A query parameter is malformed, out of range or not accepted by this operation. field_violations names it. |
INVALID_CURSOR | 400 | - | NEVER | The cursor is malformed or was issued for a different query. |
INVALID_IDEMPOTENCY_KEY | 400 | - | NEVER | The command needs exactly one lowercase UUIDv7 Idempotency-Key header; confirm takes none. |
ORIGIN_REQUIRED | 400 | - | NEVER | A browser route needs exactly one Origin header. |
SUBPROTOCOL_REQUIRED | 400 | 1008 | NEVER | The stream request did not negotiate a supported subprotocol or extension. |
UNAUTHENTICATED | 401 | - | NEVER | The credential is missing, invalid, expired or revoked. |
FORBIDDEN | 403 | - | NEVER | The credential is valid but lacks the scope, permission or role this operation needs. |
ORIGIN_NOT_ALLOWED | 403 | - | NEVER | The browser origin is not allowed to call this route. |
ACCESS_REQUIRED | 403 | - | NEVER | Totalis is invite-only: redeem an invite code, or have a partner admit the wallet, before creating an account. |
NOT_FOUND | 404 | - | NEVER | The resource does not exist or is not visible to this credential. |
IDENTITY_NOT_FOUND | 404 | - | NEVER | The account has no venue identity yet; bind the embedded wallet first. |
QUOTE_NOT_FOUND | 404 | - | NEVER | The quote does not exist. |
IDEMPOTENCY_KEY_REUSED | 409 | - | NEVER | The idempotency key was already used with different input. |
STATE_CONFLICT | 409 | - | REFRESH | The resource changed and no longer admits this request. |
STALE_CURSOR | 409 | - | REFRESH | The cursor belongs to an older catalog or browse generation; restart from the first page. |
CURSOR_EXPIRED | 409 | - | REFRESH | The account-read snapshot behind this cursor expired or its scope changed; restart from the first page. |
CURSOR_RESET | 409 | 1008 | REFRESH | The realtime cursor is no longer replayable; take a fresh snapshot. |
SECRET_UNAVAILABLE | 409 | - | NEVER | The one-time secret was already issued and cannot be shown again. |
ROTATION_IN_PROGRESS | 409 | - | REFRESH | Another rotation of this key is in progress. |
RFQ_NOT_CANCELLABLE | 409 | - | NEVER | The RFQ has progressed past cancellation. |
RFQ_NOT_OPEN | 409 | - | REFRESH | The RFQ is no longer open. |
RFQ_GENERATION_STALE | 409 | - | REFRESH | The RFQ generation the quote targets was superseded. |
RFQ_GENERATION_IN_FLIGHT | 409 | - | REFRESH | The RFQ generation is changing; re-read the RFQ. |
QUOTE_EXPIRED | 409 | - | REFRESH | The quote is past its accept_before or expired. |
QUOTE_CANCELLED | 409 | - | REFRESH | The maker cancelled the quote. |
QUOTE_REPLACED | 409 | - | REFRESH | A newer quote from the same maker replaced this one. |
QUOTE_SIGNER_CHANGED | 409 | - | REFRESH | The maker’s quote signer changed after the quote was signed. |
QUOTE_CAPACITY_EXCEEDED | 409 | - | REFRESH | The maker’s current capacity does not cover the quote. |
CORE_ACCOUNT_NOT_READY | 409 | - | REFRESH | The HyperCore account is not an initialized user. |
CORE_ACCOUNT_ACTIVATION_REQUIRED | 409 | - | NEVER | The HyperCore account does not exist yet, and its first credit pays a 1 USDC activation fee. Resend with activation_fee_accepted once the user accepts it. |
CORE_MOVE_IN_FLIGHT | 409 | - | REFRESH | A HyperCore transfer for this account is still in flight. |
ACCEPTANCE_IN_FLIGHT | 409 | - | REFRESH | Another entry acceptance by this account still awaits its maker or its trade, and an account has one in flight at a time. Nothing was created; once that acceptance’s operation ends, accept a fresh quote. |
GOLDEN_CASHOUT_REFUSED | 409 | - | NEVER | This position was a golden gift, which is never sold back to its maker, whoever holds it now. |
INVALID_SIGNATURE | 422 | - | NEVER | The signature does not verify for the signed terms. |
WALLET_CONTRACT_UNSUPPORTED | 422 | - | NEVER | Wallet sign-in needs an externally owned account; this address holds contract code. |
WRONG_AUTHORITY | 422 | - | REFRESH | The signature is not from the current authority: the taker wallet for an accept, or the maker’s current quote signer for a confirm. |
KEY_LIMIT_REACHED | 422 | - | NEVER | The owner already holds the maximum number of API keys. |
RATE_LIMITED | 429 | - | BACKOFF | The request quota for this credential or route is exhausted. |
CONNECTION_LIMIT | 429 | - | BACKOFF | The stream connection limit is reached. |
RFQ_INTENT_LIMIT | 429 | - | BACKOFF | The account has too many open RFQs. |
QUOTE_EXPOSURE_LIMIT | 429 | - | BACKOFF | The maker’s open quote exposure is at its limit. |
DEPENDENCY_STALE | 503 | 1013 | BACKOFF | A projection or upstream the request depends on (chain projection, HyperCore state, database) is behind its freshness bound or unavailable. |
AUTHORIZATION_UNAVAILABLE | 503 | - | BACKOFF | Identity or credential authority storage is unavailable. |
SOURCE_UNAVAILABLE | 503 | 1013 | BACKOFF | The account-read or stream source is unavailable. |
CONTRACT_UNAVAILABLE | 503 | - | BACKOFF | This producer is disabled in this environment. |
MARKET_DATA_UNAVAILABLE | 503 | - | BACKOFF | No complete market catalog is available. |
BROWSE_UNAVAILABLE | 503 | - | BACKOFF | The published browse view is unavailable. |
FINANCIAL_ACTIONS_DISABLED | 503 | - | BACKOFF | Financial actions are disabled for this deployment. |
CORE_EXIT_UNAVAILABLE | 503 | - | BACKOFF | Core exits cannot be admitted now. |
COLLATERAL_REDUCTION_UNAVAILABLE | 503 | - | BACKOFF | This vault does not serve collateral reductions now. |
SPONSORSHIP_UNAVAILABLE | 503 | - | BACKOFF | Venue gas sponsorship is unavailable. |
CONTRACT_SIGNATURE_OVERLOADED | 503 | - | BACKOFF | Contract signature verification is at capacity. |
QUOTE_EXPOSURE_STALE | 503 | - | BACKOFF | The maker’s exposure projection is stale. |
COMBO_AUTOMATIC_DISABLED | 503 | - | BACKOFF | Automatic combo quoting is disabled. |
GAS_PRICE_ABOVE_CEILING | 503 | - | BACKOFF | The HyperEVM gas price is above the level at which Totalis accepts quotes; nothing was placed or accepted. Quotes keep coming; retry once the price falls. |
EXECUTION_BACKLOG_FULL | 503 | - | BACKOFF | The venue’s on-chain queue cannot send this trade before its quote expires; nothing was created. Retry after Retry-After with a fresh quote. |
EMBEDDED_WALLET_UNAVAILABLE | 503 | - | BACKOFF | The bound embedded wallet is unavailable. |
CONNECTION_DRAIN | 503 | 1012 | BACKOFF | The stream replica is draining; reconnect and resume from the last applied cursor. |
INVALID_SUBSCRIPTION | - | 1008 | NEVER | The first stream frame is not a valid subscribe. |
SUBSCRIPTION_DENIED | - | 1008 | NEVER | The credential may not subscribe to the requested channels or outcomes. |
AUTHORIZATION_REVOKED | - | 1008 | NEVER | The credential that opened the stream lost its authorization. |
STREAM_REPLACED | - | 1008 | NEVER | The owner’s browser session opened a newer stream past its live-stream limit, which replaced this one. Reconnecting replaces the owner’s oldest stream in turn. |
SLOW_CONSUMER | - | 1008 | BACKOFF | The client fell behind; reconnect and resume from the last applied cursor. |
RESNAPSHOT_REQUIRED | - | 1008 | REFRESH | The stream cannot continue from this state; reload HTTP state and resubscribe. |
SNAPSHOT_TOO_LARGE | - | 1013 | BACKOFF | The snapshot exceeds the frame ceiling. |