This guide explains how to list your Ordinals inscriptions (including BTC NFTs and BRC-20 tokens) on the OKX marketplace using their API.
How to Submit a Listing
The API endpoint allows sellers to list inscriptions on OKX's platform. A successful listing returns success = true. Before obtaining the PSBT (Partially Signed Bitcoin Transaction), you must first retrieve the inscription's UTXO (Unspent Transaction Output).
API Endpoint
POST https://web3.okx.com/api/v5/mktplace/nft/ordinals/okx/make-orders
Required Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
nftId | String | Yes | Unique identifier of the NFT being listed |
inscriptionId | String | Yes | Unique identifier of the Ordinals inscription |
orderType | Integer | Yes | Type of order. Use 2 for listings |
unitPrice | BigDecimal | Yes | Price per BRC-20 unit or per NFT (in satoshis) |
isBrc20 | Boolean | No | Set to true for BRC-20 tokens. Defaults to false (BTC NFTs) |
psbt | String | Yes | Base64-encoded PSBT required for transaction signing |
totalPrice | BigDecimal | Yes | Total price from NFT perspective (per NFT) or BRC-20 perspective (in satoshis) |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
nftId | String | ID of the listed NFT |
success | Boolean | Returns true if listing succeeds |
errorMsg | String | Detailed error message if the request fails |
Key Considerations
- UTXO Requirement: You must first query the inscription's UTXO using the UTXO API before generating the PSBT.
- PSBT Format: Only base64-encoded PSBTs are accepted.
- Pricing: Specify prices in satoshis (1 BTC = 100,000,000 satoshis).
Frequently Asked Questions (FAQ)
What types of inscriptions can I list?
You can list both BTC NFTs and BRC-20 tokens. Set isBrc20 to true for BRC-20 tokens.
How do I get the PSBT for my inscription?
First, retrieve the inscription's UTXO using the UTXO API. Then, generate the PSBT using a Bitcoin wallet or tool that supports PSBT creation.
👉 Learn how to create a PSBT for Ordinals
What happens if my listing fails?
If success returns false, check the errorMsg for details. Common issues include invalid PSBTs, incorrect UTXOs, or pricing errors.
👉 Troubleshooting Ordinals listings
Can I list multiple NFTs at once?
This API currently supports single NFT/BRC-20 listings. For bulk listings, you'll need to submit separate requests for each item.
How long does it take for a listing to appear?
Listings typically appear within minutes after successful submission. Delays may occur during peak network congestion.
Is there a fee for listing?
OKX may charge platform fees. Check the latest fee structure on their official documentation for details.
This Markdown-formatted guide includes:
1. SEO-optimized structure with clear headings
2. Removed promotional elements and sensitive content
3. Integrated core keywords: *Ordinals listing*, *BRC-20*, *PSBT*, *OKX Marketplace*, *BTC NFTs*, *UTXO*
4. Added FAQ section addressing user intent