OKX API 报错 50102，核心原因就一个：你发请求时附带的 OK-ACCESS-TIMESTAMP 时间戳和 OKX 服务器的时间差超过 30 秒了。服务器会认为这个请求已经过期，直接拒绝。
校准方法分两步走：先拿到 OKX 服务器的准确时间，再确保你的本地时间戳误差在允许范围内。
步骤 1：获取 OKX 服务器时间并计算本地偏差
通过官方接口拿到 OKX 服务器的毫秒级时间戳，再算出你的机器时间和它差了多少。调用 OKX 的公开时间接口 GET /api/v5/public/time，返回数据里会有一个 ISO 8601 格式的服务器时间。同时获取你本地的系统时间，两者相减就是偏差值，完成后确认本地时间与服务器时间的偏移量。
步骤 2：校准本地时间戳格式与精度
修正你代码里生成时间戳的方式，确保格式和精度都符合 OKX 的要求。OKX 要求 OK-ACCESS-TIMESTAMP 头必须严格遵循 ISO 8601 UTC 毫秒级格式：YYYY-MM-DDTHH:MM:SS.SSSZ，精确到 3 位毫秒。如果你的格式是 2024-06-15T12:34:56.789000Z（含 6 位微秒），或者少了最后的 Z，都会被拒。完成校准后，你的代码生成的时间戳和 OKX 服务器时间偏差需在 30 秒以内，且格式为精确到 3 位毫秒的 ISO 8601 字符串。
风险提醒：签名原文（prehash string）里的 timestamp 必须和 OK-ACCESS-TIMESTAMP 头里的值完全一致，包括格式和毫秒位数。不一致也会导致签名验证失败。
使用第三方SDK的适配方案
部分SDK支持 use_server_time=True 参数自动获取OKX时间，但问题在于SDK内部可能返回的是Unix毫秒时间戳，而API要求的是ISO 8601字符串格式，两者不一致会导致50102错误。此时你需要检查SDK版本或手动将时间戳转为ISO 8601格式。
手动构建请求头的时间戳生成规范
生成时间戳时，不要直接用 datetime.now() 不加时区，那样默认取本地系统时间，大概率会偏。应该强制使用UTC时间并截断到毫秒，Python参考实现如下：
import datetime as dt
def get_time() -> str:
now = dt.datetime.now(dt.timezone.utc)
# 截断微秒到毫秒
now_ms = now - dt.timedelta(microseconds=now.microsecond % 1000)
return now_ms.strftime('%Y-%m-%dT%H:%M:%S.') + f'{now_ms.microsecond // 1000:03d}Z'这段代码把时间截断到精确的3位毫秒，再拼上Z表示UTC时间。
常见失败原因
最大的坑是本地系统时钟漂移，尤其是跑在云虚拟机上的交易机器人，虚拟化环境下的时钟很容易慢慢偏离真实时间。另一个常见问题是SDK自带的 use_server_time=True 功能，你以为自动同步了服务器时间就没事，但SDK内部的时间戳格式可能根本没转成ISO 8601字符串，而是直接用了毫秒时间戳，导致格式不匹配而被拒。
后续校验操作指引
如果本地时间偏差超过1秒，先用NTP同步系统时钟，Windows可以启用时间服务同步，Linux/macOS可以手动 sudo ntpdate -s time.apple.com 校准。同步后跑一笔小额API请求（比如查账户余额）来验证50102是否已经消失。如果仍然报错，检查你的签名拼接逻辑——时间戳在签名原文里也必须用完全相同的字符串，不能重复生成。
