连接交易所只读 API

在交易所建一把只读 API 密钥贴到 Blave，就能在同一页看到你在各交易所的净值与持仓。Blave 用它无法下单或提现。

最后更新 2026-09

连接交易所只读 API，是把你在交易所创建的 API 密钥交给 Blave，让数据工作室读取你的余额与持仓。目前支持 Binance、OKX、BingX、Bitget、Bitunix、Bybit 六家。在交易所建好密钥，到 Blave API 页粘贴就完成。

连上之后能看到什么？

  • 投资组合页：把所有已连接的交易所合在一起，显示账户净值走势、投资表现、配置比例，以及每个币种在哪个交易所、哪个钱包的余额与敞口。
  • 数据工作室图表的选币窗口多一个「投资组合」标签页，列出你目前持有的币种，切换图表时不用再搜索。
  • Blave 读取的账户：Binance 的现货、U 本位合约与活期理财；OKX 的交易账户；BingX 的现货与永续合约；Bitget 经典账户的现货与合约；Bitunix 的现货与合约；Bybit 的统一交易账户。六家都不读资金账户（Funding），放在资金账户的币不会出现在投资组合页。

把 API 密钥交给 Blave 安全吗？

  • 只开读取权限。权限是交易所绑在密钥上的：一把只有读取权限的密钥，拿到的人只能查看账户，不能下单、划转或提现。
  • Blave 会定期用这把密钥读取你的余额与持仓，生成投资组合页的数据。
  • 连接窗口附有 API 连接政策：Blave 会以匿名化方式收集与分析连接账户的数据，用来改进产品。不想再被读取时，按删除步骤移除密钥。
这页讲的是数据工作室的只读连接。Blave Agent 自动下单用的交易所密钥是另一套：云端主机存在你自己那台主机上，电脑版写在你本机工作台的 .env，都不经过这个页面。

怎么在各交易所创建只读 API 密钥？

六家的流程大同小异：到账户的 API 管理页创建新密钥、只给读取权限、完成安全验证、复制密钥。两条规则每家都适用：

  • IP 白名单留空。绑了你自己的 IP，Blave 的服务器就不在名单内，会读不到数据。
  • 只开读取。交易、划转、提现权限一律不开。

Binance｜OKX｜BingX｜Bitget｜Bitunix｜Bybit

以下按钮与字段名称按交易所英文网页版；界面切换成其他语言或改版后，名称可能不同。

Binance

创建密钥前，Binance 要求账户已开启 2FA、现货钱包充值过任意金额、完成身份认证。密钥要用系统生成（HMAC），自行生成的 RSA／Ed25519 密钥连不上。Blave 连接时会检查 U 本位合约账户，还没开通合约的账户会连不上。

  1. 登录 Binance 网页版，点右上角头像 →「Account」→「API Management」，按「Create API」。App 版在「More」→「Other」→「API Management」。
  2. 密钥类型选「System-generated」，标签填 Blave，完成 2FA 验证。
  3. 确认权限只有「Enable Reading」（默认就是），其他权限不要勾，也不要设置 IP 限制。
  4. 复制 API Key 与 Secret Key。

Binance 官方说明

OKX

  1. 登录 OKX 网页版，到「Profile」→「API and connections」，按「Create API key」。
  2. 填 API key 名称（例如 Blave），「Account」选你要让 Blave 读取的账户。
  3. 「Permissions」只勾「Read」，IP 地址白名单留空。
  4. 设置 Passphrase 并记下来。OKX 创建后不会再显示，忘了只能删掉重建；在 Blave 连接时要填。
  5. 完成安全验证，复制 API Key 与 Secret Key。

OKX 官方说明

BingX

Blave 连接时会检查永续合约账户，还没开通合约的账户会连不上。

  1. 登录 BingX 网页版，到个人中心的「API Management」，按「Create API」。
  2. 填一个好辨认的名称（例如 Blave），完成安全验证。
  3. 权限只留读取，现货交易、合约交易、万向划转、子账户管理、提现都不要开，IP 留空。BingX 只有读取权限的密钥不会因为闲置被删除。
  4. 复制 API Key 与 Secret Key。

前往 BingX API 管理页

Bitget

目前只支持经典账户。统一交易账户（UTA）的密钥连接时会弹出「無效的 API。」

  1. 登录 Bitget 网页版，到个人中心的「API Management」，按「Create New API」。
  2. 「Notes」填 Blave，设置 API Passphrase 并记下来，在 Blave 连接时要填。
  3. 权限选「Read-only」，不绑定 IP。
  4. 完成邮箱、短信与 Google 验证码，复制 API Key 与 Secret Key。

Bitget 官方说明

Bitunix

Blave 连接时会检查合约账户，还没开通合约的账户会连不上。

  1. 登录 Bitunix，点右上角头像 →「API Management」，按「Create API」。
  2. 「Note」填 Blave，「Purpose」选「Bind Third-Party App」，权限会自动设为「Read-only」。界面若和这里不同，以只给读取权限为准。
  3. 完成安全验证后，页面会显示 API Key 与 Secret Key，当场复制备份。

前往 Bitunix API 管理页

Bybit

新注册的账户前 48 小时可能无法创建密钥。密钥要用系统生成（HMAC），自行生成的 RSA／Ed25519 密钥连不上。没绑 IP 的 Bybit 密钥 90 天后到期，延长方式见连接失败怎么办。

  1. 用电脑打开 Bybit 网站（App 不能创建 API 密钥），点右上角头像 →「API」，进入「API Management」页。
  2. 按「Create New Key」，选「System-generated API Keys」。
  3. 按页面选择用途，名称填 Blave。
  4. 权限选「Read-Only」，IP 选「No IP restriction」。
  5. 输入 Google 2FA 验证码，复制 API Key 与 Secret Key。

Bybit 官方说明

在 Blave 粘贴密钥

1

登录 Blave，打开 API 页，在「交易所」标签页按「连接新的 API」。

2

选交易所，粘贴 API Key 与 Secret Key；选 OKX 或 Bitget 时会多一格 Passphrase。

3

按「连接」。成功后密钥会出现在「我的 API」列表，接着打开投资组合页查看。

连接失败怎么办？

  • 弹出「無效的 API。」：Blave 用这组密钥读不到账户。依次检查：密钥复制不完整或多了空格；交易所选错；OKX、Bitget 的 Passphrase 漏填或填错；Binance、Bybit 用了自行生成的 RSA／Ed25519 密钥；Binance、BingX、Bitunix 的合约账户还没开通。
  • Bitget 密钥一直弹出「無效的 API。」：如果你的 Bitget 是统一交易账户（UTA），目前无法连接，Blave 只支持经典账户。
  • 弹出「該 API 已被連接。」：同一个交易所账户已经连在某个 Blave 账号上，可能是你的另一个账号。先到那个账号的 API 页删除，再重新连接。
  • Bybit 原本正常，后来读不到数据：没绑 IP 的 Bybit 密钥 90 天后到期。到 Bybit 的 API Management 页，在该密钥「IP Address Added」栏点编辑，选「No IP restriction」提交并完成验证，有效期从当下重新计算 90 天，密钥不变（Bybit 官方说明）。

怎么删除密钥？

  1. 先到 Blave API 页的「交易所」标签页，找到该密钥按「删除」并确认。
  2. 再到交易所的 API 管理页删除同一把密钥。

顺序不要反过来：先在交易所删除的话，Blave 这边的记录不会自动移除。