Error codes

Branch on the error code, never on the message text. Each entry names a code as REST returns it in the problem+json code field. ConnectRPC returns the same code in the error detail, as a value of the enum named in each section; where a section names a prefix, the protobuf enum name starts with it. The number after each code is its enum value. Order codes use the same numbers on the SBE and Protobuf trade WebSockets.

Each entry gives the code, its enum value, the REST HTTP status, then the ConnectRPC code. Where an entry lists more than one value, the code is returned with each of them depending on the operation. How errors are shaped on each interface, and which ones are safe to retry, is on Error responses. The API reference lists the errors of each operation.

Orders and triggers

Enum orders.v1.ErrorCode, prefix ERROR_CODE_. Order entry, modification, cancellation, triggers, TWAP and ladder orders, and order and trade reads. The SBE and Protobuf trade WebSockets use the same numbers.

Outcome unknown

TRIGGER_CONTROL_OUTCOME_UNKNOWN · 253 · HTTP 504 · deadline_exceeded
The trigger change was not confirmed within its time bound. Its outcome is unknown and it may still apply; read the trigger before retrying.
ORDER_CANCEL_OUTCOME_UNKNOWN · 297 · HTTP 504 · deadline_exceeded
The order cancellation was sent but not confirmed in time. Its outcome is unknown and it may still apply; read the order before retrying. For a batch cancellation, every item's outcome is unknown; read them back. For a cancel all, some or all of the matching orders may be canceled; read open orders. For a cancel all after heartbeat, the switch may or may not have been armed, refreshed or disabled; send the heartbeat again.
ORDER_MODIFY_OUTCOME_UNKNOWN · 298 · HTTP 504 · deadline_exceeded
The order modification was sent but not confirmed in time. Its outcome is unknown and it may still apply; read the order before retrying. For a batch replacement, every item's outcome is unknown; read them back.
ORDER_CREATE_OUTCOME_UNKNOWN · 303 · HTTP 504 · deadline_exceeded
The order was sent but not confirmed in time. Its outcome is unknown and it may have been accepted; read the order by its client order ID, or read open orders, before retrying. For a batch create, every item's outcome is unknown; read them back, or repeat the batch with the same request ID and payload within 15 minutes, which returns decided items' original results and retries the rest without admitting any item twice.
TRIGGER_CREATE_OUTCOME_UNKNOWN · 304 · HTTP 504 · deadline_exceeded
The trigger was sent but not confirmed in time. Its outcome is unknown and it may have been created; read the triggers for its client trigger ID before retrying.

Request and encoding

BAD_REQUEST · 1 · HTTP 400 · invalid_argument
Request could not be parsed or was structurally invalid.
INVALID_ARGUMENT · 2 · HTTP 400 · invalid_argument
Request fields failed validation.
BATCH_TOO_LARGE · 33 · HTTP 400 · invalid_argument
Batch size exceeds the maximum allowed.
VALIDATION_ERROR · 66 · HTTP 400 · invalid_argument
Request failed structural or cross-field validation.
INVALID_ORDER_ID · 80 · HTTP 400 · invalid_argument
The order identifier or the replacement order identifier is not valid.
INVALID_SIDE · 211 · HTTP 400 · invalid_argument
The order side, or a trigger's child order side, is not a known side.
INVALID_ORDER_TYPE · 212 · HTTP 400 · invalid_argument
The order type, or a trigger's child order type, is not a known order type.
INVALID_STP_MODE · 213 · HTTP 400 · invalid_argument
The self-trade prevention mode is not a known mode.
INVALID_ORDER_FLAGS · 214 · HTTP 400 · invalid_argument
An order flag is unknown, or not accepted with this order type or time in force, or on a trigger's child order.
BATCH_OTHER_ITEM_INVALID · 215 · HTTP 400 · invalid_argument
Another item of the same batch was invalid, so this item was not applied either. Nothing in the batch changed.
REPLACE_ONTO_OWN_ID · 216 · HTTP 400 · invalid_argument
The replacement order identifier equals the identifier of the order it replaces.
INVALID_CLIENT_ORDER_ID · 217 · HTTP 400 · invalid_argument
The client order ID is longer than 36 bytes or otherwise not valid.
INVALID_HANDLING_MODE · 219 · HTTP 400 · invalid_argument
The order handling mode is not a known or accepted mode.
CANCEL_ALL_AFTER_TIMEOUT_INVALID · 222 · HTTP 400 · invalid_argument
The cancel-all-after timeout is neither 0, which disarms it, nor between 10 and 120 seconds.
CANCEL_SCOPE_TOO_LARGE · 223 · HTTP 400 · invalid_argument
The cancel-all request named more than 100 symbols.
INVALID_MODIFY_BEHAVIOR · 228 · HTTP 400 · invalid_argument
The modify behavior is not a known behavior.
BATCH_REPLACE_ONLY_REQUIRED · 229 · HTTP 400 · invalid_argument
No longer returned: each BatchReplaceOrders item follows ModifyOrder's default amend-or-replace rule. The value stays reserved.
BATCH_SINGLE_SYMBOL_REQUIRED · 230 · HTTP 400 · invalid_argument
An item of the batch modify named no symbol, or another symbol than the batch's first item, so the batch was refused.
INTENT_ID_INVALID · 232 · HTTP 400 · invalid_argument
The cancel-all or cancel-all-after request carried an intent identifier of zero.
DRY_RUN_INVALID · 233 · HTTP 400 · invalid_argument
The cancel-all request's dry-run flag was neither 0 nor 1.

Order parameters

BAD_PRICE · 5 · HTTP 400 · invalid_argument
Price is invalid for the requested order.
BAD_QTY · 6 · HTTP 400 · invalid_argument
Quantity is invalid for the requested order.
MIN_NOTIONAL · 7 · HTTP 400 · invalid_argument
Order notional is below the pair minimum.
QTY_STEP_SIZE · 8 · HTTP 400 · invalid_argument
Quantity does not align with the pair step size.
FEE_ASSET_NOT_ALLOWED · 15 · HTTP 400 · invalid_argument
Requested fee asset is not allowed for this order.
PRICE_TICK_SIZE · 30 · HTTP 400 · invalid_argument
Price must align with the pair tick size, including trigger and activation prices.
MIN_QTY · 31 · HTTP 400 · invalid_argument
Quantity is below the pair minimum quantity (base units).
POST_ONLY_LIMIT_ONLY · 32 · HTTP 400 · invalid_argument
Post-only is only valid for LIMIT orders.
MAX_SLIPPAGE_INVALID · 48 · HTTP 400 · invalid_argument
Max slippage (ticks or bps) is out of range or leaves no valid execution price bound. Applies to market orders and to standalone and attached trailing stops, on create and on modify; for example, a 10000 bps cap on a market order or trailing stop that sells.
MAX_QUOTE_DEBIT_TOO_SMALL · 68 · HTTP 400 · invalid_argument
The all-in quote budget cannot resolve one valid step-aligned base quantity.
MAX_QTY · 74 · HTTP 400 · invalid_argument
Quantity is above the pair maximum: the market-order maximum for MARKET orders, the limit-order maximum otherwise (base units).
MAX_NOTIONAL · 75 · HTTP 400 · invalid_argument
Order notional is above the pair maximum (quote units). A stricter sub-account policy cap returns POLICY_MAX_NOTIONAL instead.
PRICE_LEVEL_QUANTITY_LIMIT · 127 · HTTP 400 · failed_precondition
The order would take the total quantity resting at its price past the most a price level can hold, even if some quantity still fits. Nothing changed: a new order was not placed, a modified order keeps resting as it was, and the other orders at that price are unchanged. Another price or a smaller quantity, or the same order once less quantity rests at that price, is accepted.
INVALID_TIME_IN_FORCE · 202 · HTTP 400 · invalid_argument
The time in force, or its expiry time, is not accepted for this order or for a trigger's child order type.
STP_MODE_NOT_ALLOWED · 206 · HTTP 400 · invalid_argument
The self-trade prevention mode is not one the venue accepts for this order.

Funds and account limits

