交易 API

获取广播订单列表#

查询从广播接口发出的订单列表,按时间倒序排列。

请求路径#

GET https://web3.okx.com/api/v5/dex/post-transaction/orders

请求参数#

ParameterTypeRequiredDescription
addressString地址
chainIndexString链唯一标识。(如1代表Ethereum。更多可查看这里。)
txStatusString交易状态:
1: 排队中
2: 成功
3:失败
orderIdString交易订单唯一标识
cursorString游标
limitString返回条数,默认返回最近的 20 条,最多 100 条

响应参数#

ParameterTypeDescription
cursorString游标
ordersArray订单列表
>chainIndexString链唯一标识
>addressString地址
>orderIdString订单 Id
>txStatusString交易状态:
1: 排队中
2: 成功
3:失败
>failReasonString交易失败的原因
>txHashString交易哈希

请求示例#

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'

响应示例#

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