意图订单列表查询#

查询意图订单的历史成交记录。userWalletAddressorderUid 二选一必填。

请求地址#

GET
https://web3.okx.com/api/v6/dex/aggregator/intent/order-list

请求参数#

参数类型必传描述
userWalletAddressString条件必填下单钱包地址。userWalletAddressorderUid 二选一必填。
orderUidString条件必填创建意图订单 接口返回的订单唯一标识。userWalletAddressorderUid 二选一必填。
cursorString分页游标。首次查询不传,后续翻页时传入上一次响应中返回的 cursor 值。
limitInteger每页返回条数。默认 100,最大 500,超过 500 时按 500 处理。

响应参数#

参数类型描述
cursorString下一页的分页游标。为空字符串时表示已无更多数据。
dataListArray意图订单列表。
chainIndexString链的唯一标识。
fromTokenAddressString卖出币种合约地址。
fromTokenAmountString卖出数量,以十进制字符串表示。
toTokenAddressString买入币种合约地址。
toTokenAmountString实际收到数量,以十进制字符串表示。
orderUidString意图订单唯一标识。
txHashString订单成交上链的交易哈希。
userWalletAddressString下单钱包地址。

请求示例#

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": ""
}