钱包 API
查询订单列表

查询订单列表#

查询账户下,从 Wallet API 广播接口发出的订单列表,支持查询 EVM 和 UTXO 模型网络的交易,按时间倒序排列。

请求路径#

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

请求参数#

ParameterTypeRequiredDescription
accountIdStringYes账户唯一标识符
chainIndexStringNo链唯一标识
txStatusStringNo交易状态:
1: 排队中
2: 成功
3: 失败
cursorStringNo游标
limitStringNo返回条数,默认返回最近的 20 条,最多 100 条

响应参数#

ParameterTypeDescription
chainIndexString链唯一标识
accountIdString账户唯一标识符
orderIdString订单 Id
fromAddrStringFrom 地址
toAddrStringTo 地址
txHashString交易哈希
txAmountString转账主链币金额,以主链币的最小单位传参,例如 EVM 链,换算成 wei 数量传入
tokenAddressString代币地址
txStatusString交易状态:
1: 排队中
2: 成功
3:失败

请求示例#

shell
curl --location --request GET 'https://www.okx.com/api/v5/wallet/post-transaction/orders?accountId=c79e7775-9e78-4a2d-b27f-9021f3bf5fca' \
--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'

响应示例#

200
以 ETH 为例

{
    "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"
        }
    ]
}