博客登录免费开始

Bybit 交易日志

FOQUS 会自动为你的 Bybit 账户记交易日志。每一个 USDT 和 USDC 永续合约仓位都会自动记入，无需手动输入，连同它的手续费、资金费和止损记录。连接只需要统一交易账户（UTA）上的一个 Read-Only（只读）密钥，日志永久免费。

更新于
阅读时长
11 分钟

FOQUS 从 Bybit 记录什么

FOQUS 记录以 USDT 结算的 Bybit 永续合约（例如 BTCUSDT）和以 USDC 结算的永续合约（例如 BTCPERP）。一开仓，仓位就会出现在日志里，盈亏、止损和持仓时间实时更新。

每笔交易都会保留：

  • 成交。开仓、加仓、减仓和平仓，每一笔都带价格、数量和手续费。
  • 止损和止盈。每一次设置、撤销和移动，以及订单是否触发。
  • 资金费。持仓期间每一次结算收到或扣除的资金费。
  • 强平。作为单独的操作标在交易时间线上。
  • 限价入场单。从挂单、修改到撤单的全过程。
  • 开仓时的账户。钱包余额、权益，以及当时还开着的其他仓位。
  • 每次操作时的市场。过去 5 分钟、1 小时和 1 天里价格变动了多少、成交了多少，再加上 RSI、资金费率、持仓量和多空比。
  • 订单簿。每次开仓、加仓、减仓和平仓前后各录一分钟：Bybit 的合约订单簿；如果这个币有现货，旁边还有现货订单簿。免费套餐每天可录制 10 次。

一笔交易记下来是什么样子——你入场的那一秒、一次移动止损、资金费——可以看首页上的时间线。一笔交易本来能赚多少、又回吐了多少，见 MAE 和 MFE 指南。

哪些 Bybit 网站可以使用

Bybit 在若干国家设有独立的网站，每个网站都有自己的 API 地址，密钥只能用于它所属网站的地址。FOQUS 支持六个：bybit.com、bybit.tr、bybit.kz、bybitgeorgia.ge、bybit.ae 和 bybit.id。你什么都不用选：连接时，FOQUS 会依次尝试这些地址，在第一个认出你密钥的地址处停下。

FOQUS 不支持 Bybit EU、日本和香港的账户。Bybit 的文档说明，Bybit EU 的 API 只为经纪商的第三方应用提供服务。FOQUS 找不到这样的密钥，会提示：“Bybit doesn’t know this key”（Bybit 不认识这个密钥）。

FOQUS 中的 Bybit 密钥检查：依次尝试六个地区 API 地址，然后检查 Read-Only 模式，再检查统一交易账户；每一项拒绝都附有连接页面上的提示
从上往下看：这就是检查的顺序。红框里引用的是连接页面上的提示。

还有一个条件：统一交易账户（UTA）。经典账户的密钥，FOQUS 不会保存，并提示“Bybit rejected the key. Check the API key and secret.”（Bybit 拒绝了密钥，请检查 API key 和 secret）。如果确定密钥和 secret 都没错、错误却反复出现，请检查你的账户类型。

如何创建 Bybit 只读 API 密钥

密钥只能在 Bybit 网站上创建，App 里做不到。新注册的 Bybit 账户在注册后的前 48 小时内可能无法创建密钥。

  1. 登录你的账户所在的 Bybit 网站。点击右上角的个人资料图标，选择 API。在 bybit.com 上，这就是 API 管理（API Management）页面。
  2. 点击 新建密钥（Create New Key），选择 System-generated API Keys：密钥和 secret 由 Bybit 生成。
  3. 在 API Key Usage 下保留 API Transaction。Connect to Third-Party Applications 是给 Bybit 列表上的应用用的。
  4. 给密钥起个名字，例如 FOQUS。在 API Key Permissions 下选择 Read-Only（只读）。
  5. 能勾选的都勾上：Orders、Positions 等等。在 Read-Only 模式下，每一项都只能查看。
  6. 选择 No IP restriction。FOQUS 不公布它的 IP 地址列表，所以绑定了 IP 的密钥无法使用。
  7. 点击 Submit，输入验证码（一个来自邮件，一个来自 Google Authenticator），然后点击 下一步（Next Step）。复制 API Key 和 API Secret：secret 只显示一次。
  8. 注册 FOQUS 账户，在 Connect your own account（连接你自己的账户）下选择 Bybit。如果你已经在用 FOQUS，打开账户菜单 → Add account（添加账户）。粘贴密钥和 secret，点击 Connect exchange（连接交易所）。

上面的中文名称取自 Bybit 的中文帮助中心，没有中文名称的选项写的是 bybit.com 英文版上的叫法；其他语言和地区版 Bybit 网站的叫法可能不同。只读 API 密钥指南把 Bybit 的密钥和 Binance、OKX 的放在一起讲解。

不绑定 IP 的 Bybit API 密钥能用多久

