提交挂单#

该接口用于将铭文挂单到 OKX 平台。包括 BTC NFT 和 BRC-20。返回数据 success = true 则代表成功挂单。获取 psbt 前需要获取铭文的 UTXO，要获取 UTXO 请用这个接口查询 UTXO。

请求地址#

POST https://www.okx.com/api/v5/mktplace/nft/ordinals/okx/make-orders

请求参数#

参数	类型	必传	描述
nftId	String	是	挂单 NFT 的 ID
inscriptionId	String	是	铭文的 ID
orderType	Integer	是	订单类型。挂单是 2
unitPrice	BigDecimal	是	BRC-20 的单价 / 一个 NFT 的价格，单位：聪
isBrc20	Boolean	否	获取全部 BTC NFT 或 BRC-20 合集的列表，默认为 BRC-20
psbt	String	是	交易所需的签名。只接受 base64 编码的 psbt
totalPrice	BigDecimal	是	从 NFT 角度看，这是一个 NFT 的价格；从 BRC-20 角度看，这里为 BRC-20 的总价。单位：聪

响应参数#

参数	类型	描述
nftId	String	挂单 NFT 的 ID
success	Boolean	成功将返回true，失败则返回 false。
errorMsg	String	请求失败的详细错误消息

代码请求示例#

shell

curl --location 'https://www.okx.com/api/v5/mktplace/nft/ordinals/okx/make-orders' \
--header 'OK-ACCESS-KEY: your api key' \
--header 'OK-ACCESS-PASSPHRASE: your passphrase' \
--header 'Content-Type: application/json' \
--data '{
  "brc20": false,
  "items": [
    {
      "inscriptionId": "02ecbe7ef5143...3f3de87a7c6e64409883f66f4e3036i0",
      "nftId": 20824...473273458, // get this data part 1 step 2 by mapping it to inscriptionId
      "orderType": 2,
      "totalPrice": 100000,  // this price should match part 3 step 1
      "unitPrice": 100000, // this price will varies for BRC20 or btc NFT.  Check out NOTE on unitPrice
      "psbt": "cHNidP8BAP0GAQIAAAADAAAAAAAA...ZUDTZKgR6mGJSkBSJuPsgb2gGCekW+W04EtAAAAAA=",
    }
  ]
}
'

响应示例#

200

{
      "result": [
          {
              "nftID": 20824...473273458,
              "errorMsg": "",
              "success": true,
          }
      ]
  }