费鉴gaterar.com
简繁
量化与 API · 约 6 分钟读完

币安 API 怎么申请?API Key 创建步骤与权限设置

币安 API Key 在账户的 API 管理页面创建,需先开启双重验证,生成 API Key 与 Secret Key 两串字符。权限分读取、现货及杠杆交易、合约交易、提现,开提现前必须先绑定 IP。只看行情与资金费率完全不需要 API Key。

本文要点

  1. 币安 API Key 在登录后的 API 管理页面创建,创建前必须开启双重验证(2FA),系统会生成 API Key 与 Secret Key 两串字符。
  2. API Key 相当于账号,Secret Key 相当于密码,Secret Key 一旦外泄,别人就能以你的名义调用权限内的所有功能。
  3. 币安 API 权限分读取、现货及杠杆交易、合约交易与提现,只需要开程序真正用到的那几项,提现权限必须先设置 IP 限制才能开启。
  4. 只查行情、标记价格与资金费率不需要申请 API Key,币安的公开接口直接就能调用。

币安 API Key 在登录后的 API 管理 页面创建:开启双重验证(2FA)后,给 Key 取个名字、完成安全验证,系统就会生成 API Key 与 Secret Key 两串字符。权限建议从只开“读取”开始,程序需要下单再加开现货或合约交易,提现权限不要开。

如果你只是想用程序查行情或资金费率,其实不需要申请任何 Key,直接调用公开接口即可,见 用 API 获取资金费率。

申请币安 API 需要什么条件?

创建 API Key 本身不收费,但交易所会要求账户先达到一定的安全条件,常见的有:

  1. 开启双重验证(2FA):例如身份验证器 App 或其他验证方式,这是创建 Key 的必要条件。
  2. 完成身份认证:一般账户需要先完成身份认证才能使用 API,具体要求以页面提示为准。
  3. 开通对应的账户:想让程序下 U 本位合约单,账户需要先开通合约功能,否则无法勾选合约交易权限。
  4. 所在地区可以使用服务:币安的服务范围因地区而异。部分受限地区的 IP 访问币安接口会被拒绝(例如从美国 IP 调用合约接口可能收到 HTTP 451),这和 Key 是否设置正确无关。

账户还在使用中的风控限制、子账户等特殊情况,能否创建 Key 以交易所页面显示为准。

币安 API Key 在哪里创建?步骤是什么?

各版本网页与 App 的菜单位置会调整,下面是通用的流程,按钮名称以页面显示为准:

  1. 登录币安网页版,在右上角的账户或个人中心菜单里找到 API 管理。
  2. 点击创建 API,选择密钥类型。一般用户选系统生成的类型即可;如果你的程序要求使用自己生成的公私钥,再按开发者文档选择对应类型。
  3. 为这个 Key 填一个备注名,例如“行情记录脚本”或“网格测试”,方便以后辨认与删除。
  4. 完成邮箱、手机或身份验证器的安全验证。
  5. 页面显示 API Key 与 Secret Key。Secret Key 通常只在这一刻完整显示,离开页面后就无法再看,务必立即保存到安全的地方。
  6. 进入编辑页面,设置权限与 IP 访问限制,保存后才会生效。

建议一个用途创建一个 Key,不要所有程序共用同一个。这样某个程序出问题时,只要删除它对应的 Key,其他程序不受影响。如果要同时运行多套策略,也可以用子账户把资金分开,每个子账户各自创建 Key,某个 Key 出问题时,影响只限于该子账户里的资产。子账户的开通条件以币安页面为准。

API Key 和 Secret Key 有什么区别?

两串字符的角色完全不同:

项目 作用 可以给别人看吗 遗失或外泄怎么办
API Key 标识“这是哪个 Key”,请求时放在请求头里 尽量不要,但外泄本身风险较小 若和 Secret Key 一起外泄,立即删除
Secret Key 用来对请求签名,证明请求确实由你发出 绝对不行 立即删除该 Key,重新创建

可以把 API Key 想成账号、Secret Key 想成密码。程序每次调用私有接口时,会用 Secret Key 对请求内容计算签名,交易所核对签名后才执行。所以 任何人拿到 Secret Key,就能以你的名义执行这个 Key 权限内的所有操作。不要把它截图、发在聊天群、贴进公开代码仓库,也不要交给声称“帮你调试”的陌生人。更完整的保存方式见 交易所 API 安全。

币安 API 权限怎么选?

币安的 Key 可以勾选多种权限,常见的几项如下:

权限 能做什么 适合的用途 建议
读取 查询资产、订单、成交记录 记账、盈亏统计、持仓监控 默认开启,风险最低
现货及杠杆交易 下单、撤单(现货与杠杆) 现货网格、定投程序 程序要下现货单才开
合约交易 合约下单、撤单、调整杠杆 合约策略、资金费率套利 程序要下合约单才开
提现 把资产提到外部地址 极少数自建资金调度 不建议开启

选择原则是“最小权限”:程序只需要统计盈亏,就只开读取;只做现货网格,就不要顺手开合约交易。权限越少,Key 外泄时的损失上限越低。