不绑定 IP 的密钥，Bybit 保留三个月；绑定了 IP 的密钥一直有效。修改账户密码后，旧密钥会在 7 天内失效。密钥过期后，FOQUS 会把账户标记为“The venue refused this key — the account is not updating”（交易所拒绝了这个密钥，账户已停止更新）。

在那之前就续期密钥，不用更换。打开 API 管理，在 IP Address Added 一列点击编辑，选择 No IP restriction，点击 Submit，再用邮件验证码和 2FA 验证码确认。从这一天起，密钥又有 90 天有效期，key 和 secret 都不变。

如果密钥已经过期，就创建一个新密钥，粘贴到 FOQUS 中：账户菜单 → Edit account（编辑账户）。新密钥必须来自同一个 Bybit 账户。来自其他账户的密钥，FOQUS 会拒绝，并提示“This key belongs to a different exchange account”（这个密钥属于另一个交易所账户）。

把 Bybit 密钥交给 FOQUS 安全吗？

  • Read-Only 是核实过的，不是假定的。连接时，FOQUS 会向 Bybit 查询密钥的模式。Read-Write 密钥会收到“The key is not read-only”（密钥不是只读的）提示，并被丢弃。
  • 发出的只有读取请求。FOQUS 向 Bybit 发送的是查询成交、订单、仓位和余额的 GET 请求。它们都不会下单、转移资金或提现，Read-Only 密钥本来也做不到。
  • 保存的内容：密钥、加密后的 secret，以及密钥属于哪个 Bybit 网站。
  • 不再使用时：在 FOQUS 中删除这个账户，它的交易也会随之删除；然后在 Bybit 的 API 管理中删除密钥。

FOQUS 在 Bybit 上看不到的：现货、期权、交割合约，以及 BTCUSD 这样的币本位反向合约。连接之前的交易也不会进入日志：Bybit 的账户历史里没有这些交易的订单簿，而 Bybit 的订单历史只返回最近 24 小时内撤销的订单。下一次入场之前，仓位计算器能按给定的止损算出仓位大小。更喜欢用表格？这里有免费的交易日志模板。其他平台：Binance、OKX、MetaTrader 5。

Bybit 交易日志常见问题

我以前在 Bybit 的历史会被导入吗？

不会，这是有意为之：旧的历史包含的信息太少，不足以复盘一笔交易。里面没有订单簿，而 Bybit 的订单历史只返回最近 24 小时内撤销的止损单。所以 FOQUS 从你连接的那一分钟起自行记录每一笔交易：止损、入场时的账户和市场快照、订单簿。之前开的仓位不会进入日志，即使你在连接之后才平仓。

FOQUS 支持 Bybit 现货吗？

不支持。FOQUS 只记录 USDT 和 USDC 永续合约，现货交易不会进入日志。不过订单簿录制会在合约订单簿旁边显示这个币的现货订单簿。

bybit.tr、bybit.kz 或其他地区版的账户能用吗？

能用。bybit.com、bybit.tr、bybit.kz、bybitgeorgia.ge、bybit.ae 和 bybit.id 都可以。在你的账户所在的网站上创建密钥，FOQUS 会自己查出这是哪个网站的密钥。Bybit EU、日本和香港的账户无法连接。

我的 Bybit 账户为什么停止更新了？

最常见的原因是密钥过期：不绑定 IP 的密钥，Bybit 只保留三个月。修改密码后，旧密钥会在 7 天内失效。给密钥续期，或者把同一个账户的新密钥粘贴到 Edit account 中。

可以连接多个账户或子账户吗？

可以。每个账户或子账户都需要自己的 Read-Only 密钥，添加数量不限。子账户也必须是统一交易账户（UTA）。同一个 Bybit 账户无法添加第二次，无论用哪个密钥。

资料来源

  • Bybit: How to Create Your API Key?——密钥只能在网站上创建，新账户有 48 小时限制，创建步骤和 Create New Key 窗口：API Transaction、Read-Only、No IP restriction。文中 API 管理页面的截图还写明：不绑定 IP 的密钥有效期三个月，修改密码后旧密钥 7 天内失效，secret 只显示一次。最后更新于 2025 年 11 月 25 日。
  • Bybit 中文帮助：如何创建 API 密钥？——上文步骤中的中文名称“API 管理”“新建密钥”“下一步”。
  • Bybit API: FAQ——不绑定 IP 的密钥 90 天后过期；如何在保留 key 和 secret 的情况下续期。
  • Bybit API: Get API Key Information——FOQUS 检查的 readOnly 和 uta 字段。
  • Bybit API: Get Order History——状态为 Cancelled、Rejected 或 Deactivated 的订单只返回最近 24 小时的；超过 7 天只返回有成交的订单。
  • Bybit API: Get Orderbook——订单簿请求只接受交易对和深度，不接受时间，返回的是当前的订单簿。
  • Bybit API: Integration Guidance——各地区版 Bybit 网站的 API 地址；Bybit EU 的 API 只为经纪商的第三方应用提供服务。

适用于其他交易所和经纪商的交易日志