This guide explains how to list individual Runes inscriptions on the OKX marketplace using their Web3 API. Before listing, you can check your wallet's Runes holdings using the asset retrieval endpoint.
API Endpoint
POST https://web3.okx.com/api/v5/mktplace/nft/runes/make-order
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
runesId | String | Yes | Unique Runes token ID (e.g., 840000:3) |
walletAddress | String | Yes | Wallet address holding the Runes inscription |
utxo | String | Yes | UTXO containing the Runes token (format: txHash:vout) |
unitPrice | BigDecimal | Yes | Price per unit in satoshis |
totalPrice | BigDecimal | Yes | Total listing price in BTC |
psbt | String | Yes | Base64-encoded PSBT with signed transaction details |
Response Parameters
| Field | Type | Description |
|---|---|---|
code | Integer | Status code (0 = success) |
data | Object | Response payload |
msg | String | Status message |
Key Features
- Secure Transactions: Uses PSBT (Partially Signed Bitcoin Transactions) for safe order submission.
- Precision Pricing: Supports pricing in both satoshis and BTC.
- UTXO Verification: Ensures valid Runes token ownership before listing.
👉 Explore more Web3 API solutions for advanced blockchain integrations.
FAQ
Q: How do I find my Runes inscriptions before listing?
A: Use the wallet asset API to retrieve your holdings.
Q: What format should the UTXO field use?
A: Provide it as transactionHash:outputIndex (e.g., abc123...:0).
Q: Can I modify an existing order?
A: Current orders cannot be edited – cancel and create a new listing instead.
For developers building Runes marketplaces, this API provides essential infrastructure. 👉 Discover additional Web3 tools to enhance your platform's capabilities.