Get Transaction Orders#
Get the list of orders sent from transaction broadcasting API. This supports querying transactions sorted in descending order by time.
Request URL#
GET https://web3.okx.com/api/v5/dex/post-transaction/orders
Request Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| address | String | Yes | Address |
| chainIndex | String | Yes | Unique identifier for the chain. e.g., 1: Ethereum. See more here. |
| txStatus | String | No | Transaction status: 1: Pending 2: Success 3: Failed |
| orderId | String | No | Unique identifier for the transaction order |
| cursor | String | No | Cursor |
| limit | String | No | Number of records returned, default is the most recent 20, maximum is 100 |
Response Parameters#
| Parameter | Type | Description |
|---|---|---|
| chainIndex | String | Unique identifier for the chain |
| address | String | Address |
| orderId | String | Order ID |
| txStatus | String | Transaction status: 1: Pending 2: Success 3: Failed |
| failReason | String | The reason for failed transaction |
| txHash | String | Transaction hash |
Request Example#
shell
curl --location --request GET 'https://web3.okx.com/api/v5/dex/post-transaction/orders?address=0x238193be9e80e68eace3588b45d8cf4a7eae0fa3&chainIndex=1' \
--header 'Content-Type: application/json' \
--header 'OK-ACCESS-PROJECT: 86af********d1bc' \
--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#
200
{
"code": "0",
"msg": "success",
"data": [
{
"cursor": "1",
"orders":[
{
"chainIndex": "1",
"orderId": "016cf21d020be6c2f071dad9bbd8ec5cb9342fa8",
"address": "0x238193be9e80e68eace3588b45d8cf4a7eae0fa3",
"txHash": "0xb240e65dd9156b4a450be72f6c9fe41be6f72397025bb465b21a96ee9871a589",
"failReason": "",
"txstatus": "2"
},
{
"chainIndex": "1",
"orderId": "592051a92a744627022955be929ecb5c9e777705",
"address": "0x238193be9e80e68eace3588b45d8cf4a7eae0fa3",
"txHash": "0xc401ffcd2a2b4b1db42ce68dfde8e63c0a1e9653484efb2873dbf5d0cbeb227a",
"txstatus": "1",
"failReason": "",
}
]
}
]
}