Wallet API

Query Order List#

Retrieve the list of orders sent from the Wallet API broadcast interface for an account. This supports querying transactions on EVM and UTXO model networks, sorted in descending order by time.

Request Path#

GET https://www.okx.com/api/v5/wallet/post-transaction/orders

Request Parameters#

ParameterTypeRequiredDescription
accountIdStringYesThe unique identifier of the account.
chainIndexStringNoThe unique identifier of the chain, e.g., ETH=3
txStatusStringNoThe status of the transaction.
cursorStringNoCursor position.
limitStringNoNumber of records to return, default is 20, maximum is 100.

Response Parameters#

ParameterTypeDescription
chainIndexStringThe unique identifier of the chain, e.g., ETH=3
accountIdStringThe unique identifier of the account
fromAddrStringThe source address
toAddrStringThe destination address
txHashStringThe transaction hash
txAmountStringThe amount transferred in the main chain currency, provided in the smallest unit of the main chain, e.g., in wei for EVM chains.
tokenAddressStringThe token address
txStatusStringTransaction status:
1: Pending
2: Successful
3: Failed

Request Example#

shell
curl --location --request GET 'https://www.okx.com/api/v5/wallet/post-transaction/orders?accountId=c79e7775-9e78-4a2d-b27f-9021f3bf5fca&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": [
        {
            "chainIndex": "1",
            "accountId": "c79e7775-9e78-4a2d-b27f-9021f3bf5fca",
            "orderId": "016cf21d020be6c2f071dad9bbd8ec5cb9342fa8",
            "fromAddr": "0x238193be9e80e68eace3588b45d8cf4a7eae0fa3",
            "toAddr": "0x238193be9e80e68eace3588b45d8cf4a7eae0fa3",
            "txHash": "0xb240e65dd9156b4a450be72f6c9fe41be6f72397025bb465b21a96ee9871a589",
            "txAmount": "10000000000000",
            "serviceCharge": "",
            "tokenAddress": "",
            "txstatus": "2"
        },
        {
            "chainIndex": "1",
            "accountId": "c79e7775-9e78-4a2d-b27f-9021f3bf5fca",
            "orderId": "592051a92a744627022955be929ecb5c9e777705",
            "fromAddr": "0x238193be9e80e68eace3588b45d8cf4a7eae0fa3",
            "toAddr": "0x238193be9e80e68eace3588b45d8cf4a7eae0fa3",
            "txHash": "0xc401ffcd2a2b4b1db42ce68dfde8e63c0a1e9653484efb2873dbf5d0cbeb227a",
            "txAmount": "10000000000000",
            "serviceCharge": "",
            "tokenAddress": "",
            "txstatus": "1"
        }
    ]
}