BRC20 Marketplace

Get tick k line.

post

/v3/market/brc20/auction/brc20_kline

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

tickstringRequired

timeStartnumberRequired

Start time range

timeEndnumberRequired

End time range

timeStepnumberRequired

Time granularity, such as milliseconds for a 5-minute interval

Responses

200

Default Response

application/json

codenumberRequired

msgstringRequired

post

/v3/market/brc20/auction/brc20_kline

POST /v3/market/brc20/auction/brc20_kline HTTP/1.1
Host: open-api-fractal.unisat.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 54

{
  "tick": "text",
  "timeStart": 1,
  "timeEnd": 1,
  "timeStep": 1
}

200

Default Response

{
  "code": 1,
  "msg": "text",
  "data": [
    {
      "price": 1,
      "timestamp": 1
    }
  ]
}

Parameter Description

tick: BRC-20 tick
timeStart: The starting timestamp, measured in milliseconds.
timeEnd: The ending timestamp, measured in milliseconds.
timeStep: Represents the interval between each data point, measured in milliseconds.

Additionally, there are the following limitations on the requested parameters.

(timeEnd-timeStart)/timeStep <= 2016

Get statistical data, price, market capitalization, etc. for BRC20.

post

/v3/market/brc20/auction/brc20_types

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

tickLennumber · enumOptionalExample: 4Possible values:

timeTypestring · enumOptional

Optional: day1, day7, day30

Possible values:

ticksstring[]Optional

Specify a list of ticks

startnumberOptional

limitnumberOptional

Responses

200

Default Response

application/json

codenumberRequired

msgstringRequired

post

/v3/market/brc20/auction/brc20_types

POST /v3/market/brc20/auction/brc20_types HTTP/1.1
Host: open-api-fractal.unisat.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 68

{
  "tickLen": 4,
  "timeType": "day1",
  "ticks": [
    "text"
  ],
  "start": 1,
  "limit": 1
}

200

Default Response

{
  "code": 1,
  "msg": "text",
  "data": {
    "BTCPrice": 1,
    "list": [
      {
        "tick": "text",
        "curPrice": 1,
        "changePrice": 1,
        "btcVolume": 1,
        "amountVolume": 1,
        "cap": "text"
      }
    ],
    "deploy": [
      {
        "tick": "text",
        "curPrice": 1,
        "changePrice": 1,
        "btcVolume": 1,
        "amountVolume": 1,
        "cap": "text"
      }
    ],
    "cap": [
      {
        "tick": "text",
        "curPrice": 1,
        "changePrice": 1,
        "btcVolume": 1,
        "amountVolume": 1,
        "cap": "text"
      }
    ]
  }
}

The optional values for timeType are day1, day7, day30.

ticks can be used to filter the "list," allowing it to return only the ticks that are needed.If the ticks field is not provided, all BRC20 data will be returned.

In the returned fields of this interface, only the "list" field needs attention. The "deploy" and "cap" fields are included solely for display purposes on certain pages of UniSat Marketplace. Filtering the fields will not affect "deploy" and "cap"; they will always be returned.

Get statistical data, price, market capitalization, etc. for BRC20.

post

/v3/market/brc20/auction/brc20_types_specified

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

timeTypestring · enumOptionalPossible values:

tickstringOptional

Responses

200

Default Response

application/json

codenumberRequired

msgstringRequired

post

/v3/market/brc20/auction/brc20_types_specified

POST /v3/market/brc20/auction/brc20_types_specified HTTP/1.1
Host: open-api-fractal.unisat.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 33

{
  "timeType": "day1",
  "tick": "text"
}

200

Default Response

{
  "code": 1,
  "msg": "text",
  "data": {
    "tick": "text",
    "curPrice": 1,
    "changePrice": 1,
    "btcVolume": 1,
    "amountVolume": 1
  }
}

The optional values for timeType are day1, day7, day30

Bind btcAddress and nftAddress.

post

/v3/market/brc20/auction/bind

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

btcAddressstringRequired

nftAddressstringRequired

signstringRequired

Responses

200

Default Response

application/json

codenumberRequired

msgstringRequired

dataobjectRequired

post

/v3/market/brc20/auction/bind

POST /v3/market/brc20/auction/bind HTTP/1.1
Host: open-api-fractal.unisat.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 55

{
  "btcAddress": "text",
  "nftAddress": "text",
  "sign": "text"
}

200

Default Response

{
  "code": 1,
  "msg": "text",
  "data": {}
}

By default, a user's address A is used for both payment and receiving inscriptions. However, for some wallets, such as the xverse and hiro wallets, different addresses are used to store BTC and inscriptions. This method allows the wallet to use address A for payments and address B for receiving inscriptions.

import {signMessage} from "sats-connect"

const paymentAddress = "";
const ordinalsAddress = "";

