Runes Marketplace
The data is looked up from start
Limit the amount of data
POST /v3/market/runes/auction/list HTTP/1.1
Host: open-api-fractal.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-fractal.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
}
}
The txid of the rune utxo txid
The txid of the rune utxo index
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-fractal.unisat.io
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 147
{
"nftType": "text",
"txid": "text",
"index": "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-fractal.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-fractal.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-fractal.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
]
}
}
(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-fractal.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-fractal.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-fractal.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-fractal.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-fractal.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-fractal.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-fractal.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-fractal.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-fractal.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