上架出售比特币 Stamp

[!NOTE] 简体中文官方文档：指导卖家如何合理设定价格并确保资产在挂单期间处于安全锁定中。 核心交易规则为非托管模式，买卖双方按标准费率收取服务费，并于比特币主网进行原子结算。

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

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

1. Open the stamp page for a stamp you own.
2. Open a dispenser. Set the quantity to escrow and the asking rate in sats.
3. Review the transaction StampDEX composes, then sign it in your wallet.
4. When it confirms, the dispenser is open and the stamp is listed at your rate.

Steps to unlist

1. Find your dispenser, from the stamp page or from your dispensers list.
2. Choose to close it. StampDEX composes the close.
3. Sign, and wait for confirmation.

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

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

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

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

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.

Related

• Bitcoin Stamps
• Change a listing price
• Where your funds are