主題

提交挂单#

该接口用于将单个Runes铭文挂单到 OKX 平台。在挂单前，您可通过该接口获取钱包资产（获取钱包对某一代币的持有信息）先获取您持有的Runes铭文列表。

请求地址#

POST https://web3.okx.com/api/v5/mktplace/nft/runes/make-order

请求参数#

字段名	类型	是否必传	说明
runesId	String	是	runes 代币的唯一标识，例如：840000:3
walletAddress	String	是	持有上述 runesId 铭文的钱包地址
utxo	String	是	rune 代币所在的 UTXO，格式为：txHash:vout，例如：d578a0967605257f75be625cbdc2506f2a52f9135f56f302badab6a3da54e0d4:0
unitPrice	BigDecimal	是	铭文挂单单价，单位为聪
totalPrice	BigDecimal	是	铭文挂单总价，单位为 BTC
psbt	String	是	签名后的挂单 PSBT，目前只接受 base64 编码的 psbt，需要将铭文所在的 utxo 放在输入的 index=1 的位置，收款地址和金额放在对应输出的 index=1 的位置

响应参数#

字段名	类型	说明
code	Integer	响应结果码，code=0 代表成功，其他代表失败
data	Object	响应结果体，具体字段参考响应示例
msg	String	结果提示，code不为0时可参考

获取订单信息

NFT 市场 API

请求示例#

shell

curl --location 'https://web3.okx.com/api/v5/mktplace/nft/runes/make-order' \
--header 'OK-ACCESS-KEY: your apikey' \
--header 'OK-ACCESS-PASSPHRASE: your passphrase' \
--header 'Content-Type: application/json' \
--data '{
      "runesId": "840000:3",
      "walletAddress": "bc1pud5f80a06y6jcwlllt2t5vdq24sd8d24f39jccay24dqhqmgelkq9dqghx",
      "utxo": "c1dd6736a19d7744353731c85f7f3b7fb9908041e03a1fe66507102e5af930ec:2",
      "unitPrice": 130000,
      "totalPrice": 1300000,
      "psbt": "j2li1jlkjsalkdfjsalkjdo"
}'

响应示例#

200

{
  "code": 0,    //code=0代表成功， 其他代表失败
  "data": {
  "assetId": "1",   //挂单的资产id
},
  "msg": ""
}