List and unlist a stamp
Source and verification
- Owning repository
- bitcoinuniverseio/stampdex (private application source)
- Source path
- stamps compose dispenser open and close routes, wallet capability table
- 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
For: a stamp owner with a supported wallet. Goal: an open dispenser holding your stamp at a price you set, or that dispenser closed again. Chain and network: Bitcoin mainnet. Version: continuous.
Safety: opening a dispenser escrows the stamp under Counterparty at your own address. StampDEX never holds it. Closing does not return it instantly, because Counterparty enforces a cooldown.
Before you start
Section titled “Before you start”Check your wallet can do this. Opening and closing a dispenser has not been run end to end through any wallet on StampDEX, and Leather, Xverse, and OKX Wallet expose nothing that performs it, so StampDEX hides the action for those three rather than showing a button that fails. Universe Wallet and UniSat are offered with that caveat stated on screen. See Wallets.
Read Release evidence before you rely on this for anything valuable. The builders exist and are unit tested; a controlled mainnet run has not been recorded.
Steps to list
Section titled “Steps to list”- Open the stamp page for a stamp you own.
- Open a dispenser. Set the quantity to escrow and the asking rate in sats.
- Review the transaction StampDEX composes, then sign it in your wallet.
- When it confirms, the dispenser is open and the stamp is listed at your rate.
Steps to unlist
Section titled “Steps to unlist”- Find your dispenser, from the stamp page or from your dispensers list.
- Choose to close it. StampDEX composes the close.
- Sign, and wait for confirmation.
Expected result
Section titled “Expected result”Listing: an open dispenser on the stamp page showing your rate and the quantity remaining. Unlisting: the dispenser status changes to closed. The stamp returns to your free balance once the cooldown finalizes, which is later.
How to verify
Section titled “How to verify”curl "https://stamp.api.bitcoinuniverse.io/api/v1/stamps/STAMP_ID/dispensers"Your dispenser appears with its status and give_remaining. You can also read every
dispenser an address operates:
curl "https://stamp.api.bitcoinuniverse.io/api/v1/stamps/wallet/ADDRESS/dispensers"The cooldown, stated plainly
Section titled “The cooldown, stated plainly”Closing a dispenser does not immediately refund the escrowed stamp. Counterparty enforces a close delay, so a stamp you have just delisted stays escrowed until that finalizes. During that window you cannot send it, and you cannot open a new dispenser with it.
This is protocol behaviour, not a StampDEX policy, and nothing at the marketplace layer can shorten it.
Common failure states
Section titled “Common failure states”| You see | What happened | What to do |
|---|---|---|
| The open or close action is not offered | Your wallet cannot perform it here | Use a wallet that can. See Wallets |
| “sellerAddress, cpid, giveQuantity, and satoshiRate are required” | A field was missing from the request | Fill every field on the form |
| “must be a Bitcoin transaction hash” | A dispenser id was malformed | Copy the dispenser transaction hash again |
| No signable transaction, with a warning instead | Input data could not be recovered, so an uninspectable transaction was withheld | Retry later. This refusal is deliberate |
| The stamp is still escrowed after closing | The Counterparty cooldown has not finalized | Wait. Nothing is lost |
Recovery path
Section titled “Recovery path”A close that confirms always ends with the stamp back under your control after the cooldown. There is no StampDEX-held state to recover, because there never was any.