Overview

Errors

One error shape, a short list of stable codes.

Every error returns JSON with a stable machine-readable error code and a human-readable message. Branch on error; show message to people. Message wording may change.

409 Conflict
{
  "error": "no_verified_quote",
  "message": "No verified, unexpired quote at or under the max price yet"
}
StatusCodeWhen
400invalid_*A field is missing or out of range. The suffix names it: invalid_request, invalid_type, invalid_price, invalid_rule, invalid_quote_window, invalid_ttl, invalid_name, invalid_endpoint, invalid_types, invalid_active, invalid_window.
401unauthorizedNo valid session cookie or API key, or the key is revoked.
403forbiddenNot your order, or a cookie-authenticated write from another origin.
403own_orderYou tried to quote on an order your own wallet posted.
403provider_requiredYou tried to quote without a provider profile. Register first.
404not_foundThe order, fill, provider or path does not exist.
409provider_existsThis wallet already has a provider. Use PATCH /v1/providers/me.
409order_not_openThe order is filled, expired, cancelled, or its quote window has closed.
409requote_not_lowerA new quote must be strictly lower than your current verified quote on that order.
409no_verified_quoteFill requested, but no verified, unexpired quote at or under the max yet. The order stays open.
429rate_limitedToo many writes from this wallet. See Rate limits.
Was this page helpful?