Get Intent Order List#
Query the historical order list for an intent order. Either userWalletAddress or orderUid must be provided.
Request URL#
GET
https://web3.okx.com/api/v6/dex/aggregator/intent/order-listRequest Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| userWalletAddress | String | Conditional | The wallet address of the order owner. Either userWalletAddress or orderUid must be provided. |
| orderUid | String | Conditional | The unique order identifier returned by the Create Intent Order endpoint. Either userWalletAddress or orderUid must be provided. |
| cursor | String | No | Pagination cursor. Omit on the first request. Pass the cursor value from the previous response to fetch the next page. |
| limit | Integer | No | Number of records per page. Default: 100. Maximum: 500. Values exceeding 500 are capped at 500. |
Response Parameters#
| Parameter | Type | Description |
|---|---|---|
| cursor | String | Pagination cursor for the next page. Empty string indicates there are no more records. |
| dataList | Array | List of intent orders. |
| chainIndex | String | Unique identifier for the chain. |
| fromTokenAddress | String | Contract address of the token sold. |
| fromTokenAmount | String | Amount of the token sold, expressed as a decimal string. |
| toTokenAddress | String | Contract address of the token bought. |
| toTokenAmount | String | Amount of the token received, expressed as a decimal string. |
| orderUid | String | Unique identifier of the intent order. |
| txHash | String | On-chain transaction hash of the settled order. |
| userWalletAddress | String | Wallet address of the order owner. |
Request Example#
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'
Response Example#
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": ""
}