如何查看OKX历史期货订单

通过 OKX Web 界面访问历史期货订单

1. 登录您的OKX账户并导航至期货交易部分。

2. 单击交易界面顶部的“订单”选项卡。

3. 选择历史记录子选项卡以显示已完成、已取消和已过期的期货订单。

4. 使用日期范围过滤器指定检索的开始和结束时间戳 - 默认窗口涵盖过去 90 天。

5. 应用 BTC-USDT-SWAP 或 ETH-USDT-QUARTER 等工具过滤器，按合约类型和标的资产缩小结果范围。

通过 REST API 检索期货订单历史记录

1. 使用有效凭据从python-okx初始化TradeAPI类，并为生产环境设置flag='0' 。

2. 调用get_orders_history_archive方法，传入参数instType='SWAP' 、 instId='BTC-USDT-SWAP' 、 limit=100 。

3. 使用before参数对响应进行分页 - 该值是从每个批次中最旧记录的ordId字段中提取的。

4. 解析返回的 JSON 结构：每个条目包含ordId 、 px 、 sz 、 side 、 state 、 fillSz 、 avgPx和ts （毫秒时间戳）。

5. 在反转默认的降序排序后，按时间顺序存储原始响应，然后通过检查连续页面上ts值的间隙来验证完整性。

数据完整性和时间范围约束

1. OKX 在网页界面上保留期货订单历史长达180 天，但机构级账户的 API 访问权限可延长至365 天。

2. 超过 90 天的记录需要明确的instType规范 - 省略它会返回空数据，即使提供了instId 。

3、 state字段包括filled 、 cancels 、 partial_filled 、 expired 、 failed等值；失败表示由于保证金不足或参数无效而拒绝订单。

4. 时间戳始终采用UTC，并且不会根据夏令时进行调整；本地时间转换必须在客户端使用 Python 中的datetime.timezone.utc进行处理。

5. 订单 ID 是不可变的字符串，以ORD为前缀，后跟 18 个字母数字字符 - 跨批次不存在数字序列保证。

历史订单检索过程中的常见陷阱

1. 使用get_orders_history而不是get_orders_history_archive仅生成最近 90 天的数据，无论分页尝试如何。

2. 传递无效的before值（例如不存在的ordId或超过 365 天的 ordId）会触发错误代码50015 （“前参数无效”）。

3. 指定instId时省略instType将返回带有空data数组的 HTTP 200，而不是抛出显式验证错误。

4. 将flag='1' （演示模式）与生产instId值混合会导致静默不匹配 - 在演示模式下放置的订单永远不会出现在真实账户历史记录端点中。

5. 假设已成交订单的fillSz等于sz ，会忽略强平触发执行中的部分成交，其中由于级联市场影响， fillSz可能会超过原始sz 。

常见问题解答

问：我可以在没有 API 密钥的情况下检索历史期货订单吗？不需要。 /api/v5/trade/orders-history-archive下的所有端点都需要完整身份验证，包括OK-ACCESS-KEY 、 OK-ACCESS-SIGN 、 OK-ACCESS-TIMESTAMP和OK-ACCESS-PASSPHRASE 。公共端点不公开订单历史记录。

问：为什么orders-history和orders-history-archive响应中都会出现相同的ordId ？当订单在过去 90 天内下达并且也符合存档保留条件时，就会发生这种情况。系统维护双索引，但保证重叠记录的两个端点上的负载内容相同。

问： get_orders_history_archive调用有速率限制吗？是的。端点对每个 IP 地址每 2 秒强制执行 20 个请求。超过此限制会触发 HTTP 429，其中Retry-After标头指示强制暂停持续时间。

问：止损市价单如果从未被触发，是否会出现在历史订单记录中？是的。未触发的条件订单将保留在历史记录中，如果手动删除，则state='canceled'如果在到期时间之后仍然有效，则state='pending' ，默认为 30 天，除非在放置期间被覆盖。