INSUFFICIENT_FUNDS · 3 · HTTP 400 · invalid_argument
Account does not have enough available balance for the order.
POLICY_MAX_NOTIONAL · 21 · HTTP 400 · invalid_argument
Sub-account policy max order notional exceeded.
POLICY_MAX_OPEN_ORDERS · 34 · HTTP 400 · invalid_argument
Sub-account policy maximum number of open orders has been reached.
RISK_LIMIT · 55 · HTTP 400 · invalid_argument
Account-level risk limits were exceeded.
SETTLEMENT_BACKLOGGED · 84 · HTTP 503 · unavailable
The account has too many filled or ended orders whose settlement has not completed yet. Nothing changed; the request is accepted again once settlement catches up.
MAX_OPEN_ORDERS_TOTAL · 205 · HTTP 400 · invalid_argument
The account has reached its maximum number of open orders across all markets. A stricter sub-account policy cap returns POLICY_MAX_OPEN_ORDERS instead.
ACCOUNT_RESERVATION_LIMIT_REACHED · 257 · HTTP 429 · resource_exhausted
The account's open orders and triggers hold its maximum number of fund reservations.
ACCOUNT_ORDERS_SUSPENDED · 263 · HTTP 400 · failed_precondition
New orders, changes and trigger orders on this account are suspended until a balance issue is resolved; cancels still work. Nothing changed.
ORDER_REPAIRING · 299 · HTTP 400 · failed_precondition
This order is being canceled while the account's balances are brought back in line, so it can't be changed. Nothing changed; cancels still work, and the account's other orders can still be changed.
ACCOUNT_REPAIRING · 300 · HTTP 400 · failed_precondition
This account's orders are being canceled while its balances are brought back in line, so new orders, changes and trigger orders are paused for a short time. Nothing changed; cancels still work. Try again shortly.
MAX_OPEN_ORDERS_PER_PAIR · 306 · HTTP 400 · invalid_argument
The account has reached its maximum number of resting orders in this market. Good-till-cancelled and good-till-date orders count until they end; immediate-or-cancel, fill-or-kill and market orders never count, and a replace keeps its order's place. Nothing changed; cancel a resting order in this market first.

Market state and pricing

UNKNOWN_SYMBOL · 4 · HTTP 400 · invalid_argument
Requested trading symbol is unknown.
PAIR_DISABLED · 16 · HTTP 400 · invalid_argument
Pair is disabled and does not accept orders.
MARKET_PRICE_UNAVAILABLE · 37 · HTTP 400 · failed_precondition
MARKET BUY cannot be reserved because no reference/top-of-book price is available.
PAIR_NOT_LISTED_YET · 50 · HTTP 400 · invalid_argument
Pair exists but is not listed yet.
PAIR_DELISTED · 51 · HTTP 400 · invalid_argument
Pair was delisted and is no longer tradable.
PAIR_CANCEL_ONLY · 52 · HTTP 400 · invalid_argument
Pair is in cancel-only mode.
PAIR_POST_ONLY · 53 · HTTP 400 · invalid_argument
Pair is in post-only mode and requires post_only=true.
PAIR_REDUCE_ONLY · 54 · HTTP 400 · invalid_argument
Pair is in reduce-only mode and does not accept new spot orders.
MARKET_HALTED · 56 · HTTP 400 · invalid_argument
Market is halted.
POST_ONLY_CROSS · 58 · HTTP 400 · invalid_argument
Post-only order would cross the book.
REDUCE_ONLY_BLOCKED · 59 · HTTP 400 · invalid_argument
Reduce-only policy blocked the order.
PRICE_BAND_VIOLATION · 60 · HTTP 400 · invalid_argument
Price band guard rejected the order.
MARKET_CAP_VIOLATION · 61 · HTTP 400 · invalid_argument
Market-cap guard rejected the order.
EMPTY_BOOK · 62 · HTTP 400 · invalid_argument
Market order could not execute due to empty book.
FOK_INSUFFICIENT_LIQUIDITY · 63 · HTTP 400 · invalid_argument
FOK order rejected due to insufficient immediate liquidity.
STALE_QUOTE · 65 · HTTP 400 · failed_precondition
Client reference price is stale compared to server-side BBO/drift policy.
MARKET_QUOTE_STALE · 200 · HTTP 400 · failed_precondition
The market order carried no client reference price, and the pair's reference quote (top of book) was older than its freshness bound when the order was admitted.
MARKET_QUOTE_UNHEALTHY · 201 · HTTP 400 · failed_precondition
The market order carried no client reference price, and the pair's reference quote could not be used to price it, for example because it postdated the order or carried an invalid price.
ORDER_LIMITS_UNAVAILABLE · 273 · HTTP 400 · failed_precondition
This market's order limits aren't set yet, so it can't take new orders.
ORDER_TYPE_NOT_ALLOWED_IN_AUCTION · 274 · HTTP 400 · failed_precondition
This market is in an auction call and takes only limit orders that rest without crossing the book; market, immediate-or-cancel and fill-or-kill orders are refused. Nothing changed.
POST_ONLY_NOT_ALLOWED_IN_AUCTION · 275 · HTTP 400 · failed_precondition
This market is in an auction call; new post-only orders are refused. Nothing changed.
SELF_TRADE_PREVENTED · 307 · HTTP 400 · failed_precondition
Self-trade prevention expired the order of an attached take-profit, stop-loss or trailing stop because it would have traded with another of the account's resting orders. It is reported as the trigger's fire refusal reason, never as the answer to a request: the attached order stays active. New trades and price updates do not fire it while the other order is first in line at the best price; once that order is gone or no longer first there, it fires again if its trigger condition still holds.

Authentication and permissions

UNAUTHENTICATED · 11 · HTTP 401 · unauthenticated
Caller is not authenticated.
PERMISSION_DENIED · 12 · HTTP 403 · permission_denied
Caller is authenticated but not allowed to perform this action.
SUBACCOUNT_INACTIVE · 19 · HTTP 400 · failed_precondition
Sub-account is present but not in an active state (disabled, deleted, etc.).
POLICY_MARKET_DENY · 20 · HTTP 403 · permission_denied
Sub-account policy prevented trading on this market (e.g. pair mask).
POLICY_TRADING_HALTED · 22 · HTTP 403 · permission_denied
Trading has been globally halted for this sub-account.
POLICY_SPOT_TRADE_DENY · 23 · HTTP 403 · permission_denied
Sub-account policy does not allow spot trading (action mask).
API_KEY_ROOT_SCOPE_ONLY · 24 · HTTP 403 · permission_denied
API key is scoped to the master/root account and cannot trade on sub-accounts.
API_KEY_SUB_SCOPE_ONLY · 25 · HTTP 403 · permission_denied
API key is scoped to a specific sub-account and cannot trade on the master/root account.
API_KEY_SUBACCOUNT_MISMATCH · 26 · HTTP 403 · permission_denied
API key is scoped to a different sub-account than the one requested.
API_KEY_POLICY_REQUIRED · 27 · HTTP 403 · permission_denied
API key must have an attached policy before it can be used for trading.
API_KEY_UNKNOWN · 28 · HTTP 403 · permission_denied
API key referenced in the request could not be resolved by the Orders service.
API_KEY_MARKET_DENY · 29 · HTTP 403 · permission_denied
API key policy does not allow trading this market, even though the sub-account policy does.
ACCOUNT_UNKNOWN · 57 · HTTP 400 · invalid_argument
Referenced account could not be resolved by the trading service.
SUBACCOUNT_READ_FORBIDDEN · 70 · HTTP 403 · permission_denied
Caller has a sub-account role that does not allow reading spot data.
POLICY_SPOT_READ_DENY · 71 · HTTP 403 · permission_denied
Sub-account policy does not allow reading spot data.
API_KEY_SPOT_READ_DENY · 72 · HTTP 403 · permission_denied
API key policy does not allow reading spot data.

Order identity and state

CONFLICT_DUPLICATE_CLIENT_ORDER_ID · 9 · HTTP 409 · already_exists
Client order ID is already in use on this account, by an open order or by an order that ended recently; an ended order keeps its client order ID reserved for at least 60 seconds. Reuse returns this code even with the same payload. Use GetOrder to reconcile, then retry with a new client order ID.
NOT_FOUND · 13 · HTTP 404 · not_found
Requested order or resource was not found.
ORDER_UNKNOWN · 17 · HTTP 404 · not_found
Referenced order could not be resolved.
MODIFICATION_REQUIRES_REPLACE · 35 · HTTP 400 · invalid_argument
Modify request in AMEND_ONLY mode requires replace semantics.
CONFLICT_IDEMPOTENCY_KEY_REUSE · 36 · HTTP 409 · already_exists
Idempotency key was reused with a different payload.
ORDER_ALREADY_TERMINAL · 64 · HTTP 400 · failed_precondition
The order has already ended (filled, canceled or expired).
CANCEL_REQUEST_EXPIRED · 73 · HTTP 400 · failed_precondition
The cancel request exceeded its bounded internal replay window.
QTY_AT_OR_BELOW_FILLED · 76 · HTTP 400 · failed_precondition
The replacement total quantity is at or below the order's filled quantity: the order ended at its filled quantity and no replacement order was created.
DUPLICATE_ORDER_ID · 204 · HTTP 409 · already_exists
The order identifier assigned to the request is already in use by another order of the market. Nothing changed.
ORDER_ID_CONFLICT · 210 · HTTP 409 · already_exists
The order identifier is held by a different, earlier order, so the request was not applied. Nothing changed.
ORDER_MODIFY_IN_PROGRESS · 226 · HTTP 503 · unavailable
An earlier amend or replace of the order has not completed yet. Retry once it completes.
ORDER_PLACEMENT_PENDING · 227 · HTTP 503 · unavailable
The order, or the replace that created it, has not been placed on the book yet, so it cannot be modified. Retry shortly.
CANCEL_ALL_AFTER_SCOPE_CONFLICT · 234 · HTTP 400 · failed_precondition
A cancel-all-after is already due to fire, and the re-arm's scope does not cover every symbol of the pending one.

