交易所 API 密钥与权限配置：自动交易的安全基线

自动交易的前提是你把账户的一把「钥匙」交给程序。这把钥匙能做什么，完全由创建时勾选的权限和限制决定。以下内容基于各交易所官方文档，先讲原则，再讲各家差异与排错顺序。

四条不可妥协的原则

1. 只开「读取」和「交易」，永不开启「提现」。 程序化下单不需要提现权限。密钥一旦泄露，没有提现权限最多被恶意交易，有提现权限则会被直接搬空。
2. 配置 IP 白名单。 把运行交易服务的服务器出口 IP 加进白名单，密钥泄露后攻击者从其他 IP 也无法调用。
3. 密钥只存在于服务端。 不要把 API Secret、Passphrase 写进前端代码、警报消息、聊天记录或截图。
4. 按用途拆分密钥。 一个机器人一把、或至少一个用途一把，便于单独吊销和定位问题。

Binance：创建步骤与三个常见卡点

Binance 官方文档给出的前置条件是：账户已完成身份验证、开启两步验证（2FA）、现货钱包有过入金以激活账户。之后在头像菜单进入 API 管理 → 创建 API，选择密钥类型（系统生成，或自行生成的 Ed25519 / RSA 密钥对），命名并通过 2FA 验证即可。Secret 只在创建时完整显示一次。

官方 FAQ 明确列出了三个最容易卡住的地方：

• IP 不受限制时，系统生成的密钥只能设为「允许读取」。 想要交易权限，必须配置 IP 访问限制，或改用自行生成的密钥对。这是「明明勾了交易却用不了」的第一大原因。
• 提现权限强制要求配置 IPv4 白名单。 官方专门为提现加了这道门槛，本身就在提示这是高危权限——而自动交易根本用不到它。
• 无法开启合约权限通常有两种原因：密钥创建时合约账户还没开通；或账户启用了统一账户（Portfolio Margin）模式。

OKX：多出来的 Passphrase，以及丢了怎么办

OKX 的密钥有三个值：API Key、Secret Key，以及一个由你自己设定的 Passphrase（密码短语）。所有需要签名的私有请求都必须带上对应的请求头，缺少它调用会直接失败。

权限方面，官方 FAQ 明确分为 Read（读取）、Trade（交易）、Withdraw（提现） 三类。跑量化或第三方平台通常只需要读取加交易。

还有两个容易被忽略的规则：未绑定 IP 且带交易或提现权限的密钥，闲置 14 天后会被系统自动删除（调用需要身份验证的私有接口即算作使用，只读或已绑 IP 的密钥不受影响）；此外，一个密钥最多绑定 20 个 IP 地址。

Bybit / Gate / Bitget / HTX / Hyperliquid

• 同样遵循「只读 + 交易、不开提现」的原则；多数平台支持 IP 白名单，配好后安全性显著提升。
• 部分平台把合约、现货、统一账户权限分开勾选——按你实际要跑的市场类型开，不要图省事全开。
• Hyperliquid 是链上永续，凭证与授权模型与中心化交易所不同，务必先确认它的签名与授权方式，再决定投入多少资金。
• 无论哪家，创建后先跑一笔极小额的测试单，确认方向、数量、杠杆都符合预期，再接策略。

密钥报错排查顺序

遇到「无法读取账户」或「下单被拒绝」，按这个顺序查，能覆盖绝大多数情况：

1. 权限不足：是否漏勾「读取」或「交易」；Binance 上还要留意 IP 不受限制时只能读取的限制。
2. IP 不匹配：服务器出口 IP 变了（换机器、换代理、云厂商 NAT 变动），把新 IP 加进白名单。
3. Passphrase 错误或缺失：OKX、Bitget 这类需要 Passphrase 的交易所，三个值必须来自同一把密钥，混用会直接失败且报错信息不总是明确。
4. 密钥已失效：OKX 上长期未调用且未绑 IP 的密钥会被自动删除；已删除的密钥无法恢复，只能重建并更新平台凭据。
5. 账户模式限制：统一账户、子账户、合约账户未开通等开关，会表现为「权限明明勾了却用不了」。

在 AutoTrading 里配置密钥

在交易所 API 页面录入后，系统会加密保存凭证，只在需要下单时于服务端解密；页面不会回显完整的 Secret 与 Passphrase。OKX、Bitget 这类必须提供 Passphrase 的交易所，表单会强制要求填写。

一个实践建议：密钥配好后，先配好对应交易所的手续费减免再开始跑策略，这样从第一笔交易起就享受折扣，不必事后迁移账户。

接下来

密钥配好只是第一步。下一步是把信号链接上——具体做法见 TradingView Webhook 自动交易。