Skip to main content
Web3·11 min read

Bitcoin Ordinals Marketplace Architecture

How I built Ordwin — a Bitcoin NFT marketplace for Ordinal inscriptions. Indexing, ownership tracking, and the real performance challenges.

By Mussawar Hayat

Inscriptions Are Not Ethereum NFTs

Bitcoin Ordinals attach arbitrary data to sats. Marketplaces must index inscriptions, track UTXO ownership, and settle trades without an EVM-style shared state machine. This post covers the architecture behind Ordwin: indexing pipeline, ownership model, and performance constraints.

What You Will Learn

  • How inscription indexing differs from ERC-721 indexers
  • UTXO ownership and spend paths for transfers
  • Off-chain order books vs fully on-chain settlement
  • Performance bottlenecks in block ingestion
  • Practical checklist for Ordinals products

1. Indexing Pipeline

Run or consume an ord-compatible indexer. Persist inscription metadata, content type, genesis tx, and current outpoint. Reorg handling is mandatory: Bitcoin reorgs are rare but real; your ownership table must roll back cleanly.

2. Ownership Model

An inscription lives on a sat in a UTXO. Transfer means spending that UTXO to a new address. Your marketplace never "moves" an NFT in a contract; it coordinates PSBTs so the seller spends the inscription UTXO to the buyer while receiving payment.

3. Order Flow

  1. Seller creates a partially signed PSBT listing
  2. Marketplace validates inscription outpoint and signature
  3. Buyer completes and broadcasts (or atomic swap variant)
  4. Indexer confirms the new outpoint and updates listings

4. Performance

Full content indexing is expensive. Separate metadata/index from content storage. Cache popular collection views. Watch mempool for spends that invalidate open listings.

5. Production Checklist

  • Reorg-safe indexer
  • Strict PSBT validation before accepting listings
  • Mempool watchers for spent listings
  • Clear UX for fees and confirmation times

Summary

Ordinals marketplaces are UTXO and PSBT products first. Get indexing and ownership right before optimizing the UI.

Key Takeaway

Track outpoints, validate PSBTs, and design for Bitcoin confirmation latency — not EVM transfer events.


Building on Bitcoin Ordinals?

I implement indexing, marketplace flows, and performance-focused frontends for Ordinals products. Get in touch.