Triggers, TWAP, ladders, and attached legs

TRIGGER_PRICE_INVALID · 40 · HTTP 400 · invalid_argument
Trigger price is invalid (e.g., TP below current price for long).
TRIGGER_PRICE_SOURCE_UNSUPPORTED · 41 · HTTP 400 · invalid_argument
Trigger price source not supported (e.g., INDEX_PRICE before it's available).
TRAILING_DISTANCE_INVALID · 42 · HTTP 400 · invalid_argument
Trailing stop distance must be positive.
TRIGGER_NOT_FOUND · 43 · HTTP 404 · not_found
Trigger not found (for cancel/get operations).
TRIGGER_STATUS_INVALID · 45 · HTTP 400 · invalid_argument
Trigger status does not allow requested lifecycle operation.
TRIGGER_NOT_MODIFIABLE · 46 · HTTP 400 · invalid_argument
Trigger type/state does not support requested lifecycle operation.
CONFLICT_DUPLICATE_CLIENT_TRIGGER_ID · 47 · HTTP 409 · already_exists
Client trigger ID is already used, either by a trigger with a different payload or by an earlier create that failed or was rolled back. List triggers to reconcile by client trigger ID, then retry with a new client trigger ID.
CHILD_QTY_RAISE_NOT_ALLOWED · 81 · HTTP 400 · invalid_argument
The quantity of a trigger's child order or a ladder order can't be raised above its planned quantity. Nothing changed.
ATTACHED_RISK_NOT_SUPPORTED · 82 · HTTP 501 · unimplemented
Attached take-profit, stop-loss or trailing legs can't be applied here: this market takes none, an attached trailing stop isn't offered yet, or the modify changes them together with the order's price, quantity, client order ID or a replace. Nothing changed.
ATTACHED_LEGS_EXCEEDED · 86 · HTTP 400 · invalid_argument
The order already carries every attached leg it may hold, so another attached leg was refused. Legs being cancelled count until they end: retry once they have ended.
FEE_ASSET_INVALID · 87 · HTTP 400 · invalid_argument
The trigger's fee asset was not valid.
FEE_CEILING_INVALID · 88 · HTTP 400 · invalid_argument
The trigger's maximum fee rate was not valid.
UNSUPPORTED_FIELD_SET · 89 · HTTP 400 · invalid_argument
The trigger set a field that must be left unset.
TRIGGER_FIRE_LIMIT_REACHED · 90 · HTTP 429 · resource_exhausted
The trigger could not fire again.
CONDITION_FLAGS_INVALID · 91 · HTTP 400 · invalid_argument
The trigger's condition flags were not valid.
CONDITION_PARAMETER_SET · 92 · HTTP 400 · invalid_argument
The trigger set a condition parameter its condition does not take.
TWAP_CAPACITY_REACHED · 93 · HTTP 429 · resource_exhausted
The market had no room for another TWAP order.
CHILD_ORDER_INCONSISTENT · 94 · HTTP 400 · failed_precondition
The trigger's child order did not match the order the trigger requested, so the trigger failed and the child order was canceled.
TRIGGER_CHILD_PRICE_NOT_MODIFIABLE · 236 · HTTP 400 · invalid_argument
The modify patched the trigger's child limit price or price mode, which the trigger does not accept.
TRIGGER_GENERATIONS_EXHAUSTED · 237 · HTTP 400 · failed_precondition
The trigger reached its last modification. Nothing changed; cancel it and create a new trigger instead.
TRIGGER_CONTROL_SHARE_EXHAUSTED · 238 · HTTP 429 · resource_exhausted
The account has its maximum number of trigger changes whose outcome is still pending. Retry shortly.
TRIGGER_CONTROLS_BUSY · 239 · HTTP 503 · unavailable
The venue's capacity for pending trigger changes is exhausted across accounts. Retry shortly.
TRIGGER_TYPE_NOT_SUPPORTED · 240 · HTTP 400 · invalid_argument
The trigger type is valid but not supported on this venue yet.
INVALID_TRIGGER_TYPE · 241 · HTTP 400 · invalid_argument
The trigger type is not a known type.
TRIGGER_DIRECTION_INVALID · 242 · HTTP 400 · invalid_argument
The trigger direction is neither ABOVE nor BELOW.
TRIGGER_QTY_INVALID · 243 · HTTP 400 · invalid_argument
The trigger's child order quantity is not positive.
TRIGGER_BUY_REQUIRES_LIMIT · 244 · HTTP 400 · invalid_argument
A buy trailing stop's child order is not a LIMIT order with a maximum price; its funds are reserved at that price.
ACCOUNT_ROUTING_INVALID · 245 · HTTP 503 · unavailable
The account's trading route is not configured for triggers, so the trigger was not admitted. Contact support if it persists.
TRIGGER_LIMIT_EXCEEDED · 246 · HTTP 429 · resource_exhausted
The account has its maximum number of live and recently ended triggers.
TRIGGER_CONTROL_IN_PROGRESS · 247 · HTTP 503 · unavailable
An earlier change of the trigger has not completed yet. Retry once it completes.
TRIGGER_PATCH_EMPTY · 248 · HTTP 400 · invalid_argument
The trigger modify named no field to change.
CLIENT_TRIGGER_ID_INVALID · 249 · HTTP 400 · invalid_argument
The client trigger ID is empty, longer than 36 bytes or otherwise not valid.
TRIGGER_ACTIVATION_PRICE_INVALID · 250 · HTTP 400 · invalid_argument
The trailing trigger's activation price is not positive or not on the pair's tick.
SLIPPAGE_TICKS_INVALID · 251 · HTTP 400 · invalid_argument
The trigger's slippage bound in ticks is not valid for its child order.
SLIPPAGE_BPS_INVALID · 252 · HTTP 400 · invalid_argument
The trigger's slippage bound in basis points is not valid for its child order.
TRIGGER_CAPACITY_REACHED · 254 · HTTP 429 · resource_exhausted
The venue holds its maximum number of triggers across accounts right now. Retry later.
RESERVATION_CAPACITY_REACHED · 255 · HTTP 429 · resource_exhausted
The venue's capacity for fund reservations is exhausted right now, so the trigger's child order could not be reserved. Retry later.
CLIENT_ORDER_ID_CAPACITY_REACHED · 256 · HTTP 429 · resource_exhausted
The venue's capacity for reserved client order IDs is exhausted right now, so the trigger's child order could not reserve one. Retry later.
INVALID_TRIGGER_CONTROL · 258 · HTTP 400 · invalid_argument
The requested trigger operation is not a known operation.
TRIGGER_PATCH_NOT_ALLOWED · 259 · HTTP 400 · invalid_argument
A trigger operation other than modify carried field changes.
TRIGGER_PATCH_FIELD_UNKNOWN · 260 · HTTP 400 · invalid_argument
The trigger modify named a field that is not known.
TRIGGER_PATCH_VALUE_UNMASKED · 261 · HTTP 400 · invalid_argument
The trigger modify carried a value for a field its change mask does not name.
TRIGGER_PATCH_PRICE_MODE_INVALID · 262 · HTTP 400 · invalid_argument
The trigger modify's price mode is not a known mode.
TRAILING_SIDE_NOT_SUPPORTED · 264 · HTTP 400 · invalid_argument
A trailing stop's side is not supported. Trailing stops accept either side, so this code is not currently returned.
TRAILING_CHILD_NOT_MARKET · 265 · HTTP 400 · invalid_argument
A trailing stop that sells must have a MARKET child order.
TWAP_DURATION_INVALID · 266 · HTTP 400 · invalid_argument
The TWAP duration is shorter than 1 second or longer than about 292 years, the longest the venue's clock represents.
LIMIT_CHILD_SLIPPAGE_SET · 267 · HTTP 400 · invalid_argument
The TWAP sets a slippage bound, but its slices are LIMIT orders, which take none.
SLIPPAGE_BOUNDS_CONFLICT · 268 · HTTP 400 · invalid_argument
The slippage bound is given both in ticks and in basis points; give only one.
TWAP_INTERVAL_INVALID · 269 · HTTP 400 · invalid_argument
The TWAP slice interval is shorter than 100 milliseconds or longer than its duration.
LADDER_LEVEL_REJECTED · 270 · HTTP 400 · invalid_argument
One of the ladder's orders can't be placed, so the ladder was not created. Nothing changed.
LADDER_RANGE_TOO_NARROW · 271 · HTTP 400 · invalid_argument
The ladder's price range is too narrow to place its orders at least one price tick apart.
LADDER_LEVELS_INVALID · 272 · HTTP 400 · invalid_argument
A ladder places from 2 to 100 orders.
ATTACHED_EXIT_WORKING · 292 · HTTP 400 · failed_precondition
An exit order placed by one of the order's attached take-profit or stop legs is still working, so the order's attached legs can't be added, edited, paused or resumed now; removing a leg is still accepted. Nothing changed; retry once the exit completes.
MARKET_TRIGGER_LIMIT_EXCEEDED · 293 · HTTP 429 · resource_exhausted
The account already has the most triggers one account may have on this market, attached take-profit, stop-loss and trailing legs included. Nothing changed; retry once one of them ends.
MARKET_TWAP_LIMIT_EXCEEDED · 294 · HTTP 429 · resource_exhausted
The account already has the most TWAP orders one account may have on this market. Nothing changed; retry once one of them ends.
MARKET_LADDER_LIMIT_EXCEEDED · 295 · HTTP 429 · resource_exhausted
The account already has the most ladder orders one account may have on this market. Nothing changed; retry once one of them ends.
CHILD_QTY_EXCEEDS_REMAINING · 296 · HTTP 400 · invalid_argument
The new quantity of a TWAP order's slice would leave more than the TWAP's remaining quantity. Nothing changed; a slice can be raised up to what the TWAP still has to execute.
TRIGGER_WOULD_TRIGGER_IMMEDIATELY · 302 · HTTP 400 · failed_precondition
The change would act on the trigger at once. The new trigger price of a stop-loss or take-profit, or the trigger price a new trailing distance gives an activated trailing stop, is already reached by the price the trigger watches (at or past it), so the trigger would fire at once and send its order; or the new activation price of a trailing stop not yet activated is already reached by that price, so it would activate at once. Nothing changed; the trigger keeps its previous settings. Returned by ModifyTrigger, and by an order modify that moves an attached take-profit, stop-loss or trailing stop of an order with a fill. Choose a price the market has not reached.
TRIGGER_SYMBOL_MISMATCH · 305 · HTTP 400 · invalid_argument
The request names a listed trading pair other than the trigger's own, so it was refused. Nothing changed; name the trigger's own pair, or omit the symbol. A pair that is not listed is ERROR_CODE_UNKNOWN_SYMBOL.

QuickSwap orders

QUICKSWAP_NOT_PERMITTED · 203 · HTTP 403 · permission_denied
The request carried QuickSwap terms that the account or market does not accept.
QUICKSWAP_FEE_DETAILS_INCOMPLETE · 276 · HTTP 400 · invalid_argument
The request's QuickSwap fee details are incomplete: a fee schedule needs a broker, and a broker or broker fee terms need a fee schedule.
QUICKSWAP_MARKET_NOT_PRICED · 277 · HTTP 400 · failed_precondition
The requested QuickSwap fee schedule doesn't price this market.
QUICKSWAP_BROKER_FEE_TERMS_MISMATCH · 278 · HTTP 400 · invalid_argument
The broker fee terms belong to another broker.
QUICKSWAP_FEE_RECIPIENT_IS_PAYER · 279 · HTTP 400 · invalid_argument
A QuickSwap fee would be paid into the account placing the order.
QUICKSWAP_BROKER_FEE_TERMS_UNAVAILABLE · 280 · HTTP 503 · unavailable
The broker fee terms aren't available yet; retry shortly.
QUICKSWAP_BROKER_ACCOUNT_UNAVAILABLE · 281 · HTTP 503 · unavailable
The broker's fee account isn't available yet; retry shortly.
QUICKSWAP_DISABLED · 282 · HTTP 400 · failed_precondition
QuickSwap isn't enabled for this account's trading.
QUICKSWAP_ATTACHED_RISK_NOT_ALLOWED · 283 · HTTP 400 · invalid_argument
QuickSwap orders can't carry take-profit or stop-loss legs.
QUICKSWAP_ORDER_NOT_MODIFIABLE · 284 · HTTP 400 · failed_precondition
QuickSwap orders can't be amended or replaced.
QUICKSWAP_FEE_TOTAL_TOO_HIGH · 285 · HTTP 400 · failed_precondition
The QuickSwap fees together would exceed the order's value.
QUICKSWAP_BROKER_FEE_TERMS_INVALID · 286 · HTTP 400 · failed_precondition
The broker fee terms are invalid and can't be used.
QUICKSWAP_BROKER_INVALID · 287 · HTTP 400 · failed_precondition
The broker's QuickSwap setup is invalid and can't be used.
QUICKSWAP_FEE_SCHEDULE_INVALID · 288 · HTTP 400 · failed_precondition
The QuickSwap fee schedule is invalid and can't be used.
QUICKSWAP_MARKET_FEE_INVALID · 289 · HTTP 400 · failed_precondition
The QuickSwap fee for this market is invalid and can't be used.
QUICKSWAP_SETUP_INVALID · 290 · HTTP 400 · failed_precondition
QuickSwap's setup is invalid, so QuickSwap orders can't be placed.
QUICKSWAP_CAPACITY_REACHED · 291 · HTTP 429 · resource_exhausted
QuickSwap's capacity for fee settings is reached; this order can't be placed.
QUICKSWAP_ACCOUNT_OWNER_UNKNOWN · 301 · HTTP 503 · unavailable
The QuickSwap account is not ready yet; no order was placed. Retry shortly.

Rate limits and capacity

OVERLOADED · 67 · HTTP 503 · resource_exhausted
The account already has its maximum order requests in flight; nothing was admitted. ConnectRPC returns RESOURCE_EXHAUSTED (HTTP 429); REST returns HTTP 503. No Retry-After or RateLimit-* headers are supplied. Retry after one of the outstanding requests completes.
RATE_LIMIT_EXCEEDED · 69 · HTTP 429 · resource_exhausted
The account exhausted its current order-admission quota.
PAIR_BACKLOGGED · 207 · HTTP 503 · unavailable
The trading pair is busy with the account's earlier requests, so this one was not admitted and nothing was reserved. Retry shortly.
PRICE_LEVELS_EXHAUSTED · 208 · HTTP 429 · resource_exhausted
The order book of the market holds its maximum number of distinct price levels, so an order at a new price cannot rest. Nothing changed.
CLIENT_ORDER_IDS_EXHAUSTED · 209 · HTTP 429 · resource_exhausted
The account reserves its maximum number of client order IDs, including those of recently ended orders. Retry once they expire, or send the request without a client order ID.
ORDER_SEQUENCE_EXHAUSTED · 218 · HTTP 429 · resource_exhausted
The account used every order identifier available to it in this market. Retrying does not help; contact support.
RATE_LIMIT_POLICY_UNAVAILABLE · 224 · HTTP 503 · unavailable
No usable rate-limit policy applies to the account right now, so the request was refused rather than admitted unlimited. Retry later.
SYSTEM_RATE_LIMITED · 225 · HTTP 429 · resource_exhausted
The venue-wide admission rate that the account shares with other accounts is exhausted. The account's own limit was not reached; retry shortly.
REQUEST_RECEIPTS_EXHAUSTED · 231 · HTTP 429 · resource_exhausted
The account keeps its maximum number of recent modify or batch requests for duplicate detection. Retry once earlier ones expire.
NEW_ACCOUNT_CAPACITY_REACHED · 235 · HTTP 429 · resource_exhausted
The venue holds its maximum number of account access records, so an account trading this market for the first time cannot be admitted. Retry later.

Service availability

UNAVAILABLE · 10 · HTTP 503 · unavailable
Service is temporarily unavailable.
UPSTREAM_ERROR · 14 · HTTP 502 · unavailable
Upstream dependency returned an error.
INTERNAL_ERROR · 18 · HTTP 500 · internal
Order processing failed because of an unexpected error.
GATEWAY_MISCONFIGURED · 77 · HTTP 500 · internal
The trading gateway that took the request is misconfigured for the order service behind it. An operator must correct it; retrying does not help.
FEE_SCHEDULE_UNAVAILABLE · 220 · HTTP 503 · unavailable
The fees that apply to the order cannot be determined right now, so it was not admitted. Retry later.
POLICY_UNAVAILABLE · 221 · HTTP 503 · unavailable
The account's trading policy cannot be evaluated right now, so the order was not admitted. Retry later.

More specific REST codes for orders

Some REST responses carry a more specific code than the enum value that ConnectRPC returns in ErrorDetail. The number in each entry is the enum value both interfaces share.

REQUEST_TOO_LARGE · same as BAD_REQUEST (1) · HTTP 413 · invalid_argument
Returned by Reads, writes.
INVALID_BEFORE_TS_NS · same as INVALID_ARGUMENT (2) · HTTP 400 · invalid_argument
Returned by Reads.
INVALID_END_TIME · same as INVALID_ARGUMENT (2) · HTTP 400 · invalid_argument
Returned by Reads.
INVALID_LIMIT · same as INVALID_ARGUMENT (2) · HTTP 400 · invalid_argument
Returned by Reads.
INVALID_OFFSET · same as INVALID_ARGUMENT (2) · HTTP 400 · invalid_argument
Returned by Reads.
INVALID_ORDER_STATUS · same as INVALID_ARGUMENT (2) · HTTP 400 · invalid_argument
Returned by Reads.
INVALID_PAGE_TOKEN · same as INVALID_ARGUMENT (2) · HTTP 400 · invalid_argument
Returned by Reads.
INVALID_SIDE · same as INVALID_ARGUMENT (2) · HTTP 400 · invalid_argument
Returned by Reads.
INVALID_START_TIME · same as INVALID_ARGUMENT (2) · HTTP 400 · invalid_argument
Returned by Reads.
INVALID_SUBACCOUNT_ID · same as INVALID_ARGUMENT (2) · HTTP 400 · invalid_argument
Returned by Reads.
INVALID_SYMBOL · same as INVALID_ARGUMENT (2) · HTTP 400 · invalid_argument
Returned by Reads.
INVALID_TRIGGER_ID · same as INVALID_ARGUMENT (2) · HTTP 400 · invalid_argument
Returned by Reads.
INVALID_TRIGGER_STATUS · same as INVALID_ARGUMENT (2) · HTTP 400 · invalid_argument
Returned by Reads.
INVALID_TRIGGER_TYPE · same as INVALID_ARGUMENT (2) · HTTP 400 · invalid_argument
Returned by Reads.
ORDER_ID_REQUIRED · same as INVALID_ARGUMENT (2) · HTTP 400 · invalid_argument
Returned by Reads.
TRAILING_STOP_ORDER_TYPE_UNSUPPORTED · same as INVALID_ARGUMENT (2) · HTTP 400 · invalid_argument
Returned by Writes.
TRIGGER_ID_REQUIRED · same as INVALID_ARGUMENT (2) · HTTP 400 · invalid_argument
Returned by Reads.
VALIDATION_ERROR · same as INVALID_ARGUMENT (2) · HTTP 400 · invalid_argument
Returned by Reads.
ROLE_SPOT_TRADE_DENY · same as PERMISSION_DENIED (12) · HTTP 403 · permission_denied
Returned by Writes.

Withdrawals

Enum chain.withdraw.v1.ErrorCode, prefix ERROR_CODE_. Withdrawals from a Trading account to the Funding account or to another Network, destination validation, and auto-withdraw rules.

INSUFFICIENT_FUNDS · 1 · HTTP 400 · failed_precondition
The source account does not have enough available Trading balance.
INVALID_REQUEST · 2 · HTTP 400 · invalid_argument
Request payload or one of its fields is invalid.
UNAUTHENTICATED · 3 · HTTP 401 · unauthenticated
Caller is not authenticated.
PERMISSION_DENIED · 4 · HTTP 403 · permission_denied
Caller is not permitted to perform the withdraw operation.
RATE_LIMIT_EXCEEDED · 5 · HTTP 429 · resource_exhausted
Request exceeded the applicable admission rate limit.
SERVICE_UNAVAILABLE · 6 · HTTP 503 · unavailable
A required dependency is temporarily unavailable.
INTERNAL_ERROR · 7 · HTTP 500 · internal
The request failed because of an unexpected server error.
INVALID_SUBACCOUNT_ID · 8 · HTTP 400 · invalid_argument
The selected subaccount identifier is invalid.
SUBACCOUNT_NOT_FOUND · 9 · HTTP 404 · not_found
The selected subaccount does not exist.
INVALID_ACTION · 10 · HTTP 400 · invalid_argument
The requested withdraw action is invalid for this endpoint.
UNSUPPORTED_LEDGER · 11 · HTTP 400 · invalid_argument
The requested ledger is not supported for withdrawals.
UNSUPPORTED_ASSET · 12 · HTTP 400 · invalid_argument
The requested asset or withdraw route is not supported.
INVALID_AMOUNT · 13 · HTTP 400 · invalid_argument
The withdraw amount is invalid.
INVALID_DESTINATION_CHAIN · 14 · HTTP 400 · invalid_argument
The destination chain is invalid.
INVALID_DESTINATION_ADDRESS · 15 · HTTP 400 · invalid_argument
The destination address is invalid.
EXTERNAL_DESTINATION_NOT_WHITELISTED · 16 · HTTP 403 · permission_denied
The external destination is not whitelisted.
INTERNAL_RECIPIENT_NOT_WHITELISTED · 17 · HTTP 403 · permission_denied
The internal funding recipient is not whitelisted.
AMOUNT_BELOW_MINIMUM · 18 · HTTP 400 · invalid_argument
The withdraw amount is below the configured minimum including fees.
AMOUNT_EXCEEDS_SUPPLY · 19 · HTTP 400 · invalid_argument
The withdraw amount exceeds the available zipped-asset supply.
SOURCE_SMART_ACCOUNT_UNAVAILABLE · 20 · HTTP 400 · failed_precondition
The source smart-account address is unavailable.
SIGNATURE_REQUIRED · 21 · HTTP 400 · invalid_argument
The required payload signature is missing.
SIGNATURE_SCHEME_UNSUPPORTED · 22 · HTTP 400 · invalid_argument
The requested signature scheme is unsupported.
SIGNER_WALLET_INVALID · 23 · HTTP 400 · invalid_argument
The wallet supplied as signer is invalid.
WALLET_BINDING_INVALID · 24 · HTTP 403 · permission_denied
Wallet authorization binding verification failed.
WALLET_BINDING_SCOPE_MISMATCH · 25 · HTTP 403 · permission_denied
Wallet authorization binding does not cover the requested scope.
WALLET_BINDING_SIGNER_MISMATCH · 26 · HTTP 403 · permission_denied
Wallet authorization binding does not match the signer.
API_KEY_NOT_FOUND · 27 · HTTP 403 · permission_denied
The API key could not be resolved.
API_KEY_BINDING_INVALID · 28 · HTTP 403 · permission_denied
API-key authorization binding verification failed.
API_KEY_BINDING_SCOPE_MISMATCH · 29 · HTTP 403 · permission_denied
API-key authorization binding does not cover the requested scope.
API_KEY_BINDING_PUBLIC_KEY_MISMATCH · 30 · HTTP 403 · permission_denied
API-key authorization binding does not match the configured public key.
IDEMPOTENCY_CONFLICT · 31 · HTTP 409 · already_exists
The idempotency key was reused with different request data.
FUNDS_LOCK_CONFLICT · 32 · HTTP 409 · aborted
The funds lock conflicts with an existing or finalized reservation.
CAPITAL_VIEW_UNAVAILABLE · 33 · HTTP 503 · unavailable
The authoritative capital view is not ready or is stale.
CHAIN_METADATA_UNAVAILABLE · 34 · HTTP 503 · unavailable
Required chain or contract metadata is unavailable.
FEE_UNAVAILABLE · 35 · HTTP 503 · unavailable
Required network fee data is unavailable.
SUPPLY_UNAVAILABLE · 36 · HTTP 503 · unavailable
Required zipped-asset supply data is unavailable.
STEP_UP_UNAVAILABLE · 37 · HTTP 503 · unavailable
Fresh step-up verification is temporarily unavailable.
DESTINATION_VALIDATION_UNAVAILABLE · 38 · HTTP 503 · unavailable
Destination validation is temporarily unavailable.
ACCOUNT_SHARD_UNAVAILABLE · 39 · HTTP 503 · unavailable
Funds movement for this account is temporarily unavailable. Retry later.
FAILED_PRECONDITION · 40 · HTTP 400 · failed_precondition
A required precondition was not satisfied.
NOT_FOUND · 41 · HTTP 404 · not_found
The requested resource was not found.
CONFLICT · 42 · HTTP 409 · aborted
The request conflicts with existing state.
INVALID_AUTO_WITHDRAW_SCHEDULE · 43 · HTTP 400 · invalid_argument
The auto-withdraw schedule is invalid: a field its cadence needs is missing or out of range, or a field of another cadence is set.
AMOUNT_EXCEEDS_ROUTE_PRECISION · 44 · HTTP 400 · invalid_argument
The withdraw amount has more decimal places than the destination network's token supports (AssetChainVariant.source_decimals). Round amount_e18 down to a whole number of that token's smallest units before signing.

Internal transfers

Enum transfer.v1.ErrorCode, prefix ERROR_CODE_. Transfers between Trading accounts.

INSUFFICIENT_FUNDS · 1 · HTTP 400 · failed_precondition
The source account does not have enough available Trading balance.
INVALID_REQUEST · 2 · HTTP 400 · invalid_argument
Request payload or one of its fields is invalid.
UNAUTHENTICATED · 3 · HTTP 401 · unauthenticated
Caller is not authenticated.
PERMISSION_DENIED · 4 · HTTP 403 · permission_denied
Caller is not permitted to create the transfer.
RATE_LIMIT_EXCEEDED · 5 · HTTP 429 · resource_exhausted
Request exceeded the applicable admission rate limit.
SERVICE_UNAVAILABLE · 6 · HTTP 503 · unavailable
A required dependency is temporarily unavailable.
INTERNAL_ERROR · 7 · HTTP 500 · internal
The request failed because of an unexpected server error.
INVALID_SUBACCOUNT_ID · 8 · HTTP 400 · invalid_argument
The selected subaccount identifier is invalid.
SUBACCOUNT_NOT_FOUND · 9 · HTTP 404 · not_found
The selected subaccount does not exist.
SOURCE_ACCOUNT_INACTIVE · 10 · HTTP 400 · failed_precondition
The source subaccount is not active.
UNSUPPORTED_ASSET · 11 · HTTP 400 · invalid_argument
The requested asset is not supported for internal transfers.
INVALID_AMOUNT · 12 · HTTP 400 · invalid_argument
The transfer amount is invalid.
INVALID_DESTINATION · 13 · HTTP 400 · invalid_argument
The destination identifier is invalid.
DESTINATION_NOT_FOUND · 14 · HTTP 404 · not_found
The destination account or smart account could not be found.
DESTINATION_INACTIVE · 15 · HTTP 400 · failed_precondition
The destination subaccount is not active.
SAME_SOURCE_DESTINATION · 16 · HTTP 400 · invalid_argument
Source and destination resolve to the same account.
DESTINATION_NOT_WHITELISTED · 17 · HTTP 403 · permission_denied
The destination is not present on the caller's internal whitelist.
SMART_ACCOUNT_UNAVAILABLE · 18 · HTTP 400 · failed_precondition
A required source or destination smart-account address is unavailable.
STEP_UP_UNAVAILABLE · 19 · HTTP 503 · unavailable
Fresh step-up verification is temporarily unavailable.
IDEMPOTENCY_CONFLICT · 20 · HTTP 409 · already_exists
The idempotency key was reused with different request data.
FUNDS_LOCK_CONFLICT · 21 · HTTP 409 · aborted
The funds lock conflicts with an existing or finalized reservation.
CAPITAL_VIEW_UNAVAILABLE · 22 · HTTP 503 · unavailable
The authoritative capital view is not ready or is stale.
ACCOUNT_SHARD_UNAVAILABLE · 23 · HTTP 503 · unavailable
Funds movement for this account is temporarily unavailable. Retry later.
POLICY_DENIED · 24 · HTTP 403 · permission_denied
A required account or API-key policy rejected the transfer.
FAILED_PRECONDITION · 25 · HTTP 400 · failed_precondition
A required precondition was not satisfied.
NOT_FOUND · 26 · HTTP 404 · not_found
The requested resource was not found.
CONFLICT · 27 · HTTP 409 · aborted
The request conflicts with existing state.

Accounts, API keys, and security

Enum auth.v1.AuthErrorCode. Login, Subaccounts, members and invites, API keys, policies, MFA, and step-up. The REST code is the enum name.

AUTH_USERNAME_INVALID · 1 · HTTP 400 · invalid_argument
Username format or characters are invalid.
AUTH_USERNAME_TAKEN · 2 · HTTP 409 · already_exists
Username is already used by another account.
AUTH_USERNAME_COOLDOWN · 3 · HTTP 412 · failed_precondition
Username was changed too recently.
AUTH_USERNAME_FEATURE_LOCKED · 4 · HTTP 403 · failed_precondition, permission_denied
Account is not currently eligible to claim or change a username.
AUTH_USERNAME_RESERVED · 5 · HTTP 403 · permission_denied
Username is reserved and cannot be claimed by this account.
AUTH_INVALID_REQUEST · 6 · HTTP 400 · failed_precondition, invalid_argument
Request is malformed or missing required input.
AUTH_AUTHENTICATION_REQUIRED · 7 · HTTP 401 · unauthenticated
Authentication is required for this operation.
AUTH_SESSION_KIND_NOT_ALLOWED · 8 · HTTP 403 · permission_denied
Presented session type is not allowed for this operation.
AUTH_WALLET_LOGIN_FAILED · 9 · HTTP 401 · unauthenticated
Wallet login failed because the nonce or signature could not be verified.
AUTH_RESOURCE_NOT_FOUND · 10 · HTTP 404 · not_found
Requested resource was not found.
AUTH_SUBACCOUNT_ACCESS_DENIED · 11 · HTTP 403 · permission_denied
Caller does not have access to the requested sub-account.
AUTH_API_KEY_ACCESS_DENIED · 12 · HTTP 403 · permission_denied
Caller does not have access to the requested API key.
AUTH_API_KEY_INVALID_STATUS_TRANSITION · 14 · HTTP 400 · invalid_argument
Requested API key status transition is not allowed.
AUTH_POLICY_INVALID · 15 · HTTP 400 · invalid_argument
Policy definition or binding is invalid.
AUTH_SMART_ACCOUNT_ALREADY_LINKED · 16 · HTTP 409 · already_exists
Smart-account address is already linked to another account.
AUTH_INVITE_ACCESS_DENIED · 17 · HTTP 403 · permission_denied
Caller does not have access to the requested invite.
AUTH_INVITE_INVALID_STATE · 18 · HTTP 412 · failed_precondition, invalid_argument
Invite cannot be used in its current state.
AUTH_MFA_DISABLED · 19 · HTTP 503 · unavailable
MFA is not available for this account.
AUTH_MFA_NOT_ENROLLED · 20 · HTTP 412 · failed_precondition
Required MFA factor is not enrolled.
AUTH_MFA_SESSION_INVALID · 21 · HTTP 412 · failed_precondition
MFA session is missing, expired, or invalid.
AUTH_MFA_CHALLENGE_NOT_FOUND · 22 · HTTP 404 · not_found
MFA challenge was not found.
AUTH_MFA_CHALLENGE_INVALID · 23 · HTTP 403 · permission_denied
MFA challenge payload is invalid.
AUTH_MFA_CHALLENGE_LOCKED · 24 · HTTP 429 · resource_exhausted
MFA challenge is locked after too many failed attempts.
AUTH_MFA_OTP_INVALID · 25 · HTTP 403 · permission_denied
One-time password is invalid.
AUTH_MFA_RECOVERY_INVALID · 26 · HTTP 403 · permission_denied
Recovery code is invalid.
AUTH_MFA_PASSKEY_NOT_AVAILABLE · 27 · HTTP 412 · failed_precondition
Passkey verification is not available for this challenge.
AUTH_MFA_PASSKEY_CREDENTIAL_INVALID · 28 · HTTP 400 · invalid_argument
Passkey credential is invalid for this account or challenge.
AUTH_MFA_PASSKEY_VERIFY_FAILED · 29 · HTTP 403 · permission_denied
Passkey verification failed.
AUTH_MFA_ENROLLMENT_BINDING_INVALID · 30 · HTTP 403 · permission_denied
MFA enrollment binding is invalid or expired.
AUTH_STEP_UP_REQUIRED · 31 · HTTP 403 · permission_denied
A fresh step-up proof is required for this protected operation.
AUTH_STEP_UP_PROOF_UNAVAILABLE · 32 · HTTP 403 · permission_denied
A requested step-up proof is unavailable.
AUTH_STEP_UP_ALREADY_CLAIMED · 33 · HTTP 403 · permission_denied
The step-up proof has already been claimed.
AUTH_POLICY_IN_USE · 34 · HTTP 412 · failed_precondition
The requested policy cannot be removed because it is still in use.
AUTH_POLICY_LOCKED · 35 · HTTP 412 · failed_precondition
The requested policy is locked against this mutation.
AUTH_POLICY_SCOPE_MISMATCH · 36 · HTTP 412 · failed_precondition
The requested policy does not belong to the target account scope.
AUTH_REVISION_CONFLICT · 37 · HTTP 409 · aborted
The resource changed after the caller read it.
AUTH_MFA_ELEVATION_REQUIRED · 38 · HTTP 403 · permission_denied
A recently MFA-elevated interactive session is required.
AUTH_MFA_LAST_FACTOR_REQUIRED · 39 · HTTP 412 · failed_precondition
At least one active MFA factor must remain enrolled.
AUTH_INTERNAL_ERROR · 40 · HTTP 500 · internal
An unexpected internal failure prevented the auth mutation from completing.
AUTH_TERMS_NOT_ACCEPTED · 41 · HTTP 412 · failed_precondition
The caller has not accepted the terms required for this action.
AUTH_SOCIAL_VERIFICATION_EXPIRED · 42 · HTTP 412 · failed_precondition
Social verification challenge expired. Start a new verification, then mark it ready again.
AUTH_SOCIAL_VERIFICATION_INVALID_STATE · 43 · HTTP 412 · failed_precondition
Social verification cannot accept a ready mark in its current state.
AUTH_SUBACCOUNT_CHALLENGE_INVALID · 44 · HTTP 412 · failed_precondition
Sub-account authorization is expired, replaced, consumed, or has an invalid signature. Temporary verification failures return Unavailable; retry the same signed challenge.
AUTH_SOCIAL_ACCOUNT_ALREADY_LINKED · 45 · in a response field
Social account is already linked to another Polyester account.
AUTH_TEMPORARILY_UNAVAILABLE · 46 · HTTP 503 · unavailable
The request could not be completed right now and changed nothing. Retry the same request.
AUTH_SUBACCOUNT_OWNER_ROLE_LOCKED · 47 · HTTP 412 · failed_precondition
The account owns this sub-account. An owner cannot be invited to it, and member role changes and member removal do not apply to the owner.
AUTH_SIGNATURE_INVALID · 48 · HTTP 401 · unauthenticated
The API key request signature does not verify against the request, or the key is unknown. The REST problem code is SIGNATURE_INVALID.
AUTH_TIMESTAMP_SKEW · 49 · HTTP 401 · unauthenticated
The API key request timestamp is malformed or too far from the server clock. Sync the clock, then sign the request again. The REST problem code is TIMESTAMP_SKEW.
AUTH_MISSING_HEADERS · 50 · HTTP 401 · unauthenticated
The API key request lacks its timestamp or signature header. The REST problem code is MISSING_HEADERS.
AUTH_KEY_EXPIRED · 51 · HTTP 401 · unauthenticated
The API key has expired. The REST problem code is KEY_EXPIRED.
AUTH_KEY_DISABLED · 52 · HTTP 401 · unauthenticated
The API key is disabled or revoked. The REST problem code is KEY_DISABLED.
AUTH_IP_NOT_ALLOWED · 53 · HTTP 401 · unauthenticated
The API key's IP allowlist does not include the request's source address. The REST problem code is IP_NOT_ALLOWED.
AUTH_API_KEY_NOT_ACCEPTED · 54 · HTTP 401 · unauthenticated
This API does not accept API keys; authenticate with a session token. The REST problem code is API_KEY_NOT_ACCEPTED.

Profiles

Enum auth.v1.ProfileErrorCode. Profile updates. The REST code is the enum name.

PROFILE_INVALID_FIELD · 1 · HTTP 400 · invalid_argument
Generic invalid field (format/characters).
PROFILE_FIELD_TOO_LONG · 2 · HTTP 400 · invalid_argument
Field exceeds configured max length.
PROFILE_URL_INVALID · 3 · HTTP 400 · invalid_argument
URL is syntactically invalid.
PROFILE_URL_SCHEME_INVALID · 4 · HTTP 400 · invalid_argument
URL scheme is not allowed (e.g., non-http(s)).

Balances and transfer history

Enum ledger.read.v1.ErrorCode, prefix ERROR_CODE_. Balance, portfolio, equity, and transfer-history reads.

BAD_REQUEST · 1 · HTTP 400 · invalid_argument
Bad Request. REST may return INVALID_ARGUMENT, MISSING_HEADERS, TIMESTAMP_SKEW.
UNAUTHENTICATED · 2 · HTTP 401 · unauthenticated
Ledger reads require a valid bearer JWT or signed API-key request. REST may return IP_NOT_ALLOWED, KEY_DISABLED, KEY_EXPIRED, SIGNATURE_INVALID.
PERMISSION_DENIED · 3 · HTTP 403 · permission_denied
Permission Denied. REST may return API_KEY_ACTION_DENY, API_KEY_POLICY_NOT_FOUND, API_KEY_POLICY_REQUIRED, API_KEY_ROOT_SCOPE_ONLY, API_KEY_SUBACCOUNT_MISMATCH, API_KEY_UNKNOWN, ROLE_ACTION_DENY, SUBACCOUNT_POLICY_DENY, SUBACCOUNT_READ_FORBIDDEN.
NOT_FOUND · 4 · HTTP 404 · not_found
Not Found.
MISSING_ACCOUNT_ID · 5 · HTTP 400 · invalid_argument
Missing or invalid account identifier (legacy; used by older endpoints).
INVALID_ACCOUNT_ID · 6 · HTTP 400 · invalid_argument
Invalid Account ID.
MISSING_WALLET · 7 · HTTP 400 · invalid_argument
Wallet-specific errors for balance lookups by wallet.
WALLET_RESOLUTION_UNAVAILABLE · 8 · HTTP 502 · unavailable
Wallet Resolution Unavailable.
WALLET_NOT_FOUND · 9 · HTTP 404 · not_found
Wallet Not Found.
UPSTREAM_ERROR · 10 · HTTP 502 · unavailable
Upstream dependency error (e.g., transfers store, wallet resolver).
INVALID_SUBACCOUNT_ID · 11 · HTTP 400 · invalid_argument
subaccount_id is zero or not an encoded public subaccount identifier.

Market overview

Enum marketoverview.v1.ErrorCode, prefix ERROR_CODE_. Market overview reads.

BAD_REQUEST · 1 · HTTP 400 · invalid_argument
Bad request.
INVALID_ARGUMENT · 2 · HTTP 400 · invalid_argument
Invalid argument.
NOT_FOUND · 3 · HTTP 404 · not_found
Not found.
UNAVAILABLE · 4 · HTTP 503 · unavailable
Service unavailable.
UPSTREAM_ERROR · 5 · HTTP 502 · unavailable
Upstream error.

Daily claim

Enum claims.v1.ErrorCode, prefix ERROR_CODE_. Daily campaign reward status and claims.

CLAIM_TEMPORARILY_UNAVAILABLE · 1 · HTTP 503 · unavailable
The claim reward is temporarily unavailable. Please try again later.
UNAUTHENTICATED · 2 · HTTP 401 · unauthenticated
A valid session is required. API keys cannot access claims.
RATE_LIMIT_EXCEEDED · 3 · HTTP 429 · resource_exhausted
The applicable request rate limit was exceeded.
CLAIM_UNAVAILABLE · 4 · HTTP 400 · failed_precondition
No reward is available for the current UTC day.
CONFLICT · 5 · HTTP 409 · aborted
The request encountered concurrent claim activity. Retry the request.
INVALID_REQUEST · 6 · HTTP 400 · invalid_argument
The request payload is invalid.
REQUEST_TOO_LARGE · 7 · HTTP 413 · resource_exhausted
The REST request body exceeds the 1 KiB limit.
SERVICE_UNAVAILABLE · 8 · HTTP 503 · unavailable
The service is temporarily unable to complete the request.
INTERNAL_ERROR · 9 · HTTP 500 · internal
The request failed because of an unexpected server error.
PERMISSION_DENIED · 10 · HTTP 403 · permission_denied
The claim request was not permitted.
FAILED_PRECONDITION · 11 · HTTP 400 · failed_precondition
A required condition for completing the claim was not satisfied.
SOCIAL_VERIFICATION_REQUIRED · 12 · HTTP 400 · failed_precondition
Verify an X or Discord account before claiming a reward.
SUBACCOUNT_NOT_FOUND · 13 · HTTP 404 · not_found
The selected subaccount does not exist or is not owned by the authenticated root account.
SUBACCOUNT_INACTIVE · 14 · HTTP 400 · failed_precondition
The selected subaccount is owned by the authenticated root account but is not active.
CLAIM_PAYOUT_UNAVAILABLE · 15 · HTTP 503 · unavailable
Reward payouts for this campaign are paused. Today's claim is kept and paid automatically once payouts resume.

Swap

Enum swap.v1.ErrorCode. Swap quotes and executions. ConnectRPC only, so there is no HTTP status.

ROUTE_UNSUPPORTED · 1 · failed_precondition
No spot market trades the source asset directly against the destination asset.
AMOUNT_OUT_OF_RANGE · 2 · invalid_argument
The amount is outside the market's current limits. The error carries the limits (min_amount_e18, max_amount_e18) when known.
QUOTE_UNAVAILABLE · 3 · unavailable
No price is currently available for the route; retry later.
PROTECTION_UNACHIEVABLE · 4 · failed_precondition
Current order-book depth cannot deliver min_amount_out_e18 (or the requested slippage): request a new quote.
QUOTE_EXPIRED · 5 · failed_precondition
quote_expires_at has passed: request a new quote.
IDEMPOTENCY_CONFLICT · 6 · already_exists
The idempotency key was already used with a different request. The error carries the original swap_id.
SWAP_NOT_FOUND · 7 · not_found
No Swap of the caller matches the selector.
INVALID_SUBACCOUNT_ID · 8 · invalid_argument
subaccount_id is not a valid sub-account ID.
SUBACCOUNT_NOT_FOUND · 9 · not_found
The sub-account does not exist.
SUBACCOUNT_INACTIVE · 10 · failed_precondition
The sub-account is not active.
SWAP_NOT_PERMITTED · 11 · permission_denied
The caller may not Swap on the account: the role, the API key's policy or the sub-account's policy does not grant SWAP, or a root-scoped API key selected a sub-account.
SERVICE_UNAVAILABLE · 12 · unavailable
A required service is temporarily unavailable; retry the same request.
DIRECTION_UNSUPPORTED · 13 · failed_precondition
The market trades the two assets but cannot execute a Swap in this direction: a buy there would pay its fee in the asset it spends.

QuickSwap broker API

Enum swap.quickswap.v1.ErrorCode. QuickSwap quotes, creates, and broker administration.

ROUTE_UNSUPPORTED · 1 · HTTP 400 · failed_precondition
The source and destination route is not offered, or a bridge was requested with TWAP execution.
AMOUNT_OUT_OF_RANGE · 2 · HTTP 400 · invalid_argument
The amount is outside the route's current limits. The error carries the limits (min_deposit_amount, max_deposit_amount) when known.
DECIMALS_MISMATCH · 3 · HTTP 400 · invalid_argument
An amount's decimals do not match its route's token decimals.
DESTINATION_ADDRESS_INVALID · 4 · HTTP 400 · invalid_argument
destination_address or destination_memo is not valid on the destination network.
RETURN_ADDRESS_INVALID · 5 · HTTP 400 · invalid_argument
return_address or return_memo is not valid on the source network.
REFUND_ADDRESS_REQUIRED · 6 · HTTP 400 · failed_precondition
The route has an intermediate asset and no refund address was supplied.
REFUND_ADDRESS_INVALID · 7 · HTTP 400 · invalid_argument
refund_zipped_asset_id is not a withdraw route of the intermediate asset, or refund_address or refund_memo is not valid on its network.
SOURCE_WALLET_INVALID · 8 · HTTP 400 · invalid_argument
source_wallet is not valid on the source network.
QUOTE_UNAVAILABLE · 11 · HTTP 503 · unavailable
No price is currently available for the route; retry later.
PROTECTION_UNACHIEVABLE · 12 · HTTP 400 · failed_precondition
The protection cannot be met at the current price: a min_amount_out above the expected output, or an order book that cannot fill the protected execution at the quoted prices.
ADDRESS_UNAVAILABLE · 13 · HTTP 503 · unavailable
No deposit address is available right now. The QuickSwap (swap_id in the error) is kept, and its address is allocated automatically when one frees up. Follow it with GetQuickSwap or by repeating the request unchanged. Its quote stays the one priced at creation, and its funding window starts when the address is issued (issued_at).
IDEMPOTENCY_CONFLICT · 14 · HTTP 409 · already_exists
The idempotency key was already used with a different request.
SWAP_NOT_FOUND · 15 · HTTP 404 · not_found
No QuickSwap of this broker matches the selector.
BROKER_DISABLED · 18 · HTTP 403 · permission_denied
The broker is disabled: quotes and creates are refused. Reads and QuickSwaps already created continue.
BROKER_LIMIT · 19 · HTTP 429 · resource_exhausted
A broker limit was reached: the unfunded QuickSwaps held at once, the QuickSwaps created per hour, the request rate of the API key, or the affiliate vaults the broker may create. Nothing is bound to the key. A funded or expired QuickSwap frees an unfunded slot; when the response carries a Retry-After header, retry after that many seconds.
AFFILIATE_VAULT_UNKNOWN · 20 · HTTP 400 · failed_precondition
An affiliate names a vault that is not an active affiliate vault of the broker: unknown, not yet created, disabled, another broker's, or the default vault. Nothing is bound to the key; create or enable the vault and repeat the request.
BROKER_NOT_FOUND · 21 · HTTP 404 · not_found
No broker with this name has the caller as its key or member.
ACTION_DENIED · 22 · HTTP 403 · permission_denied
The caller's role, or a broker API key, may not perform the action.
STEP_UP_REQUIRED · 23 · HTTP 403 · permission_denied
The action needs a fresh step-up proof of the acting member in the X-Auth-Step-Up header, and none was sent or it was already used or expired. Complete an MFA challenge for fresh step-up and repeat the request with the new proof.
VAULT_NOT_FOUND · 24 · HTTP 404 · not_found
The broker has no affiliate vault with this ID.
KEY_NOT_FOUND · 25 · HTTP 404 · not_found
The broker has no API key with this ID, or it no longer works.
KEY_LIMIT · 26 · HTTP 400 · failed_precondition
The broker would have more than two working API keys. Revoke one first.
LAST_KEY · 27 · HTTP 400 · failed_precondition
The key is the broker's last key that works without an expiry; create another key first.
MEMBER_NOT_FOUND · 28 · HTTP 404 · not_found
The person is not a member of the broker and has no pending invite, or the account does not exist.
ALREADY_MEMBER · 29 · HTTP 409 · already_exists
The person is already a member of the broker.
OWNER_IMMUTABLE · 30 · HTTP 400 · failed_precondition
The Owner cannot be removed or given another role; transfer ownership instead.
INVITE_NOT_FOUND · 31 · HTTP 404 · not_found
No pending invite with this ID is addressed to the caller.
FEES_INVALID · 32 · HTTP 400 · invalid_argument
The fees are not valid: more than three affiliates, an affiliate without a valid account_id or with bps outside 1 to 300, a vault named twice, or broker_bps and the affiliates' bps totalling more than 300.
STATS_INCOMPLETE · 33 · HTTP 500 · internal
The broker stats cannot be read: a QuickSwap in the window, named by ErrorDetail.swap_id, is missing a record they need. Contact Polyester broker support with the swap_id.
ADDRESS_CONFLICT · 34 · HTTP 409 · aborted
The QuickSwap (swap_id in the error) cannot be issued a deposit address and never gets one, so nothing can be deposited to it; it is EXPIRED with reason DEPOSIT_ADDRESS_CONFLICT. Create a new QuickSwap with a new idempotency key, and report the swap_id to Polyester broker support.

Private WebSocket requests

Enum privatews.v1.RequestError.Code. RequestError frames on the private WebSocket. A request error does not close the connection.

FORBIDDEN · 1
The subscribe token does not authorize this account for this connection.
INVALID_REQUEST · 2
A field is missing or malformed.
SUBSCRIPTION_UNKNOWN · 3
No such subscription.
CURSOR_INVALID · 4
The resume cursor cannot be read.
TOO_MANY_SUBSCRIPTIONS · 5
The connection already holds 64 subscriptions.
BEHIND · 6
The account's live view did not catch up in time (Sync: 10 seconds).

Error responses How REST, ConnectRPC, and the WebSocket interfaces report errors, how error categories map to HTTP status and Connect codes, and which errors are safe to retry.