This API provides endpoints for Runes marketplace services, including Rune market statistics, listing search, price information, activity history, and marketplace order workflows.
👉 View Swagger UI
Method: POST
Path: /v3/market/runes/auction/runes_types
Swagger Link: View in Swagger UI
Query read-only Runes marketplace statistics such as price, volume, market capitalization, holders, and transaction counts. This query-style POST only reads market data; readonly true and requires confirmation false.
Content-Type: application/json
timeType (object): Optional: day1, day7, day30; enum: day1, day7, day30start (number):limit (number):Default Response
code (number): requiredmsg (string): requireddata (object):
BTCPrice (number): requiredlist (array):
tick (string): requiredcurPrice (number): requiredchangePrice (number): requiredbtcVolume (number): requiredamountVolume (number): requiredcap (string): requiredholders (integer):transactions (integer):warning (boolean):Method: POST
Path: /v3/market/runes/auction/runes_types_specified
Swagger Link: View in Swagger UI
Query read-only marketplace statistics for a specified Runes ticker. This query-style POST only reads market data; readonly true and requires confirmation false.
Content-Type: application/json
timeType (string): enum: day1, day7, day30tick (string):Default Response
code (number): requiredmsg (string): requireddata (object):
tick (string):symbol (string):curPrice (number):changePrice (number):btcVolume (number):amountVolume (number):cap (string):capUSD (string):deployTime (integer):holders (integer):number (integer):transactions (integer):warning (boolean):Method: POST
Path: /v3/market/runes/auction/list
Swagger Link: View in Swagger UI
Query read-only Runes marketplace listings with filters, sorting, and pagination. This query-style POST only reads marketplace data; readonly true and requires confirmation false.
Content-Type: application/json (required)
filter (object):
nftType (string): required; enum: runesaddress (string):tick (string):minPrice (number):maxPrice (number):nftConfirm (boolean):isEnd (boolean): Whether order endsall (boolean): Ignore start and limit and return all collection datasort (object):
unitPrice (number): enum: 1, -1onSaleTime (number): enum: 1, -1initPrice (number): enum: 1, -1inscriptionNumber (number): enum: 1, -1start (number): required; The data is looked up from startlimit (number): required; Limit the amount of dataDefault Response
code (number): requiredmsg (string): requireddata (object):
list (array):
auctionId (string):inscriptionId (string): requiredinscriptionNumber (number):marketType (string):address (string):price (number):nftType (string):tick (string): Brc20 fieldlimit (number): Brc20 fieldamount (number): Brc20 fieldunitPrice (number): Brc20 fieldtotal (number): requiredtimestamp (number):Method: POST
Path: /v3/market/runes/auction/actions
Swagger Link: View in Swagger UI
Query read-only Runes marketplace activity history such as listings, delistings, sales, claims, and updates. This query-style POST only reads marketplace data; readonly true and requires confirmation false.
Content-Type: application/json (required)
filter (object):
nftType (string): enum: runesaddress (string):inscriptionId (string):event (string): Event type: Cancel, Listed, Sold, Updated; enum: Cancel, Claim, Listed, Sold, Updatedtick (string):start (number): requiredlimit (number): requiredDefault Response
code (number): requiredmsg (string): requireddata (object):
list (array):
auctionId (string): requiredinscriptionId (string): requiredinscriptionNumber (number): requiredevent (string): required; enum: Listed, Sold, Cancel, Claim, Updatedprice (number): requiredfrom (string): requiredto (string): requiredtimestamp (number): requirednftConfirmNum (number):nftType (string): enum: brc20, domain, collectionendMsg (string): An error message generated by the ordernewest (boolean): The update order generates multiple eventsname (string): Brc20 filedunitPrice (number): Brc20 filedamount (number): Brc20 fileddomain (string): Domain fileddomainType (string): Domain filed; enum: sats, unisat, btc, xbt, ord, gm, bitmap, x, nulldomainCategorys (array): Domain filedcollectionId (string): Collection filedcollectionItemName (string): Collection filedcontentType (string): Collection filedcontentBody (string): Collection filedattributes (array): Collection filed
trait_type (string):value (string):total (number): requiredMethod: POST
Path: /v3/market/runes/auction/create_put_on
Swagger Link: View in Swagger UI
Creates a Runes listing draft and returns auctionId, PSBT, and signing indexes for the seller. Review rune UTXO, rune amount, initPrice, unitPrice, marketType, and receiving address before signing or confirming the listing.
Content-Type: application/json (required)
nftType (string):txid (string): required; The txid of the rune utxo txidindex (string): required; The txid of the rune utxo indexinitPrice (string): required; Set the initial total priceunitPrice (string): required; Unit Price (for tick)pubkey (string): required; User public keymarketType (string): required; enum: fixedPrice; example: "fixedPrice"btcAddress (string): (Optional) Only for multi-address wallet, such as Xverse, hiro. Specifies the BTC receive addressDefault Response
code (number): requiredmsg (string): requireddata (object):
auctionId (string): requiredpsbt (string): requiredsignIndexes (array): Specifies the signature location used by the xverse walletMethod: POST
Path: /v3/market/runes/auction/confirm_put_on
Swagger Link: View in Swagger UI
Confirms the seller-signed listing PSBT and activates the Runes marketplace listing. Verify auctionId, PSBT encoding, rune amount, listing price, seller address, and market type before submitting.
Content-Type: application/json (required)
auctionId (string): requiredpsbt (string): requiredfromBase64 (boolean): Is Base64 format, the default is hex formatDefault Response
code (number): requiredmsg (string): requireddata (object):Method: POST
Path: /v3/market/runes/auction/create_bid_prepare
Swagger Link: View in Swagger UI
Returns pre-purchase fee estimates, available balances, network fee rate, transaction size, and inscription value for a Runes auction. This is a quote/material preparation step only; before any later purchase submission, verify auctionId, bidPrice, buyer address, feeRate, and rune amount.
Content-Type: application/json (required)
auctionId (string): requiredbidPrice (number): requiredaddress (string): required; Bidder addresspubkey (string): required; Bidder pubkeyDefault Response
code (number): requiredmsg (string): requireddata (object):
serverFee (number): Expected service fee.serverReal (number): Real service fee.serverFeeRate (number): Real service fee rate.txSize (number): Estimated transaction sizenftValue (number): Satoshis carried by the inscriptionfeeRate (number): Network fee rateavailableBalance (number): Available confirmed balance for the userallBalance (number): Available total balance for the userMethod: POST
Path: /v3/market/runes/auction/create_bid
Swagger Link: View in Swagger UI
Creates a Runes marketplace purchase order and returns bidId, PSBT data, signing indexes, server/network fees, feeRate, and inscription value. Confirm auctionId, bidPrice, buyer address, rune name/amount, and fee totals before requesting signatures.
Content-Type: application/json (required)
auctionId (string): requiredbidPrice (number): requiredaddress (string): required; Bidder addresspubkey (string): required; Bidder pubkeyfeeRate (number): The user sets the ratenftAddress (string): (Optional) Only for multi-address wallet, such as Xverse, hiro. Inscription receiving addressutxos (array): Custom utxo
txid (string):index (number):Default Response
code (number): requiredmsg (string): requireddata (object):
bidId (string): requiredpsbtBid (string): required; Bid psbtpsbtBid2 (string): Auction mode is used, and the current empty string can be passedpsbtSettle (string): Auction mode is used, and the current empty string can be passedserverFee (number): required; The service fee charged by the platformnetworkFee (number): required; BTC network total feefeeRate (number): required; BTC network fee ratenftValue (number): requiredbidSignIndexes (array): Specifies the bid signature location used by the xverse walletMethod: POST
Path: /v3/market/runes/auction/confirm_bid
Swagger Link: View in Swagger UI
Submits the signed Runes purchase PSBT and returns the settlement transaction id when accepted. Before calling, verify auctionId, bidId, PSBT content, final price, rune amount, buyer/seller addresses, and fee values because this can settle the purchase.
Content-Type: application/json (required)
auctionId (string): requiredbidId (string): requiredpsbtBid (string): requiredpsbtBid2 (string): Auction mode is used, and the current empty string can be passedpsbtSettle (string): Auction mode is used, and the current empty string can be passedfromBase64 (boolean): Is Base64 format, the default is hex formatDefault Response
code (number): requiredmsg (string): requireddata (object):
txid (string): required; Transaction txidMethod: POST
Path: /v3/market/runes/auction/create_put_off
Swagger Link: View in Swagger UI
Creates delisting signing material for an active Runes marketplace order, including PSBT/signing data when needed. Confirm auctionId, owner addresses, and rune amount before signing because the next confirmation removes the listing.
Content-Type: application/json (required)
auctionId (string): requirednftAddress (string): (Optional) Only for multi-address wallet, such as Xverse, hiro. Inscription receiving address.btcPubkey (string): (Optional) Only for multi-address wallet, such as Xverse, hiro. The public key used in the inscription of the order.utxos (array): Custom utxo
txid (string):index (number):rbf (boolean):offChain (boolean):Default Response
code (number): requiredmsg (string): requireddata (object):
psbt (string): requiredtxSize (number):btcSignIndexes (array): Specifies the btc signature location used by the xverse walletnftSignIndexes (array): Specifies the nft signature location used by the xverse walletMethod: POST
Path: /v3/market/runes/auction/confirm_put_off
Swagger Link: View in Swagger UI
Confirms signed delisting data and removes the Runes listing from the marketplace. Verify auctionId, PSBT/signature payload, owner address, and target rune amount before submitting.
Content-Type: application/json (required)
auctionId (string): requiredpsbt (string): requiredfromBase64 (boolean): Is Base64 format, the default is hex formatoffChain (boolean):Default Response
code (number): requiredmsg (string): requireddata (object):
txid (string): requiredMethod: POST
Path: /v3/market/runes/auction/create_modify_price
Swagger Link: View in Swagger UI
Creates signing material to update an existing Runes listing price. Verify auctionId, current rune amount, old and new prices, seller address, and returned PSBT/sign indexes before signing.
Content-Type: application/json (required)
auctionId (string): requiredinitPrice (string): requiredunitPrice (string): requiredDefault Response
code (number): requiredmsg (string): requireddata (object):
psbt (string): requiredsignIndexes (array): Specifies the signature location used by the xverse walletMethod: POST
Path: /v3/market/runes/auction/confirm_modify_price
Swagger Link: View in Swagger UI
Confirms signed price-update data and changes the active Runes listing price. Verify auctionId, signed PSBT, rune amount, seller address, and final price before submitting.
Content-Type: application/json (required)
auctionId (string): requiredpsbt (string): requiredfromBase64 (boolean): requiredDefault Response
code (number): requiredmsg (string): requireddata (object):Method: POST
Path: /v3/market/runes/auction/create_batch_put_on
Swagger Link: View in Swagger UI
Creates multiple Runes listing drafts and returns signing material for each listing. Verify every rune UTXO, asset amount, listing price, seller address, auctionId, and PSBT/sign index before signing.
Content-Type: application/json (required)
unitPrice (string): required; Unit Price (for tick)pubkey (string): required; User public keynftType (string):btcAddress (string): (Optional) Only for multi-address wallet, such as Xverse, hiro. Specifies the BTC receive addressutxos (array): Custom utxo
txid (string):index (number):Default Response
code (number): requiredmsg (string): requireddata (object):
batchAuctionId (string):psbt (string): requiredsignIndexes (array): Specifies the signature location used by the xverse walletMethod: POST
Path: /v3/market/runes/auction/confirm_batch_put_on
Swagger Link: View in Swagger UI
Confirms signed PSBTs and activates multiple Runes marketplace listings. Verify every auctionId, signed PSBT, rune amount, listing price, seller address, and market type before submitting.
Content-Type: application/json (required)
batchAuctionId (string): requiredpsbt (string): requiredfromBase64 (boolean): Is Base64 format, the default is hex formatDefault Response
code (number): requiredmsg (string): requireddata (object):Method: POST
Path: /v3/market/runes/auction/create_batch_bid_prepare
Swagger Link: View in Swagger UI
Returns quote-only fee, balance, transaction-size, and valid-listing data for multiple Runes purchases. This does not submit orders; before any later batch purchase, verify every auctionId, bid price, buyer address, rune amount, and fee estimate.
Content-Type: application/json (required)
auctionIds (array):address (string): required; Bidder addresspubkey (string): required; Bidder pubkeyDefault Response
code (number): requiredmsg (string): requireddata (object):
serverFee (number): Expected service fee.serverReal (number): Real service fee.serverFeeRate (number): Real service fee rate.txSize (number): Estimated transaction sizefeeRate (number): Network fee rateavailableBalance (number): Available confirmed balance for the uservalidAuctionIds (array):invalidAuctionIds (array):Method: POST
Path: /v3/market/runes/auction/create_batch_bid
Swagger Link: View in Swagger UI
Creates multiple Runes purchase orders and returns per-order signing material. Confirm every auctionId, bid price, buyer address, rune amount, feeRate, and returned PSBT/sign indexes before signing.
Content-Type: application/json (required)
auctionIds (array):bidPrices (array):address (string): required; Bidder addresspubkey (string): required; Bidder pubkeyfeeRate (number): The user sets the ratenftAddress (string): (Optional) Only for multi-address wallet, such as Xverse, hiro. Inscription receiving addressDefault Response
code (number): requiredmsg (string): requireddata (object):
bidId (string): requiredpsbtBid (string): required; Bid psbtserverFee (number): required; The service fee charged by the platformnetworkFee (number): required; BTC network total feefeeRate (number): required; BTC network fee ratebidSignIndexes (array): Specifies the bid signature location used by the xverse walletMethod: POST
Path: /v3/market/runes/auction/confirm_batch_bid
Swagger Link: View in Swagger UI
Confirms signed batch purchase PSBTs and can settle multiple Runes orders. Verify each auctionId, bidId, PSBT, final price, buyer/seller address, rune amount, and fee value before submitting.
Content-Type: application/json (required)
bidId (string): requiredpsbtBid (string): requiredfromBase64 (boolean): Is Base64 format, the default is hex formatDefault Response
code (number): requiredmsg (string): requireddata (object):
txid (string): required; Transaction txid