获取订单信息#

该接口用于获取订单信息，支持通过 runesid 获取指定项目订单信息。

请求地址#

GET https://www.okx.com/api/v5/mktplace/nft/runes/get-runes-order-list

请求参数#

字段名	类型	是否必传	说明
runesId	String	是	runes 代币的唯一标识
cursor	String	否	指向要检索的排序序号的游标 (最大 1,000)
limit	Integer	否	分页大小 (默认值 10，最大 100)。返回最大的订单数
sortBy	String	否	订单排序规则，默认排序为单价正序排列 (unitPriceAsc)。排序枚举： unitPriceAsc、unitPriceDesc、totalPriceAsc、totalPriceDesc、listedTimeAsc、listedTimeDesc

返回参数#

参数	类型	参数说明
assetId	Integer	id (DB 主键无实际意义)
tickerType	String	代币类型 (4-Runes)
ticker	Integer	代币名称
tickerId	String	代币 id
ownerAddress	String	钱包地址
amount	String	在该 UTXO 的 XRC20 数量
chain	Integer	链
inscriptionNum	String	Inscription 编号
utxoTxHash	String	交易 hash
utxoVout	Integer	utxoVout
utxoValue	String	utxoValue
txHash	String	交易 hash
name	String	代币名称
tickerIcon	String	代币 icon 链接
status	Integer	挂单状态 (0-未挂单 1-已挂单 2-pending 中)
listTime	Long	挂单时间
orderId	Long	订单 id
confirmations	Long	区块高度信息
currency	String	总价 - 币种
currencyUrl	String	总价 - 币种 url
satPrice	BigDecimal	总价 - sat 价格
price	BigDecimal	总价 - btc 价格
usdPrice	BigDecimal	总价 - usd 价格
currency	String	单价 - 币种
currencyUrl	String	单价 - 币种 url
satPrice	BigDecimal	单价 - sat 价格
price	BigDecimal	单价 - btc 价格
usdPrice	BigDecimal	单价 - usd 价格
unavailable	Integer	"1 - 同一个 UTXO 包含多个 Atomicals 资产； 2 - 同一个 UTXO 包含多个协议资产"
symbol	String	Symbol

请求示例#

shell

curl --location --request GET 'https://beta.okex.org/api/v5/mktplace/nft/runes/get-runes-order-list?runesId=840000:3' \
--header 'OK-ACCESS-KEY: XXXX' \
--header 'OK-ACCESS-PASSPHRASE: XXXX'

返回示例#

200

{
  "code": 0,
  "data": {
  "cursor": "1",
  "items": [
{
  "amount": "889806",
  "assetId": "28734126488062286",
  "chain": 0,
  "confirmations": null,
  "inscriptionNum": "",
  "listTime": 1714398972,
  "name": "DOG•GO•TO•THE•MOON",
  "orderId": 201268,
  "ownerAddress": "bc1pxav32udnt0062dlvmjn7tp3qneamudpg492t7qmxsu7m73ldd7uq768q8p",
  "status": 1,
  "symbol": "🐕",
  "ticker": "DOG•GO•TO•THE•MOON",
  "tickerIcon": "https://static.coinall.ltd/cdn/web3/currency/token/1714125941761.png/type=png_350_0",
  "tickerId": "840000:3",
  "tickerType": 4,
  "totalPrice": {
  "currency": "BTC",
  "currencyUrl": "https://static.coinall.ltd/cdn/nft/4834651a-7c4e-4249-91c1-cf680af39dc0.png",
  "price": "0.05472306",
  "satPrice": "5472306",
  "usdPrice": "3388.298650632"
},
  "txHash": "",
  "unavailable": null,
  "unitPrice": {
  "currency": "BTC",
  "currencyUrl": "https://static.coinall.ltd/cdn/nft/4834651a-7c4e-4249-91c1-cf680af39dc0.png",
  "price": "0.0000000615",
  "satPrice": "6.15",
  "usdPrice": "0.0038079078"
},
  "utxoTxHash": "80efaeffcbf70be91579afb631e45cd28df75b0883f45525d1bb6b04b21969f3",
  "utxoValue": "546",
  "utxoVout": 1015
}
  ]
},
  "msg": ""
}