获取订单信息#
该接口用于获取订单信息，支持通过 runesid 获取指定项目订单信息。
请求地址#
GET https://web3.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": ""
}