OKX 交易日志
FOQUS 会自动为你的 OKX 账户记交易日志。每一个 USDT 和 USDC 永续合约仓位都会自动记入，无需手动输入，连同它的手续费、资金费和止损记录。连接需要一个只有“读取”（Read）权限的密钥、它的 Secret key 和密码短语（Passphrase）。日志永久免费。
FOQUS 从 OKX 记录什么
FOQUS 记录以 USDT 和 USDC 为保证金的 OKX 永续合约，例如 BTC-USDT-SWAP 和 BTC-USDC-SWAP。
仓位持有期间，它会出现在 FOQUS 中，盈亏、止损和持仓时间实时更新。每一次加仓和部分平仓都作为单独的操作记下，带价格、数量和手续费。你何时设置、撤销或移动止损和止盈，FOQUS 都会标出。每次资金费结算都会计入这笔交易。
仓位平仓后，它会有一个含手续费和资金费的结果；强平作为单独的事件显示。旁边是你的限价入场单：哪些挂过、改过、撤过。
在你的每次成交前后，FOQUS 会保留当时的背景：入场时的余额和其他仓位，以及一份市场快照——价格变化和成交量、RSI、资金费率、持仓量。它还会录下 OKX 自己的订单簿，每次入场、加仓、部分平仓和出场前后各一分钟。免费套餐每天包含 10 次这样的录制。
不包括：现货和杠杆交易、交割合约、期权，以及 BTC-USD-SWAP 这样的币本位永续合约。连接之前开的仓位也不包括：OKX 的账户历史里没有订单簿，而已撤销且未成交的普通委托，OKX 只保留 2 小时。所以 FOQUS 从你连接的那一分钟起自行记录每一笔交易。
哪些 OKX 网站可以使用
OKX 有三个独立的网站，每个都有自己的 API 地址，密钥只能通过它所属网站的地址使用。三个网站的账户 FOQUS 都能连接：
| 你在哪里注册 | FOQUS 读取的 API 地址 |
|---|---|
| okx.com | openapi.okx.com |
| my.okx.com（欧洲经济区） | eea.okx.com |
| app.okx.com（美国和澳大利亚） | us.okx.com |
FOQUS 会自己判断是哪个网站：先试 openapi.okx.com，再试 eea.okx.com，然后是 us.okx.com，记下认出密钥的那一个。如果一个都没认出，就什么也不保存，连接页面会显示“OKX doesn’t know this key. Check the API key.”（OKX 不认识这个密钥，请检查 API key）。
如何创建 OKX 只读 API 密钥
- 登录你注册时用的 OKX 网站。点击头像 → API 与连接（API and connections）→ 创建 API key（Create API key）。在 App 中：左上角的九宫格菜单（Menu，⋮⋮⋮）→ API → 创建 API key。
- 填写 备注名，例如 FOQUS。选择你交易所用的 账户（主账户或子账户）以及密钥的 用途。
- IP 地址白名单 留空：FOQUS 不公布它的地址。
- 在 权限 下只保留 读取（Read）。不要开启 交易（Trade）和 提币（Withdraw）；如果看到 划转（Transfer）、借币（Loan）和 赚取（Earn），也不要开启。
- 为密钥设置一个 密码短语（Passphrase）并记下来。OKX 无法找回它：忘了的话，只能新建一个密钥。
- 确认，然后保存 API key 和 Secret key。
- 注册 FOQUS 账户，选择 OKX，填写三个字段：API key、API secret 和 Passphrase。点击 Connect exchange（连接交易所）。
上面的中文名称取自 OKX 的中文帮助中心，括号里是英文网站上的叫法。菜单项的名称取决于 OKX 网站的版本和地区。在某些地区，账户资产至少达到 100 USD，OKX 才允许创建密钥。
不绑定 IP、却有“交易”或“提币”权限的密钥，14 天不使用就会被 OKX 删除。这条规则与 FOQUS 用的密钥无关：它没有这些权限。OKX 的其他过期规则写在它的 API 常见问题里，见“API key 会过期吗？”一节。如果 OKX 哪天停用了密钥，FOQUS 中的账户会显示“The venue refused this key — the account is not updating”（交易所拒绝了这个密钥，账户已停止更新），并等待新的密钥。
只读 API 密钥指南把 OKX 的密钥和 Binance、Bybit 的放在一起讲解。
把 OKX 密钥交给 FOQUS 安全吗？
- 权限由 OKX 自己给出。连接时，FOQUS 会获取密钥的配置，OKX 在其中把密钥权限列为 read_only、trade 或 withdraw。只要有 read_only 以外的权限，就会提示“The key is not read-only”（密钥不是只读的），密钥随即被丢弃。
- 只有读取。FOQUS 发给 OKX 的只有读取请求。它不能下单或撤单，不能在账户之间转移资金，也不能提币。
- 加密保存：Secret key 和密码短语。API key 和密钥所属 OKX 网站的地址不加密保存。
- 断开连接：在 FOQUS 中删除这个账户，它的交易也会随之删除。然后在 OKX 的个人资料 → API 中删除密钥。
日志把一个账户的交易汇集成表格、带图表的卡片，或者周报、月报和年报。在此基础上，MAE 和 MFE 会告诉你每一段行情你留住了多少，仓位计算器会按止损规划下一次入场。手动记日志也可以：交易日志模板是免费的。同样支持连接的还有：Binance、Bybit、MetaTrader 5。
OKX 交易日志常见问题
OKX 的密码短语从哪里来？
它是你在创建密钥时自己设定的，不是 OKX 账户的登录密码。之后无法查看：如果丢了，就删除这个密钥，再新建一个。
FOQUS 为什么提示“Incorrect OKX passphrase”（OKX 密码短语不正确）？
OKX 认出了密钥，但不接受这个密码短语。需要的是你创建这个密钥时设定的那个：每个密钥都有自己的密码短语。请检查键盘布局和大小写。
欧洲、美国或澳大利亚的 OKX 账户能用吗？
能用。FOQUS 会查出密钥是在哪个网站创建的（okx.com、my.okx.com 或 app.okx.com），并通过那个网站的地址读取你的交易。
我以前在 OKX 的历史会被导入吗？
不会，这是有意为之：旧的历史包含的信息太少，不足以复盘一笔交易。里面没有订单簿，而已撤销且未成交的普通委托，OKX 只保留 2 小时。所以 FOQUS 从你连接的那一分钟起自行记录每一笔交易。在那之前开的仓位，即使后来才平仓，也会被跳过，因为 FOQUS 从未见过它们的止损，也没见过入场时的账户。
可以连接 OKX 子账户吗？
可以。在子账户里创建密钥，带上它的权限和它自己的密码短语。不要把主账户和子账户的密钥、密码短语混用。FOQUS 会记录这个子账户的交易。
资料来源
- OKX: API FAQ——在网站和 App 上创建密钥的步骤；密码短语无法查看或找回；Transfer、Loan 和 Earn 权限；在某些地区需要 100 USD 资产的条件；子账户的密钥；密钥过期。更新于 2026 年 9 月 28 日。
- OKX 中文帮助：API 常见问题——上文步骤中的中文菜单和字段名称。
- OKX API: Order history (last 7 days)——已撤销且未成交的普通委托保留 2 小时。
- OKX API: Order book——订单簿请求只接受交易对和深度，不接受时间，返回的是当前的订单簿。
- OKX API v5——Read、Trade 和 Withdraw 权限；每个密钥最多 20 个 IP 地址；不绑定 IP、有 trade 或 withdraw 权限的密钥，14 天不使用就会过期；my.okx.com 和 app.okx.com 的 API 地址；FOQUS 检查的 perm 字段。