const toSignStr = `Please confirm that\nPayment Address: ${paymentAddress}\nOrdinals Address: ${ordinalsAddress}`

// for xverse
signMessage({
    payload:{
        address: ordinalsAddress,
        message: toSignStr,
        network:{
            type: "Mainnet"
        }
    },
    onFinish:(signature)=>{
        axios.post('/v3/market/brc20/auction/bind', {
            btcAddress: paymentAddress,
            nftAddress: ordinalsAddress,
            sign:signature
        })

    }
}

Retrieve the list information of the market.

post

/v3/market/brc20/auction/list

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

startnumberRequired

The data is looked up from start

limitnumber · max: 100Required

Limit the amount of data

Responses

200

Default Response

application/json

codenumberRequired

msgstringRequired

post

/v3/market/brc20/auction/list

POST /v3/market/brc20/auction/list HTTP/1.1
Host: open-api-fractal.unisat.io
Authorization: Bearer YOUR_SECRET_TOKEN
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
}

200

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
  }
}

Retrieve inscription information, including brc20, names, collection. It is necessary to first determine the inscription type before calling the relevant services.

post

/v3/market/brc20/auction/inscription_info

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

inscriptionIdstringRequired

Responses

200

Default Response

application/json

codenumberRequired

msgstringRequired

post

/v3/market/brc20/auction/inscription_info

POST /v3/market/brc20/auction/inscription_info HTTP/1.1
Host: open-api-fractal.unisat.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 24

{
  "inscriptionId": "text"
}

200

Default Response

{
  "code": 1,
  "msg": "text",
  "data": {
    "auctionId": "text",
    "inscriptionId": "text",
    "inscriptionNumber": 1,
    "marketType": "fixedPrice",
    "address": "text",
    "price": 1,
    "notSupport": true,
    "verification": true,
    "nftType": "text",
    "tick": "text",
    "limit": 1,
    "amount": 1,
    "unitPrice": 1,
    "collectionId": "text",
    "contentType": "text",
    "contentBody": "text",
    "collectionItemName": "text",
    "collectionHighResImgUrl": "text",
    "collectionName": "text",
    "notOnSale": true,
    "domain": "text",
    "domainHex": "text",
    "domainType": "sats",
    "utxo": {}
  }
}

Get the basic listing information of the specified inscription list

post

/v3/market/brc20/auction/inscription_info_list

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

addressstringOptional

inscriptionIdsstring[]Optional

Responses

200

Default Response

application/json

codenumberRequired

msgstringRequired

post

/v3/market/brc20/auction/inscription_info_list

POST /v3/market/brc20/auction/inscription_info_list HTTP/1.1
Host: open-api-fractal.unisat.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 44

{
  "address": "text",
  "inscriptionIds": [
    "text"
  ]
}

200

Default Response

{
  "code": 1,
  "msg": "text",
  "data": {
    "list": [
      {
        "auctionId": "text",
        "inscriptionId": "text",
        "inscriptionNumber": 1,
        "marketType": "text",
        "address": "text",
        "price": 1,
        "nftType": "text",
        "status": "text"
      }
    ]
  }
}

Create listing order.

post

/v3/market/brc20/auction/create_put_on

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

nftTypestringOptional

inscriptionIdstringRequired

initPricestringRequired

Set the initial total price

unitPricestringRequired

Unit Price (for tick)

pubkeystringRequired

User public key

marketTypestring · enumRequiredExample: fixedPricePossible values:

btcAddressstringOptional

(Optional) Only for multi-address wallet, such as Xverse, hiro. Specifies the BTC receive address

Responses

200

Default Response

application/json

codenumberRequired

msgstringRequired

post

/v3/market/brc20/auction/create_put_on

POST /v3/market/brc20/auction/create_put_on HTTP/1.1
Host: open-api-fractal.unisat.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 141

{
  "nftType": "text",
  "inscriptionId": "text",
  "initPrice": "text",
  "unitPrice": "text",
  "pubkey": "text",
  "marketType": "fixedPrice",
  "btcAddress": "text"
}

200

Default Response

{
  "code": 1,
  "msg": "text",
  "data": {
    "auctionId": "text",
    "psbt": "text",
    "signIndexes": [
      1
    ]
  }
}

btcAddress: (Optional) Only for multi-address wallet, such as Xverse, hiro. To specifies the BTC receive address

Confirm listing order.

post

/v3/market/brc20/auction/confirm_put_on

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

auctionIdstringRequired

psbtstringRequired

fromBase64booleanOptional

Is Base64 format, the default is hex format

Responses

200

Default Response

application/json

codenumberRequired

msgstringRequired

dataobjectRequired

post

/v3/market/brc20/auction/confirm_put_on

