意图订单列表查询#
查询意图订单的历史成交记录。userWalletAddress 和 orderUid 二选一必填。
请求地址#
GET
https://web3.okx.com/api/v6/dex/aggregator/intent/order-list请求参数#
| 参数 | 类型 | 必传 | 描述 |
|---|---|---|---|
| userWalletAddress | String | 条件必填 | 下单钱包地址。userWalletAddress 和 orderUid 二选一必填。 |
| orderUid | String | 条件必填 | 创建意图订单 接口返回的订单唯一标识。userWalletAddress 和 orderUid 二选一必填。 |
| cursor | String | 否 | 分页游标。首次查询不传,后续翻页时传入上一次响应中返回的 cursor 值。 |
| limit | Integer | 否 | 每页返回条数。默认 100,最大 500,超过 500 时按 500 处理。 |
响应参数#
| 参数 | 类型 | 描述 |
|---|---|---|
| cursor | String | 下一页的分页游标。为空字符串时表示已无更多数据。 |
| dataList | Array | 意图订单列表。 |
| chainIndex | String | 链的唯一标识。 |
| fromTokenAddress | String | 卖出币种合约地址。 |
| fromTokenAmount | String | 卖出数量,以十进制字符串表示。 |
| toTokenAddress | String | 买入币种合约地址。 |
| toTokenAmount | String | 实际收到数量,以十进制字符串表示。 |
| orderUid | String | 意图订单唯一标识。 |
| txHash | String | 订单成交上链的交易哈希。 |
| userWalletAddress | String | 下单钱包地址。 |
请求示例#
shell
curl --location --request GET 'https://web3.okx.com/api/v6/dex/aggregator/intent/order-list?userWalletAddress=0x5B38Da6a701c568545dCfcB03FcB875f56beddC4&limit=100' \
--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": {
"cursor": "",
"dataList": [
{
"chainIndex": "1",
"fromTokenAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"fromTokenAmount": "0.001000000000000000",
"orderUid": "0xfa2506196276f31c6bf7f4a2f02f3bd5ad80ed91354441ce4d5f28c87021e64c5b38da6a701c568545dcfcb03fcb875f56beddc469bbd743",
"toTokenAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"toTokenAmount": "2.124500000000000000",
"txHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
"userWalletAddress": "0x5B38Da6a701c568545dCfcB03FcB875f56beddC4"
}
]
},
"msg": ""
}