币安要求 必须先设置 IP 访问限制,才能开启提现权限。即使是自己写的程序,资金调度也可以手动处理,没有必要让 Key 具备提币能力。交给任何第三方工具的 Key,更是一律不开提现。

币安 API 一定要绑定 IP 吗?

不绑定也能使用读取与交易权限,但强烈建议绑定。绑定 IP 后,只有来自白名单地址的请求会被接受,即使 Secret Key 外泄,攻击者也无法从其他地方调用。

绑定的前提是程序运行在 固定 IP 的机器上,例如租用的云服务器。家用宽带的 IP 往往会变动,绑定后可能某天突然连不上。未限制 IP 的 Key 在权限或有效期方面可能有额外规则,以币安的官方说明为准。

用 API 下单手续费会更贵吗?

不会。API 下单与网页、App 手动下单使用同一套费率,按账户的 VIP 等级与挂单、吃单计算。一般用户 U 本位合约挂单 0.02%、吃单 0.05%,现货挂单与吃单都是 0.1%。

举例:程序用市价单(吃单)开一笔 10,000 USDT 的合约仓位,手续费是 10,000 × 0.05% = 5 USDT;改用限价挂单成交是 10,000 × 0.02% = 2 USDT。程序交易次数通常比手动多,挂单与吃单的差距会累积得很快,见 API 交易手续费与限频 与 币安手续费指南。

创建后怎么测试?出错怎么排查?

建议先只开读取权限,用程序查询一次账户余额,确认签名与连接都正常后,再按需要加开交易权限。常见的出错原因:

  1. IP 不在白名单:程序所在机器的出口 IP 和设置的不同,请求会被拒绝。
  2. 时间不同步:签名请求带有时间戳,本机时间偏差太大时会被拒绝,开启系统自动校时即可。
  3. 权限不足:例如只开了现货交易,却调用合约下单接口。
  4. 签名错误:参数顺序、编码或 Secret Key 复制时多了空格,都会导致签名对不上。

具体错误代码与含义以币安开发者文档为准。不再使用的 Key 要及时删除,换机器或换程序时也建议直接创建新 Key,而不是修改旧 Key 继续沿用。

想了解欧易的做法,见 欧易 API 怎么申请;还没有账户的话,注册入口见文末或 邀请码页。

开户

在币安、欧易开户

币安 Binance

邀请码 BN6691

注册币安
欧易 OKX

邀请码 OK6667

注册欧易

注册前请确认你所在地区可以合法使用该交易所。

参考资料

  1. 币安开发者文档|标记价格与资金费率(Mark Price)
  2. 币安|交易手续费率(Fee Schedule)

常见问题

币安 API Key 在哪里?

登录币安后,在账户或个人中心菜单里找到 API 管理页面即可创建与查看,入口名称以页面显示为准。Secret Key 通常只在创建时完整显示一次,要当场妥善保存。

币安 API 权限怎么选?

只看资产与订单开读取即可;程序要下现货单再开现货及杠杆交易,要下合约单再开合约交易。提现权限一般不要开,币安也要求先设置 IP 限制才能开启。

币安 API 申请要钱吗?

不要钱,创建 API Key 本身免费。通过 API 下单和手动下单一样按 VIP 等级与挂单、吃单收手续费,U 本位合约一般用户是挂单 0.02%、吃单 0.05%。

查资金费率需要申请币安 API 吗?

不需要。标记价格、资金费率与历史结算记录都是公开接口,不带 API Key 也能调用。只有查询自己的资产、订单或下单时才需要 API Key 与签名。

看到不懂的名词?查 合约术语表。

→延伸阅读
  1. 01量化 API交易所 API 安全吗?提币权限、IP 白名单与被盗处理API Key 的风险来自 Secret Key 外泄:只读权限最多泄露资产信息,交易权限可被人用冷门币对倒转走资金,提币权限则能直接提走资产。不开提币、绑定 IP 白名单、最小权限是三条底线。附被盗后的处理步骤与第三方平台的风险判断。
  2. 02量化 APIAPI 交易手续费一样吗?限频规则与量化下单成本怎么算API 下单与手动下单手续费相同:币安与欧易永续合约一般用户挂单 0.02%、吃单 0.05%,现货币安 0.1%、欧易挂单 0.08%。量化成本主要来自高频成交,每天 20 笔 2,000 USDT 吃单一个月约 600 USDT。附网格打平间距与限频说明。
  3. 03量化 API资金费率 API 怎么用?币安、欧易公开接口与示例代码资金费率用公开接口就能获取,不需要 API Key:币安用 premiumIndex 与 fundingRate,欧易用 funding-rate 与 funding-rate-history。返回值是小数,0.0001 即 0.01%,附换算年化的 Python 与 JavaScript 示例。
  4. 04量化 API欧易 API 怎么申请?API Key、密钥与 Passphrase 设置欧易 API Key 由 API Key、Secret Key 与 Passphrase 三部分组成,Passphrase 是创建时自己设定的密码,三者缺一不可。权限分读取、交易、提币,支持 IP 白名单,创建前需开启双重验证。附与币安 API 的差异对照。