Search K
Orders

Order statuses

InformationThe order status reflects the current state of the exchange. The statusNote field provides additional context and is included only when it is necessary to clarify the reason for a delay, error, refund, or action required from the user.

Information about status ​

Use the status field as the primary source of information about the order state. It is this value that determines the current processing stage.

Parameter definitions ​

Value
Description
AWAITING_DEPOSIT
Order created and awaiting deposit
CONFIRMING_DEPOSIT
Deposit received and awaiting confirmation
EXCHANGING
Asset exchange in progress
SENDING
Funds are being sent to the receiving address
HOLD
Order processing temporarily paused
COMPLETE
Order successfully completed
REFUND
Order refunded
FAILED
Order processing failed
ACTION_REQUEST
Additional action required to continue

Information about statusNote ​

The statusNote field complements status and helps to more accurately determine the reason for the current order state. It does not replace the status and should not be used separately from it.Use statusNote when a single status value is not enough to understand the situation.

Parameter definitions ​

Value
Description
PROCESSING_DELAYED
Order processing is taking longer than usual
PROCESSING_DELAYED_NETWORK
Processing is delayed due to network conditions
RECEIVE_ADDRESS_HIGH_RISK
Receiving address is marked as high risk
REFUND_ADDRESS_HIGH_RISK
Refund address is marked as high risk
RECEIVE_ADDRESS_REJECTED
Receiving address rejected
REFUND_ADDRESS_REJECTED
Refund address rejected
RECEIVE_ADDRESS_INVALID
Invalid receiving address specified
REFUND_ADDRESS_INVALID
Invalid refund address specified
RECEIVE_TAG_REQUIRED
Tag or memo is required for the receiving address
REFUND_TAG_REQUIRED
Tag or memo is required for the refund address
DEPOSIT_NETWORK_MAINTENANCE
Deposit network is temporarily unavailable
RECEIVE_NETWORK_MAINTENANCE
Receiving network is temporarily unavailable
REFUND_NETWORK_MAINTENANCE
Refund network is temporarily unavailable
WITHDRAWAL_FAILED
Failed to send funds to the receiving address
ORDER_EXPIRED
Order has expired

How to handle status and statusNote ​

Always process status as the primary state field. If statusNote is present in the response, use it as additional context for the interface, integration logic, or displaying the reason for an error.

Enum examples ​

Enum values must exactly match the values returned by the API. This prevents errors when comparing statuses in code.
status
export const OrderStatus = {
  AWAITING_DEPOSIT: "AWAITING_DEPOSIT",
  CONFIRMING_DEPOSIT: "CONFIRMING_DEPOSIT",
  EXCHANGING: "EXCHANGING",
  SENDING: "SENDING",
  HOLD: "HOLD",
  COMPLETE: "COMPLETE",
  REFUND: "REFUND",
  FAILED: "FAILED",
  ACTION_REQUEST: "ACTION_REQUEST",
};
statusNote
export const OrderStatusNoteEnum = {
  PROCESSING_DELAYED: "PROCESSING_DELAYED",
  PROCESSING_DELAYED_NETWORK: "PROCESSING_DELAYED_NETWORK",
  RECEIVE_ADDRESS_HIGH_RISK: "RECEIVE_ADDRESS_HIGH_RISK",
  REFUND_ADDRESS_HIGH_RISK: "REFUND_ADDRESS_HIGH_RISK",
  REFUND_ADDRESS_REJECTED: "REFUND_ADDRESS_REJECTED",
  RECEIVE_ADDRESS_REJECTED: "RECEIVE_ADDRESS_REJECTED",
  RECEIVE_ADDRESS_INVALID: "RECEIVE_ADDRESS_INVALID",
  REFUND_ADDRESS_INVALID: "REFUND_ADDRESS_INVALID",
  RECEIVE_TAG_REQUIRED: "RECEIVE_TAG_REQUIRED",
  REFUND_TAG_REQUIRED: "REFUND_TAG_REQUIRED",
  DEPOSIT_NETWORK_MAINTENANCE: "DEPOSIT_NETWORK_MAINTENANCE",
  RECEIVE_NETWORK_MAINTENANCE: "RECEIVE_NETWORK_MAINTENANCE",
  REFUND_NETWORK_MAINTENANCE: "REFUND_NETWORK_MAINTENANCE",
  WITHDRAWAL_FAILED: "WITHDRAWAL_FAILED",
  ORDER_EXPIRED: "ORDER_EXPIRED",
};
Updated