Cancel a pending order
Cancels a pending order, releasing any in-flight source reservation. An order that has begun executing still cancels while its source transfer can be stopped — including the whole window in which that transfer waits for the customer signature, the stage the order’s transaction reports while it waits. Past that point the funds are on their way and the call returns 409 ORDER_NOT_CANCELLABLE, as it does for an order executing from a source that runs no such transfer. Already-cancelled orders return 200 (idempotent). Orders in terminal states (succeeded, failed) return 409. 409 ORDER_CANCEL_IN_PROGRESS means the source transfer cannot answer yet, or it accepted the cancellation and the terminal state is not recorded yet; retry, or read the order until it settles.
Authorizations
Headers
Caller-generated unique key that lets the server safely replay this request. The original response is returned for 30 days on any retry with the same key from the same organization. Required on every state-changing money-moving or resource-creating POST.
1 - 128^[A-Za-z0-9_.:-]{1,128}$"01J7B3K2X9M8N5P6Q7R8S9T0V1"
Path Parameters
"ord_1A2b3C4d5E6f7G8h9I0jKl"
Response
^ord_[0-9A-Za-z]{22}$^cus_[0-9A-Za-z]{22}$pending, succeeded, failed, cancelled onramp, offramp, conversion, fiat_conversion - Option 1
- Option 2
source, destination Deadline for execution to begin, not merely for the source to be funded. If execution hasn't been claimed by this time, the order transitions to status: cancelled with cancellationReason: 'expired' and can no longer execute — funding the source after this timestamp does not revive it. Create a new order to get a fresh rate lock.
"2026-01-15T09:30:00.000Z"
ISO 8601 timestamp
"2026-01-15T09:30:00.000Z"
Echoes the create-time value. When true, Conduit automatically claims execution once the available source balance covers totalDebit (principal plus fees), with no client action required — orders sharing the same source resource execute oldest-first, so a still-underfunded older order can delay a newer, already-funded one; when false, the client must call POST /v2/orders/{id}/execute (repeatable after funding if a prior attempt returned 422 INSUFFICIENT_FUNDS). Order creation never checks or reserves the source's available balance regardless of this value.
^txn_[0-9A-Za-z]{22}$Client-supplied reference, unique per resource within your organization. 1-255 characters from A-Za-z, 0-9, underscore, hyphen, colon, and period — no spaces.
^[A-Za-z0-9_\-:.]{1,255}$The funding resource, when the order named one. Omitted entirely on a deposit-funded order (created without a source): the funding wallet is Conduit-managed infrastructure with no client-resolvable id, and depositInstructions carries the address to fund at instead. The presence of depositInstructions is the discriminator.
- Option 1
- Option 2
AutoPayout payload. Crypto recipients omit rail/ach/swift/instant/remittance; fiat (us|swift) recipients require rail and may carry the matching per-rail context block.
Present on an order carrying a margin which comes to at least one minor unit of the source asset — one the order declared, or one it inherited from the quote option it redeemed. assetAmount is the total accrued to you, fixed at quote time. The two shapes reach the customer differently: the markupBps part is folded into the quoted rate, so it never appears in fees[] and does not move totalDebit, while the markupAmount part is a line item in fees[] owned by you and it does move totalDebit.
ISO 8601 timestamp
"2026-01-15T09:30:00.000Z"
Which path claimed execution: 'client' for a POST /v2/orders/{id}/execute call, 'auto' for automatic execution by Conduit. Set as soon as execution is claimed — well before the order reaches a terminal status — so it can appear on an order that is still status: pending while its conversion is in flight. Absent on an order that hasn't started executing yet (including one cancelled before execution began).
client, auto ISO 8601 timestamp
"2026-01-15T09:30:00.000Z"
expired, client_cancelled insufficient_funds, provider_unavailable, provider_rejected, internal_error, cancelled Present when this order redeemed a POST /v2/quotes option — the id of the option it consumed.
^qop_[0-9A-Za-z]{22}$Where to send funds to fund this order. Exactly one crypto_address block.
1 elementTransfers that funded this order, with how much of each it draws. Present on the order detail read for an order funded at a Conduit funding address; omitted on the list read and on an order that names its own source.