Marketplace API
提交挂单

提交挂单#

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

请求地址#

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

请求参数#

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

响应参数#

字段名类型说明
codeInteger响应结果码,code=0 代表成功, 其他代表失败
dataObject响应结果体,具体字段参考响应示例
msgString结果提示,code不为0时可参考

请求示例#

shell
curl --location 'https://www.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": ""
}