POST /v3/market/brc20/auction/confirm_put_on HTTP/1.1
Host: open-api-fractal.unisat.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 52

{
  "auctionId": "text",
  "psbt": "text",
  "fromBase64": true
}

200

Default Response

{
  "code": 1,
  "msg": "text",
  "data": {}
}

Return params before creating purchase order.

post

/v3/market/brc20/auction/create_bid_prepare

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

auctionIdstringRequired

bidPricenumberRequired

addressstringRequired

Bidder address

pubkeystringRequired

Bidder pubkey

Responses

200

Default Response

application/json

codenumberRequired

msgstringRequired

post

/v3/market/brc20/auction/create_bid_prepare

POST /v3/market/brc20/auction/create_bid_prepare HTTP/1.1
Host: open-api-fractal.unisat.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 66

{
  "auctionId": "text",
  "bidPrice": 1,
  "address": "text",
  "pubkey": "text"
}

200

Default Response

{
  "code": 1,
  "msg": "text",
  "data": {
    "serverFee": 1,
    "serverReal": 1,
    "serverFeeRate": 1,
    "txSize": 1,
    "nftValue": 1,
    "feeRate": 1,
    "availableBalance": 1,
    "allBalance": 1
  }
}

serverFee: Service Fee
serverReal: The service fee after deducting various discounts.
serverFeeRate: Service fee rate
txSzie: The virtual size of this transaction.
nftValue: Satoshis in the inscription
feeRate: The current accepted minimum network fee rate.
availableBalance：BTC balance available for constructing transactions."

Create purchase order.

post

/v3/market/brc20/auction/create_bid

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

auctionIdstringRequired

bidPricenumberRequired

addressstringRequired

Bidder address

pubkeystringRequired

Bidder pubkey

feeRatenumberOptional

The user sets the rate

nftAddressstringOptional

(Optional) Only for multi-address wallet, such as Xverse, hiro. Inscription receiving address

Responses

200

Default Response

application/json

codenumberRequired

msgstringRequired

post

/v3/market/brc20/auction/create_bid

POST /v3/market/brc20/auction/create_bid HTTP/1.1
Host: open-api-fractal.unisat.io
Authorization: Bearer YOUR_SECRET_TOKEN
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
    }
  ]
}

200

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
    ]
  }
}

Create the order for price adjustment.

post

/v3/market/brc20/auction/create_modify_price

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

auctionIdstringRequired

initPricestringRequired

unitPricestringRequired

Responses

200

Default Response

application/json

codenumberRequired

msgstringRequired

post

/v3/market/brc20/auction/create_modify_price

POST /v3/market/brc20/auction/create_modify_price HTTP/1.1
Host: open-api-fractal.unisat.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 58

{
  "auctionId": "text",
  "initPrice": "text",
  "unitPrice": "text"
}

200

Default Response

{
  "code": 1,
  "msg": "text",
  "data": {
    "psbt": "text",
    "signIndexes": [
      1
    ]
  }
}

Confirm the order for price adjustment.

post

/v3/market/brc20/auction/confirm_modify_price

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

auctionIdstringRequired

psbtstringRequired

fromBase64booleanRequired

Responses

200

Default Response

application/json

codenumberRequired

msgstringRequired

dataobjectRequired

post

/v3/market/brc20/auction/confirm_modify_price

POST /v3/market/brc20/auction/confirm_modify_price HTTP/1.1
Host: open-api-fractal.unisat.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 52

{
  "auctionId": "text",
  "psbt": "text",
  "fromBase64": true
}

200

Default Response

{
  "code": 1,
  "msg": "text",
  "data": {}
}

Last updated 1 year ago

hashtagGet tick k line.

hashtagGet statistical data, price, market capitalization, etc. for BRC20.

hashtagGet statistical data, price, market capitalization, etc. for BRC20.

hashtagBind btcAddress and nftAddress.

hashtagRetrieve the list information of the market.

hashtagRetrieve inscription information, including brc20, names, collection. It is necessary to first determine the inscription type before calling the relevant services.

hashtagGet the basic listing information of the specified inscription list

hashtagCreate listing order.

hashtagConfirm listing order.

hashtagReturn params before creating purchase order.

hashtagCreate purchase order.

hashtagCreate the order for price adjustment.

hashtagConfirm the order for price adjustment.

Get tick k line.

Get statistical data, price, market capitalization, etc. for BRC20.

Get statistical data, price, market capitalization, etc. for BRC20.

Bind btcAddress and nftAddress.

Retrieve the list information of the market.

Retrieve inscription information, including brc20, names, collection. It is necessary to first determine the inscription type before calling the relevant services.

Get the basic listing information of the specified inscription list

Create listing order.

Confirm listing order.

Return params before creating purchase order.

Create purchase order.

Create the order for price adjustment.

Confirm the order for price adjustment.