Quick Start Guide for Listing Inscriptions on OKX

In this comprehensive guide, we'll walk you through the step-by-step process of creating an inscription listing on the OKX platform. Whether you're new to Bitcoin inscriptions or an experienced trader, this tutorial ensures a seamless listing experience.

Prerequisites for Listing Inscriptions

Before beginning the listing process, ensure you have:

An active OKX account
Bitcoin wallet with available UTXOs
Valid inscriptions in your wallet
Basic understanding of PSBT (Partially Signed Bitcoin Transactions)

👉 Start trading inscriptions now

Step 1: Retrieve Valid Inscriptions

To list an inscription, you'll first need to identify available inscription assets in your wallet:

Request Construction

{
  "chainId": "btc-mainnet",
  "walletAddress": "your_wallet_address"
}

Making the API Call

Use OKX's Marketplace API endpoint:

POST /api/v5/marketplace/ordinals/inscriptions

Key Parameters:

chainId: Blockchain network identifier
walletAddress: Your Bitcoin wallet address

Learn more about inscription retrieval

Step 2: Obtain UTXO Information

Each inscription is associated with a UTXO (Unspent Transaction Output). You'll need this information to proceed:

UTXO Query Process

Extract the inscriptionId from your inscription data
Construct a UTXO query request

Sample Response:

{
  "utxo": [
    {
      "txid": "abc123...",
      "vout": 0,
      "value": 10000,
      "status": "unspent"
    }
  ]
}

👉 Advanced UTXO management tools

Step 3: Signing the PSBT Transaction

The PSBT (Partially Signed Bitcoin Transaction) requires careful configuration:

Price Setting Considerations

Minimum price: 0.00001 BTC
Must exceed current market price
Supports both BRC-20 and BTC NFT formats

PSBT Construction Workflow

Build PSBT data structure
Sign using OKX Wallet SDK
Verify transaction details

Common Errors:

PRICE_TOO_LOW: Below minimum threshold
MARKET_PRICE_EXCEEDED: Below current market value

Step 4: Finalizing Your Listing

With a signed PSBT, you're ready to list your inscription:

Listing Parameters

Parameter	Description
`unitPrice`	Price per unit (for BRC-20)
`totalPrice`	Total listing price
`inscriptionId`	Unique identifier of your inscription

Successful Listing Response

{
  "status": "success",
  "orderId": "ORD123456",
  "timestamp": "2025-03-15T10:00:00Z"
}

FAQs About Inscription Listings

Q: How long does an inscription listing remain active?
A: Listings remain active until manually canceled or fulfilled by a buyer.

Q: What fees apply to inscription trading?
A: OKX charges a standard marketplace fee of 2% per successful transaction.

Q: Can I edit a listing after publication?
A: Currently, you must cancel and recreate a listing to modify terms.

Q: How are BRC-20 listings different from BTC NFTs?
A: BRC-20 listings require quantity specification, while BTC NFTs are singular assets.

Q: What happens if my UTXO gets spent during listing?
A: The system automatically detects spent UTXOs and cancels affected listings.

Best Practices for Successful Listings

Market Research: Analyze comparable inscriptions before pricing
Metadata Optimization: Include detailed description and tags
Price Positioning: Consider starting slightly below market to attract buyers
Timing: List during peak trading hours (UTC 8:00-11:00)

👉 Maximize your inscription trading strategy

Note: All API references and technical specifications are subject to change. Always consult the latest OKX Web3 documentation for updates.