unisat-dev-docs

Runes Marketplace API

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


📑 Table of Contents

Route Summary
POST /v3/market/runes/auction/runes_types List Runes market statistics
POST /v3/market/runes/auction/runes_types_specified Get specified Runes market statistics
POST /v3/market/runes/auction/list Search Runes marketplace listings
POST /v3/market/runes/auction/actions List Runes marketplace activity history
POST /v3/market/runes/auction/create_put_on Create Runes listing PSBT draft
POST /v3/market/runes/auction/confirm_put_on Publish signed Runes listing
POST /v3/market/runes/auction/create_bid_prepare Estimate Runes purchase fees and balance
POST /v3/market/runes/auction/create_bid Create Runes purchase PSBT order
POST /v3/market/runes/auction/confirm_bid Submit signed Runes purchase order
POST /v3/market/runes/auction/create_put_off Create Runes delisting PSBT draft
POST /v3/market/runes/auction/confirm_put_off Remove signed Runes listing
POST /v3/market/runes/auction/create_modify_price Create Runes price-update PSBT draft
POST /v3/market/runes/auction/confirm_modify_price Apply signed Runes listing price update
POST /v3/market/runes/auction/create_batch_put_on Create batch Runes listing PSBT drafts
POST /v3/market/runes/auction/confirm_batch_put_on Publish signed batch Runes listings
POST /v3/market/runes/auction/create_batch_bid_prepare Estimate batch Runes purchase fees
POST /v3/market/runes/auction/create_batch_bid Create batch Runes purchase PSBT orders
POST /v3/market/runes/auction/confirm_batch_bid Submit signed batch Runes purchases

Marketplace-Runes

List Runes market statistics

Method: POST
Path: /v3/market/runes/auction/runes_types
Swagger Link: View in Swagger UI

Description

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.

Request Body

Content-Type: application/json

Response (200)

Default Response


Get specified Runes market statistics

Method: POST
Path: /v3/market/runes/auction/runes_types_specified
Swagger Link: View in Swagger UI

Description

Query read-only marketplace statistics for a specified Runes ticker. This query-style POST only reads market data; readonly true and requires confirmation false.

Request Body

Content-Type: application/json

Response (200)

Default Response


Search Runes marketplace listings

Method: POST
Path: /v3/market/runes/auction/list
Swagger Link: View in Swagger UI

Description

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.

Request Body

Content-Type: application/json (required)

Response (200)

Default Response


List Runes marketplace activity history

Method: POST
Path: /v3/market/runes/auction/actions
Swagger Link: View in Swagger UI

Description

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.

Request Body

Content-Type: application/json (required)

Response (200)

Default Response


Create Runes listing PSBT draft

Method: POST
Path: /v3/market/runes/auction/create_put_on
Swagger Link: View in Swagger UI

Description

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.

Request Body

Content-Type: application/json (required)

Response (200)

Default Response


Publish signed Runes listing

Method: POST
Path: /v3/market/runes/auction/confirm_put_on
Swagger Link: View in Swagger UI

Description

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.

Request Body

Content-Type: application/json (required)

Response (200)

Default Response


Estimate Runes purchase fees and balance

Method: POST
Path: /v3/market/runes/auction/create_bid_prepare
Swagger Link: View in Swagger UI

Description

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.

Request Body

Content-Type: application/json (required)

Response (200)

Default Response


Create Runes purchase PSBT order

Method: POST
Path: /v3/market/runes/auction/create_bid
Swagger Link: View in Swagger UI

Description

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.

Request Body

Content-Type: application/json (required)

Response (200)

Default Response


Submit signed Runes purchase order

Method: POST
Path: /v3/market/runes/auction/confirm_bid
Swagger Link: View in Swagger UI

Description

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.

Request Body

Content-Type: application/json (required)

Response (200)

Default Response


Create Runes delisting PSBT draft

Method: POST
Path: /v3/market/runes/auction/create_put_off
Swagger Link: View in Swagger UI

Description

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.

Request Body

Content-Type: application/json (required)

Response (200)

Default Response


Remove signed Runes listing

Method: POST
Path: /v3/market/runes/auction/confirm_put_off
Swagger Link: View in Swagger UI

Description

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.

Request Body

Content-Type: application/json (required)

Response (200)

Default Response


Create Runes price-update PSBT draft

Method: POST
Path: /v3/market/runes/auction/create_modify_price
Swagger Link: View in Swagger UI

Description

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.

Request Body

Content-Type: application/json (required)

Response (200)

Default Response


Apply signed Runes listing price update

Method: POST
Path: /v3/market/runes/auction/confirm_modify_price
Swagger Link: View in Swagger UI

Description

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.

Request Body

Content-Type: application/json (required)

Response (200)

Default Response


Create batch Runes listing PSBT drafts

Method: POST
Path: /v3/market/runes/auction/create_batch_put_on
Swagger Link: View in Swagger UI

Description

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.

Request Body

Content-Type: application/json (required)

Response (200)

Default Response


Publish signed batch Runes listings

Method: POST
Path: /v3/market/runes/auction/confirm_batch_put_on
Swagger Link: View in Swagger UI

Description

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.

Request Body

Content-Type: application/json (required)

Response (200)

Default Response


Estimate batch Runes purchase fees

Method: POST
Path: /v3/market/runes/auction/create_batch_bid_prepare
Swagger Link: View in Swagger UI

Description

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.

Request Body

Content-Type: application/json (required)

Response (200)

Default Response


Create batch Runes purchase PSBT orders

Method: POST
Path: /v3/market/runes/auction/create_batch_bid
Swagger Link: View in Swagger UI

Description

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.

Request Body

Content-Type: application/json (required)

Response (200)

Default Response


Submit signed batch Runes purchases

Method: POST
Path: /v3/market/runes/auction/confirm_batch_bid
Swagger Link: View in Swagger UI

Description

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.

Request Body

Content-Type: application/json (required)

Response (200)

Default Response