查询意图订单状态#
根据订单 ID 查询单个意图订单的当前状态。
请求地址#
GET
https://web3.okx.com/api/v6/dex/aggregator/intent/order-status请求参数#
| 参数 | 类型 | 必传 | 描述 |
|---|---|---|---|
| orderUid | String | 是 | 创建意图订单 接口返回的订单唯一标识。 |
响应参数#
| 参数 | 类型 | 描述 |
|---|---|---|
| chainIndex | String | 链的唯一标识。 |
| fromTokenAddress | String | 卖出币种合约地址。 |
| fromTokenAmount | String | 卖出数量，以十进制字符串表示。订单尚未撮合时为空字符串。 |
| toTokenAddress | String | 买入币种合约地址。 |
| toTokenAmount | String | 实际收到数量，以十进制字符串表示。订单尚未结算时为空字符串。 |
| userWalletAddress | String | 下单钱包地址。 |
| status | Integer | 意图订单当前状态码。可选值： -7：已过期 — 订单在 validTo 时间到达前未被填充而自动失效。 -6：已失效 — 订单等待成交期间，系统检测到钱包内对应代币余额或对结算合约的授权额度不足以履约，将其置为终态。 -2：已取消 — 用户在成交前主动撤销订单。 -1：交易失败 — 订单经多轮拍卖仍未成交，重试次数达上限后被置为终态。 0：交易中 — 订单已拍卖成功，正在链上结算，等待最终确认。 1：已成交 — 订单已成交并完成结算。 3：活跃中 — 订单已挂单，正在等待拍卖。 5：拍卖中 — 订单已进入拍卖环节，系统正在比价并选择最优执行方。 |
请求示例#
shell
curl --location --request GET 'https://web3.okx.com/api/v6/dex/aggregator/intent/order-status?orderUid=0xa1b2c3d4e5f6789012345678901234567890123456789012345678901234567890ab' \
--header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \
--header 'OK-ACCESS-SIGN: leaV********3uw=' \
--header 'OK-ACCESS-PASSPHRASE: 1****6' \
--header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z'
响应示例#
json
{
"code": "0",
"data": {
"chainIndex": "1",
"fromTokenAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"fromTokenAmount": "",
"status": -7,
"toTokenAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"toTokenAmount": "",
"userWalletAddress": ""
},
"msg": ""
}