unisat-dev-docs

Ordinals Domain Marketplace API

This API provides endpoints for Ordinals domain marketplace services, including domain type statistics, domain listing search, inscription details, activity history, and marketplace order workflows.

👉 View Swagger UI


📑 Table of Contents

Route Summary
POST /v3/market/domain/auction/domain_types List domain type market statistics
POST /v3/market/domain/auction/domain_statistic Get domain type category statistics
POST /v3/market/domain/auction/inscription_info Get marketplace inscription detail
POST /v3/market/domain/auction/inscription_info_list Get marketplace inscription details in batch
POST /v3/market/domain/auction/list Search Ordinals domain marketplace listings
POST /v3/market/domain/auction/actions List Ordinals domain marketplace activity history
POST /v3/market/domain/auction/create_put_on Create domain listing PSBT draft
POST /v3/market/domain/auction/confirm_put_on Publish signed domain listing
POST /v3/market/domain/auction/create_bid_prepare Estimate domain purchase fees and balance
POST /v3/market/domain/auction/create_bid Create domain purchase PSBT order
POST /v3/market/domain/auction/confirm_bid Submit signed domain purchase order
POST /v3/market/domain/auction/create_put_off Create domain delisting PSBT draft
POST /v3/market/domain/auction/confirm_put_off Remove signed domain listing
POST /v3/market/domain/auction/create_modify_price Create domain price-update PSBT draft
POST /v3/market/domain/auction/confirm_modify_price Apply signed domain listing price update

Marketplace-Domains

List domain type market statistics

Method: POST
Path: /v3/market/domain/auction/domain_types
Swagger Link: View in Swagger UI

Description

Query read-only Ordinals domain marketplace statistics grouped by domain type. This query-style POST only reads market data; readonly true and requires confirmation false.

Response (200)

Default Response


Get domain type category statistics

Method: POST
Path: /v3/market/domain/auction/domain_statistic
Swagger Link: View in Swagger UI

Description

Query read-only marketplace statistics for categories under a specified Ordinals domain type. This query-style POST only reads market data; readonly true and requires confirmation false.

Request Body

Content-Type: application/json (required)

Response (200)

Default Response


Get marketplace inscription detail

Method: POST
Path: /v3/market/domain/auction/inscription_info
Swagger Link: View in Swagger UI

Description

Query read-only marketplace inscription detail for one inscription, including listing and asset metadata. 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


Get marketplace inscription details in batch

Method: POST
Path: /v3/market/domain/auction/inscription_info_list
Swagger Link: View in Swagger UI

Description

Query read-only marketplace listing details for multiple inscriptions. 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


Search Ordinals domain marketplace listings

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

Description

Query read-only Ordinals domain 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 Ordinals domain marketplace activity history

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

Description

Query read-only Ordinals domain 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 domain listing PSBT draft

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

Description

Creates an Ordinals domain listing draft and returns auctionId, PSBT, and signing indexes for the seller. Review inscriptionId, domain name/type/category, 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 domain listing

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

Description

Confirms the seller-signed listing PSBT and activates the Ordinals domain marketplace listing. Verify auctionId, PSBT encoding, domain name, listing price, seller address, and market type before submitting.

Request Body

Content-Type: application/json (required)

Response (200)

Default Response


Estimate domain purchase fees and balance

Method: POST
Path: /v3/market/domain/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 an Ordinals domain listing. This is a quote/material preparation step only; before any later purchase submission, verify auctionId, bidPrice, buyer address, feeRate, and domain name.

Request Body

Content-Type: application/json (required)

Response (200)

Default Response


Create domain purchase PSBT order

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

Description

Creates an Ordinals domain purchase order and returns bidId, PSBT data, signing indexes, server/network fees, feeRate, and inscription value. Confirm auctionId, bidPrice, buyer address, domain name/type, and fee totals before requesting signatures.

Request Body

Content-Type: application/json (required)

Response (200)

Default Response


Submit signed domain purchase order

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

Description

Submits the signed domain purchase PSBT and returns the settlement transaction id when accepted. Before calling, verify auctionId, bidId, PSBT content, final price, domain name, buyer/seller addresses, and fee values because this can settle the purchase.

Request Body

Content-Type: application/json (required)

Response (200)

Default Response


Create domain delisting PSBT draft

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

Description

Creates delisting signing material for an active Ordinals domain marketplace order, including PSBT/signing data when needed. Confirm auctionId, owner addresses, and domain name before signing because the next confirmation removes the listing.

Request Body

Content-Type: application/json (required)

Response (200)

Default Response


Remove signed domain listing

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

Description

Confirms signed delisting data and removes the Ordinals domain listing from the marketplace. Verify auctionId, PSBT/signature payload, owner address, and target domain name before submitting.

Request Body

Content-Type: application/json (required)

Response (200)

Default Response


Create domain price-update PSBT draft

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

Description

Creates signing material to update an existing Ordinals domain listing price. Verify auctionId, domain name, 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 domain listing price update

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

Description

Confirms signed price-update data and changes the active Ordinals domain listing price. Verify auctionId, signed PSBT, domain name, seller address, and final price before submitting.

Request Body

Content-Type: application/json (required)

Response (200)

Default Response