NFT transfers
Normal transfers, swap transfers, and what a non-fungible move actually commits to.
Protocol behavior Verified 2026-08-31
Describes the Atomicals protocol itself at the pinned reference revision. It does not promise that any product exposes it.
- Page ID
-
protocol/nft/transfers - Normative authority
- Atomicals reference implementation
- Networks
- mainnet
- Documentation version
- 2026.08
- Audience
- holder, developer
- Owner
- bitcoin-universe-docs
- Sources
-
- Atomicals ElectrumX
at
v1.5.2.0 - Atomicals JavaScript CLI
at
1333565efbfe
- Atomicals ElectrumX
at
このコンテンツはまだ日本語訳がありません。
Normal transfer
Section titled “Normal transfer”Spend the output carrying the NFT and arrange outputs so the non-fungible allocation branch places
the object where you intend. The reference CLI exposes transfer-nft and transfer-utxos.
See the CLI reference.
The shape that works:
| Position | Contents |
|---|---|
| Input 0 | The output carrying the NFT |
| Input 1 and later | Cardinal inputs for the fee |
| Output 0 | The recipient |
| Output 1 and later | Cardinal change |
Swap transfer
Section titled “Swap transfer”A swap moves the NFT and its payment in one transaction, with both parties signing. The safety requirements are the same as for fungible swaps: exact output binding, ownership proof separate from signing, and pre-broadcast validation of the whole blueprint. See transfers and swaps.
For the non-fungible lanes, the Universe Marketplace always exposes quantityAtomic as 1,
because the object is indivisible.
What can go wrong
Section titled “What can go wrong”| Problem | Cause | Prevention |
|---|---|---|
| The NFT went somewhere unexpected | The output arrangement placed it differently than you assumed | Model the transfer before signing |
| Several Atomicals moved together | The input carried more than one | Splat first. See splat and mixed outputs |
| The object was spent as ordinary bitcoin | An ordinary wallet chose the output for a fee | Use an Atomicals aware wallet |
| The swap payment was redirected | The seller signature did not bind the payment output | Refuse to sign an unbound swap |
Verifying afterwards
Section titled “Verifying afterwards”Read the asset by Atomical ID and confirm its location matches the output you intended, at a generation past the confirming height. Confirmation alone is not the answer. See verify a transaction.