如何查看您在 OKX 上的 SOL 订单历史记录？

通过 OKX REST API 访问 SOL 订单历史记录

1. 使用instId设置为“SOL-USDT”的order_history端点或其他SOL交易对。

2. 对于现货订单，将 instType 指定为“SPOT”；对于涉及 SOL 的保证金订单，将 instType 指定为“MARGIN”。

3. 将限制参数设置为 1 到 100 之间，以控制每个请求的响应大小。

4. 在 HTTP 标头中包含有效的 API 凭据：OK-ACCESS-KEY、OK-ACCESS-SIGN、OK-ACCESS-TIMESTAMP 和 OK-ACCESS-PASSPHRASE。

5. 使用 HMAC-SHA256 通过连接字符串构建签名：'GET' + '/api/v5/trade/order-history' + 时间戳 + 请求正文（GET 为空）。

处理完整 SOL 订单记录的分页

1. 初始请求最多返回 100 个订单，其中“after”字段包含最新订单 ID。

2. 后续请求必须包含先前响应中的“after”值，以获取较旧的订单。

3. 重复，直到响应数据数组为空或包含的条目少于请求的限制条目。

4. 避免硬编码分页逻辑——将“after”视为不透明光标，而不解析其内部结构。

5. 在合并之前单独存储每个批次，以防止在大量历史检索期间内存溢出。

SOL 订单的正确参数格式

1. 确保 instId 与 OKX 使用的命名约定完全匹配：“SOL-USDT”、“SOL-BTC”或“SOL-USDC”。

2. 下单或查询订单时，价格和尺寸字段使用Decimal而不是float，以避免精度损失。

3. 如果缩小时间范围，则为前/后过滤器传递自 Unix 纪元以来的毫秒时间戳。

4. 过滤与保证金相关的 SOL 订单时，不要省略 tdMode 参数——它必须是“交叉”或“隔离”。

5. 确认 API 密钥至少在 OKX 账户仪表板的安全设置下启用了“读取”权限。

获取 SOL 订单数据时的常见错误

1. HTTP 401 错误表示签名无效、时间戳过期或密码不匹配。

2. 代码为“51000”的 HTTP 400 表示 instId 不存在或拼写错误 - 验证区分大小写和连字符的使用。

3. 空响应，代码为“0”，但没有数据表明保证金订单的 instType 不正确或缺少 tdMode。

4. 速率限制触发 HTTP 429 — 尊重 X-Rate-Limit-Remaining 标头并实现指数退避。

5. OkxParamsException 是由格式错误的 Decimal 输入或相关市场调用中不受支持的柱间隔引起的。

常见问题解答

问：我可以检索超过 90 天的 SOL 订单历史记录吗？答：是的。 order_history 端点支持超过 90 天的检索，具体取决于账户活动和 OKX 的保留策略。当前的 V5 规范中没有记录明确的截止。

问：order_history 是否包括已成交、已取消和已拒绝的 SOL 订单？答：是的。包括除部分完成的订单之外的所有订单状态。部分成交的订单仅在活跃时出现；历史部分填充在取消或完成后不会保留。

问：是否有 WebSocket 替代方案可用于实时 SOL 订单更新？答：是的。使用具有正确身份验证的 WebSocket 订阅 /private/orders 频道​​。这无需轮询即可提供实时订单状态更改。

问：为什么某些 SOL 订单在响应中显示不同的费用货币？答：费用币种取决于交易模式：现货订单使用基础资产或报价资产作为费用，杠杆订单则可能根据配置从借入资产或账户余额中扣除费用。