Runes Marketplace
Optional: day1, day7, day30
POST /v3/market/runes/auction/runes_types HTTP/1.1
Host: open-api.unisat.io
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 39
{
"timeType": "day1",
"start": 1,
"limit": 1
}
Default Response
{
"code": 1,
"msg": "text",
"data": {
"BTCPrice": 1,
"list": [
{
"tick": "text",
"curPrice": 1,
"changePrice": 1,
"btcVolume": 1,
"amountVolume": 1,
"cap": "text",
"holders": 1,
"transactions": 1,
"warning": true
}
]
}
}
POST /v3/market/runes/auction/runes_types_specified HTTP/1.1
Host: open-api.unisat.io
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 33
{
"timeType": "day1",
"tick": "text"
}
Default Response
{
"code": 1,
"msg": "text",
"data": {
"tick": "text",
"symbol": "text",
"curPrice": 1,
"changePrice": 1,
"btcVolume": 1,
"amountVolume": 1,
"cap": "text",
"capUSD": "text",
"deployTime": 1,
"holders": 1,
"number": 1,
"transactions": 1,
"warning": true
}
}
The data is looked up from start
Limit the amount of data
POST /v3/market/runes/auction/list HTTP/1.1
Host: open-api.unisat.io
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 223
{
"filter": {
"nftType": "brc20",
"address": "text",
"tick": "text",
"minPrice": 1,
"maxPrice": 1,
"nftConfirm": true,
"isEnd": true,
"all": true
},
"sort": {
"unitPrice": 1,
"onSaleTime": 1,
"initPrice": 1,
"inscriptionNumber": 1
},
"start": 1,
"limit": 1
}
Default Response
{
"code": 1,
"msg": "text",
"data": {
"list": [
{
"auctionId": "text",
"inscriptionId": "text",
"inscriptionNumber": 1,
"marketType": "text",
"address": "text",
"price": 1,
"nftType": "text",
"tick": "text",
"limit": 1,
"amount": 1,
"unitPrice": 1
}
],
"total": 1,
"timestamp": 1
}
}
POST /v3/market/runes/auction/actions HTTP/1.1
Host: open-api.unisat.io
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 121
{
"filter": {
"nftType": "brc20",
"address": "text",
"inscriptionId": "text",
"event": "Cancel",
"tick": "text"
},
"start": 1,
"limit": 1
}
Default Response
{
"code": 1,
"msg": "text",
"data": {
"list": [
{
"auctionId": "text",
"inscriptionId": "text",
"inscriptionNumber": 1,
"event": "Listed",
"price": 1,
"from": "text",
"to": "text",
"timestamp": 1,
"nftConfirmNum": 1,
"nftType": "brc20",
"endMsg": "text",
"newest": true,
"name": "text",
"unitPrice": 1,
"amount": 1,
"domain": "text",
"domainType": "sats",
"domainCategorys": [
"Keyboard"
],
"collectionId": "text",
"collectionItemName": "text",
"contentType": "text",
"contentBody": "text",
"attributes": [
{
"trait_type": "text",
"value": "text"
}
]
}
],
"total": 1
}
}
Set the initial total price
Unit Price (for tick)
User public key
fixedPrice
Possible values: (Optional) Only for multi-address wallet, such as Xverse, hiro. Specifies the BTC receive address
POST /v3/market/runes/auction/create_put_on HTTP/1.1
Host: open-api.unisat.io
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 141
{
"nftType": "text",
"inscriptionId": "text",
"initPrice": "text",
"unitPrice": "text",
"pubkey": "text",
"marketType": "fixedPrice",
"btcAddress": "text"
}
Default Response
{
"code": 1,
"msg": "text",
"data": {
"auctionId": "text",
"psbt": "text",
"signIndexes": [
1
]
}
}
Is Base64 format, the default is hex format
POST /v3/market/runes/auction/confirm_put_on HTTP/1.1
Host: open-api.unisat.io
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 52
{
"auctionId": "text",
"psbt": "text",
"fromBase64": true
}
Default Response
{
"code": 1,
"msg": "text",
"data": {}
}
Bidder address
Bidder pubkey
POST /v3/market/runes/auction/create_bid_prepare HTTP/1.1
Host: open-api.unisat.io
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 66
{
"auctionId": "text",
"bidPrice": 1,
"address": "text",
"pubkey": "text"
}
Default Response
{
"code": 1,
"msg": "text",
"data": {
"serverFee": 1,
"serverReal": 1,
"serverFeeRate": 1,
"txSize": 1,
"nftValue": 1,
"feeRate": 1,
"availableBalance": 1,
"allBalance": 1
}
}
Bidder address
Bidder pubkey
The user sets the rate
(Optional) Only for multi-address wallet, such as Xverse, hiro. Inscription receiving address
POST /v3/market/runes/auction/create_bid HTTP/1.1
Host: open-api.unisat.io
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 134
{
"auctionId": "text",
"bidPrice": 1,
"address": "text",
"pubkey": "text",
"feeRate": 1,
"nftAddress": "text",
"utxos": [
{
"txid": "text",
"index": 1
}
]
}
Default Response
{
"code": 1,
"msg": "text",
"data": {
"bidId": "text",
"psbtBid": "text",
"psbtBid2": "text",
"psbtSettle": "text",
"serverFee": 1,
"networkFee": 1,
"feeRate": 1,
"nftValue": 1,
"bidSignIndexes": [
1
]
}
}
Auction mode is used, and the current empty string can be passed
Auction mode is used, and the current empty string can be passed
Is Base64 format, the default is hex format
POST /v3/market/runes/auction/confirm_bid HTTP/1.1
Host: open-api.unisat.io
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 108
{
"auctionId": "text",
"bidId": "text",
"psbtBid": "text",
"psbtBid2": "text",
"psbtSettle": "text",
"fromBase64": true
}
Default Response
{
"code": 1,
"msg": "text",
"data": {
"txid": "text"
}
}
(Optional) Only for multi-address wallet, such as Xverse, hiro. Inscription receiving address.
(Optional) Only for multi-address wallet, such as Xverse, hiro. The public key used in the inscription of the order.
POST /v3/market/runes/auction/create_put_off HTTP/1.1
Host: open-api.unisat.io
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 122
{
"auctionId": "text",
"nftAddress": "text",
"btcPubkey": "text",
"utxos": [
{
"txid": "text",
"index": 1
}
],
"rbf": true,
"offChain": true
}
Default Response
{
"code": 1,
"msg": "text",
"data": {
"psbt": "text",
"txSize": 1,
"btcSignIndexes": [
1
],
"nftSignIndexes": [
1
]
}
}
Is Base64 format, the default is hex format
POST /v3/market/runes/auction/confirm_put_off HTTP/1.1
Host: open-api.unisat.io
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 68
{
"auctionId": "text",
"psbt": "text",
"fromBase64": true,
"offChain": true
}
Default Response
{
"code": 1,
"msg": "text",
"data": {
"txid": "text"
}
}
POST /v3/market/runes/auction/create_modify_price HTTP/1.1
Host: open-api.unisat.io
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 58
{
"auctionId": "text",
"initPrice": "text",
"unitPrice": "text"
}
Default Response
{
"code": 1,
"msg": "text",
"data": {
"psbt": "text",
"signIndexes": [
1
]
}
}
POST /v3/market/runes/auction/confirm_modify_price HTTP/1.1
Host: open-api.unisat.io
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 52
{
"auctionId": "text",
"psbt": "text",
"fromBase64": true
}
Default Response
{
"code": 1,
"msg": "text",
"data": {}
}
Unit Price (for tick)
User public key
(Optional) Only for multi-address wallet, such as Xverse, hiro. Specifies the BTC receive address
POST /v3/market/runes/auction/create_batch_put_on HTTP/1.1
Host: open-api.unisat.io
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 109
{
"unitPrice": "text",
"pubkey": "text",
"nftType": "text",
"btcAddress": "text",
"utxos": [
{
"txid": "text",
"index": 1
}
]
}
Default Response
{
"code": 1,
"msg": "text",
"data": {
"batchAuctionId": "text",
"psbt": "text",
"signIndexes": [
1
]
}
}
Is Base64 format, the default is hex format
POST /v3/market/runes/auction/confirm_batch_put_on HTTP/1.1
Host: open-api.unisat.io
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 57
{
"batchAuctionId": "text",
"psbt": "text",
"fromBase64": true
}
Default Response
{
"code": 1,
"msg": "text",
"data": {}
}
Bidder address
Bidder pubkey
POST /v3/market/runes/auction/create_batch_bid_prepare HTTP/1.1
Host: open-api.unisat.io
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 56
{
"auctionIds": [
"text"
],
"address": "text",
"pubkey": "text"
}
Default Response
{
"code": 1,
"msg": "text",
"data": {
"serverFee": 1,
"serverReal": 1,
"serverFeeRate": 1,
"txSize": 1,
"feeRate": 1,
"availableBalance": 1,
"validAuctionIds": [
"text"
],
"invalidAuctionIds": [
"text"
]
}
}
Bidder address
Bidder pubkey
The user sets the rate
(Optional) Only for multi-address wallet, such as Xverse, hiro. Inscription receiving address
POST /v3/market/runes/auction/create_batch_bid HTTP/1.1
Host: open-api.unisat.io
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 104
{
"auctionIds": [
"text"
],
"bidPrices": [
1
],
"address": "text",
"pubkey": "text",
"feeRate": 1,
"nftAddress": "text"
}
Default Response
{
"code": 1,
"msg": "text",
"data": {
"bidId": "text",
"psbtBid": "text",
"serverFee": 1,
"networkFee": 1,
"feeRate": 1,
"bidSignIndexes": [
1
]
}
}
Is Base64 format, the default is hex format
POST /v3/market/runes/auction/confirm_batch_bid HTTP/1.1
Host: open-api.unisat.io
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 51
{
"bidId": "text",
"psbtBid": "text",
"fromBase64": true
}
Default Response
{
"code": 1,
"msg": "text",
"data": {
"txid": "text"
}
}
Last updated