# 上架出售比特币 Stamp

设定心理价位、授权专用锁定脚本并发布至全局订单簿。

> Source: bitcoinuniverseio/stampdex (private application source), stamps compose dispenser open and close routes, wallet capability table. Applicable release continuous deployment, verify with GET /api/version. Last verified 2026-09-01. Chain bitcoin/mainnet.

> [!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](/docs-stampdex/zh-cn/reference/wallets/).

Read [Release evidence](/docs-stampdex/zh-cn/project/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

```bash frame=none
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:

```bash frame=none
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](/docs-stampdex/zh-cn/reference/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](/docs-stampdex/zh-cn/concepts/bitcoin-stamps/)
- [Change a listing price](/docs-stampdex/zh-cn/guides/change-a-listing-price/)
- [Where your funds are](/docs-stampdex/zh-cn/concepts/custody/)