Execute a pending order
Reserves the customer’s source funds and starts execution. Makes one immediate attempt only — Conduit does not schedule a retry. Returns 422 INSUFFICIENT_FUNDS if the source balance doesn’t cover totalDebit (principal plus fees); the order stays pending and unclaimed, so the client may fund the source and call this endpoint again before lockExpiresAt. On success, returns the order still status: pending with executionTrigger: "client"; execution completes asynchronously, moving status to succeeded (or failed) and emitting the matching order.* webhook. Callable regardless of the order’s autoExecute value — an autoExecute:true order not yet claimed by Conduit’s automatic execution can still be executed manually here, whichever call reaches it first wins.
Authorizations
Headers
Caller-generated unique key that lets the server safely replay this request. The cached response is returned for 5 minutes on any retry with the same key from the same API principal. Required on every state-changing money-moving or resource-creating POST.
1 - 128^[A-Za-z0-9_.:-]{1,128}$Path Parameters
Response
^ord_[0-9A-Za-z]{22}$^cus_[0-9A-Za-z]{22}$pending, succeeded, failed, cancelled onramp, offramp, 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 that declared a margin which comes to at least one minor unit of the source asset. 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.