Order states

The values in the first column are what the API returns in an order’s status field. The friendly names are what the site shows.

Pick an order state

OpenPendingAwaiting transferAwaiting confirmationFilledCancelledExpiredFailed

Open open

Where the BTC is

Nothing committed by anyone

Where the tokens are

In listing escrow, locked to this listing

Valid next states

Pending pendingCancelled cancelledExpired expired

Pending pending

Where the BTC is

Buyer's payment in listing escrow

Where the tokens are

In listing escrow

Valid next states

Awaiting transfer awaiting_tx3Pending pendingFailed failedExpired expired

Awaiting transfer awaiting_tx3

Where the BTC is

In listing escrow

Where the tokens are

Transfer transaction broadcast, waiting for confirmations

Valid next states

Settling settling_tx3Awaiting confirmation awaiting_tx3_confirmationFailed failed

Awaiting confirmation awaiting_tx3_confirmation

Where the BTC is

In listing escrow until confirmations land

Where the tokens are

In the transfer transaction, one confirmation away

Valid next states

Filled filledFailed failed

Filled filled

Where the BTC is

Paid to the seller, fee deducted

Where the tokens are

In the buyer's wallet

Valid next states

None. This state is final.

Cancelled cancelled

Where the BTC is

Nothing was committed

Where the tokens are

Returned to the seller

Valid next states

None. This state is final.

Expired expired

Where the BTC is

Nothing committed, or already recovered

Where the tokens are

Back with the seller

Valid next states

None. This state is final.

Failed failed

Where the BTC is

In escrow, recoverable by the recovery flow

Where the tokens are

In escrow, recoverable by the recovery flow

Valid next states

None. This state is final.

Recovery

Escrow released nothing. The recovery flow returns each side its own value. See Recovery.

State (API value)	Where the BTC is	Where the tokens are	Next
Preparing draftinternal	Not committed anywhere	Seller still holds the tokens	Open, Expired
Open open	Nothing committed by anyone	In listing escrow, locked to this listing	Pending, Cancelled, Expired
Pending pending	Buyer's payment in listing escrow	In listing escrow	Awaiting transfer, Pending, Failed, Expired
Awaiting transfer awaiting_tx3	In listing escrow	Transfer transaction broadcast, waiting for confirmations	Settling, Awaiting confirmation, Failed
Settling settling_tx3internal	In listing escrow	A settlement worker is verifying and broadcasting the transfer	Awaiting confirmation, Failed
Awaiting confirmation awaiting_tx3_confirmation	In listing escrow until confirmations land	In the transfer transaction, one confirmation away	Filled, Failed
Filled filled	Paid to the seller, fee deducted	In the buyer's wallet	final
Cancelled cancelled	Nothing was committed	Returned to the seller	final
Expired expired	Nothing committed, or already recovered	Back with the seller	final
Failed failed	In escrow, recoverable by the recovery flow	In escrow, recoverable by the recovery flow	final

Which states a listing query returns

• With no status filter, the open book is returned.
• pending rows are excluded from the public book, so a listing somebody is mid-way through buying does not appear as available inventory.
• An open row must have its signed listing and its escrow details recorded. An incomplete listing is never shown as inventory.
• Rows past their expiry are excluded.
• The public book sorts by unit price ascending, then newest first.
• Filtering by a wallet address returns that address’s orders in open, awaiting_tx3, settling_tx3, awaiting_tx3_confirmation, and filled, sorted newest first.

Replacement links

An order created by repricing, splitting, or repairing another carries the link between them:

Field	Meaning
replacesOrderId	The order this one was created to replace
replacedByOrderId	The order that replaced this one
replacementGroupId	The group, when one listing was split into several
replacementKind	price, split, or repair

None of these make a replacement an in-place edit. The old order is cancelled and the new one is a new order. See Change a listing price.

Related

• Order lifecycle
• Where your funds are
• Orders endpoints