What a stable error code means and what to do next
Updated 28 Aug 2026
Use the code and request ID when investigating. Do not infer exchange state from a workspace error, and never retry an execution request blindly.
background_queue_unavailable- The job could not be durably queued. No successful start is confirmed; wait, keep the request ID, and retry only after service recovery.
backtest_failed- The backtest job reached a terminal failure. Open its job status, retain the request ID, and use the retry action after checking the reported cause.
strategy_review_not_ready- Launch checks found blocking conditions. Execution did not start; resolve every listed blocker and request a fresh review.
strategy_start_in_progress- A launch request with this idempotency key is still running. Query that same request instead of changing the key or submitting again.
strategy_start_outcome_unknown- The strategy may already have started although the result could not be saved. Check bots, orders and positions before any retry.
marketplace_evidence_ineligible- The verification snapshot did not meet the public evidence policy. Review every failed criterion and rerun validation before publishing.
marketplace_evidence_expired- The evidence is expired, withdrawn or otherwise inactive. The listing cannot be applied until its owner publishes a fresh eligible snapshot.
not_verified- The exchange credential has not completed security verification. Validate it again under Accounts / Exchanges before execution.
validation_stale- The credential verification is too old or has an invalid timestamp. Revalidate it; trading remains blocked until then.
withdraw_permission- The Live Key can withdraw funds, but protected withdrawals are disabled or unready. Remove Withdraw, or have an administrator complete every security gate and then revalidate the dedicated OKX Live Key.
permissions_invalid- The Key does not have the required Read and Trade permissions. Correct the permissions at the exchange and revalidate.
ip_allowlist_missing- A Live Key has no confirmed IP allowlist. Add the published service IPs at the exchange, then revalidate before trading.
50101- OKX reports a Demo/Live environment mismatch. Use a Demo Key with Demo mode or a Live Key with Live mode, then validate again before trading.
Messages may add context, but the stable code identifies the failure class. Exchange order and position state must still be verified at the exchange.