Skip to content

Order states

Source and verification
Owning repository
bitcoinuniverseio/stampdex (private application source)
Source path
OrderStatus enum, orders list filtering, expiry crons
Applicable release
continuous deployment, verify with GET /api/version
Chain and network
bitcoin / mainnet
Lifecycle
stable
Last verified
2026-09-01
This page
Edit on GitHub · Bitcoin Universe platform

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.

API valueShown asMeaningWhere the BTC isWhat ends it
draftDraftPrepared, not signed. Buyers never see itUntouched in the seller’s walletThe seller signs, or 30 minutes pass
openOpenLive on the bookNo buyer funds involvedA buyer locks it, or the seller cancels
pendingPendingLocked by one buyer who is payingIn the buyer’s wallet until the payment broadcastsThe buyer pays, or 30 minutes pass
awaiting_tx3Awaiting transferThe payment is broadcast, waiting on confirmation and an index checkIn the listing escrowThe check passes, or the grace period expires
settling_tx3SettlingA worker is verifying and broadcasting the token transferIn the listing escrowThe transfer broadcasts, or the order fails
awaiting_tx3_confirmationAwaiting confirmationThe transfer is broadcast and needs two blocks of depthIn the listing escrowTwo confirmations
filledFilledSettledDelivered to the seller, less their feeNothing. It is final
cancelledCancelledThe seller cancelled before a saleReturned, or never movedNothing
expiredExpiredA draft or a buyer lock ran out of timeNever movedNothing
failedFailedThe payment confirmed but the token balance was not verified in timeHeld in the listing escrow, not lostAn operator
  • 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.

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

FieldMeaning
replacesOrderIdThe order this one was created to replace
replacedByOrderIdThe order that replaced this one
replacementGroupIdThe group, when one listing was split into several
replacementKindprice, 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.