独立指南 · 币安与第三方工具
LINKDESKCONNECTION FIELD NOTES币安 API · 第三方交易工具 · 权限管理
连接更清楚,授权更有数。
03 · API 密钥创建与配置

工具里点「快速链接」授权币安,和手动粘贴 API 密钥有什么不同?

两条路最后都会在你的币安账户上生成一把 API 密钥。差别在于这把密钥由谁创建、私钥(Secret Key)落在谁手里、权限和 IP 由谁勾,以及停用工具时你要回到哪里收尾。

LINKDESK 编辑整理 · · 8 分钟阅读
两条路的分岔点

手动连接时,你在【API 管理】里建好密钥,把 API Key 和 Secret Key 复制进工具。一键授权时,工具通过币安的 Fast API 替你建密钥,Secret Key 加密后直接发给工具,你自己从头到尾看不到它。省掉的是复制粘贴,交出去的东西并没有变少。

上面一条是手动连接:你建密钥、你复制、你填进工具;下面一条是 Fast API:工具发起请求,币安生成密钥并加密送回工具。两条路的终点都是账户上的同一种 API 密钥。

「快速链接」背后是 Fast API,结果仍是一把 API 密钥

不少行情看板、跟单和量化平台在「连接币安」那一步给两个选项:一个是填 API Key 和 Secret Key 的输入框,另一个是一颗写着快速连接、一键授权之类字样的按钮。按钮背后是币安的 Fast API。

币安帮助中心《如何對接Fast API》(发布于 2022-06-22)对它的描述是:一项帮助币安用户快速授权特定账户权限、创建 API 密钥并自动绑定第三方(API 经纪商)平台的功能;用户在经纪商平台点「快速鏈接」按钮登录币安账户并授权,API Key 会自动生成并绑定到经纪商平台,“省去了用户手动创建API Key并绑定的流程”。

所以别把一键授权理解成一种比 API 更轻的连接。它省掉的只是你自己动手建密钥、复制、粘贴这几步;工具拿到的仍然是一把能调用你账户接口的 API 密钥,权限、IP 限制、撤销这些问题一个都不少。

点下按钮之后,币安把什么交给了工具

同一页的流程图画了三方:币安用户授予币安账户权限给 API 经纪商,经纪商向币安请求 API Key,币安发送加密后的 API Key 回去。

币安帮助中心《如何對接Fast API》公开页面,显示发布日期 2022-06-22、Fast API 的功能说明,以及币安用户、API 经纪商、币安三方之间授权、请求 API Key、发送加密 API Key 的流程图
帮助中心《如何對接Fast API》开头:正文里有「快速鏈接」按钮的说法,流程图右侧是币安把加密后的 API Key 发回经纪商。截于 2026 年 10 月

开发者文档里「为用户创建 API 密钥」这个接口(POST /v1/api-key/create)把细节写得更清楚:

  • 工具用你授权后得到的访问令牌(请求头里的 Bearer access token)去调用这个接口,代你建密钥。
  • 工具在请求里附上自己的一把公钥,币安用它加密生成的密钥,工具再用自己的私钥解开。
  • 接口返回的字段里同时有 apiKey 和 secretKey。

最后一条是关键。手动连接时,Secret Key 至少在你屏幕上出现过一次,你知道它被粘贴进了哪里;一键授权时它从生成那一刻起只在工具手里。工具怎么保存、是否加密存放、离职员工能不能看到,你只能去读工具自己的安全说明,币安的页面管不到这一段。

密钥的名称(apiName)也是工具在请求里填的,文档注明这个名字可以重复。日后你在账户里看到这把密钥,叫什么取决于工具当初怎么填。

一键授权能开哪些权限,提现在不在里面

上面那个接口的请求参数里,跟权限有关的开关是这几个:enableTrade(现货交易)、enableFutureTrade(合约交易)、enableMargin(杠杆)、enableEuropeanOptions(欧式期权)。后两个如果不传,或者你的账户没开对应的账户类型,默认是 false。

参数表里没有提现开关。一键授权建出的密钥日后能不能在别处加上提现权限,文档没有写。交易工具本来也不该要提现权限,这一点和手动建密钥时的原则一样,只读、交易、提币三档权限那篇讲过为什么。

IP 限制由 status 字段决定:1 或空值表示不限 IP,2 表示只允许受信任 IP,3 表示只允许受信任的第三方 IP。ipAddress 里可以填受信任 IP,一把密钥最多 30 个。文档还写了一条硬规则:要开任何交易权限(含现货、杠杆或合约),必须限制 IP 访问。

换句话说,一把能下单的一键授权密钥,应该是绑了 IP 的,而且通常绑的是工具服务器的出口地址。授权页上如果有权限或 IP 的展示,点同意之前看一眼它要的开关和你打算让它做的事对不对得上;页面上什么都没展示的,事后到账户里核对(见下文)。

手动创建密钥时,哪几个决定留在你手里

帮助中心《如何在币安创建API密钥》(最后更新 2025-03-20)的路径是:头像 →【账户】→【API 管理】→【创建 API】。建之前有三个前提:开启双重验证、向现货钱包充值任意金额、完成身份认证。

走这条路,下面这些事由你决定,而不是工具:

  1. 密钥类型。系统生成的是 HMAC 对称密钥;自行生成的是 Ed25519 或 RSA,你只把公钥交给币安。怎么选看工具支持什么,见密钥类型那篇。
  2. 标签。自己起一个能认出用途的名字,比如写上工具名和日期,日后清理时一眼能对上。
  3. IP 限制。帮助页写明:无 IP 访问限制的 HMAC 密钥除了读取没有任何权限;要开提现,必须添加 IPv4 格式的 IP 限制。填哪个地址,IP 白名单那篇从请求出口讲起。
  4. 每一个权限开关,以及之后要不要改。

代价是 Secret Key 要经过你的手。币安 API 常见问题写明,密钥只在创建时可见,丢了只能新建;同一页也提醒,把 API 密钥填进第三方平台有安全风险,币安不支持第三方服务。所以复制之后别存在聊天记录、截图或共享文档里,填进工具就关掉页面。

一键连接还是手动填密钥:按这三点选

两种方式没有哪种天然更安全,分别把风险放在不同的地方。下面三个问题能帮你决定这一次走哪条:

  • 你想不想亲手勾每一个开关?想精确控制只给读取、不给合约,手动建密钥更直接;一键授权的权限组合由工具发起,你能做的是看授权页、事后核对。
  • 你打算同时连几个平台?Fast API 那页有一句限制:一个币安账号只能通过 Fast API 连结到一个经纪商平台一次。想在几个平台之间试用的,很可能有一部分只能手动连。
  • 工具跑在谁的机器上?自己的脚本、自己的服务器,只能手动建密钥,Fast API 是给通过币安审核的经纪商平台用的。帮助页写明,平台要通过机构审查和 oAuth 安全资质审查才能接入。

如果工具同时提供两种方式,而它要的又只是读取余额,手动建一把只读密钥往往更省心:权限一目了然,标签是你自己起的,删除时不用猜哪一把是它的。需要下单时,一键授权省去了自己找出口 IP 的麻烦,前提是你接受 Secret Key 从一开始就只在工具那边。

停用工具时,两种连接都要回到 API 管理收尾

Fast API 的帮助页和开发者文档都没有写撤销入口。能确定的是,它生成的是你账户上的 API 密钥,所以收尾的方向和手动连接一致:不要只在工具里点断开或卸载 App,回到币安账户这边把密钥本身处理掉。

可以按这个顺序做:

  1. 打开【API 管理】,逐把看标签、创建时间和权限。一键授权建的那把,名字是工具填的,可能是平台名,也可能是一串你不认识的字符。
  2. 对不上用途、又想不起是谁建的,先看创建时间能不能对上你点授权的那天。
  3. 确认没有别的工具在用,再删除。删之前,先在工具里断开,免得它继续拿旧密钥重试。

在 API 管理里找不到任何对得上的密钥,而工具仍显示已连接,就把截图和时间发给工具客服问清楚,必要时联系币安客服确认。正常停用的完整清单在停用工具那篇;如果是怀疑密钥已经泄露,处理顺序不同,直接看密钥轮换与紧急撤销那篇。

搜到的「币安钱包授权撤销」:那是链上合约的额度

搜「币安 授权 撤销」,结果里会混进币安钱包(Web3 钱包)的内容,比如帮助中心《区块链授权及管理方法》。那里说的授权,是你在链上允许某个智能合约动用钱包里的代币,撤销也在钱包的资产页里操作。

它和本文说的 API 授权是两套东西:一个管链上钱包对合约的额度,一个管第三方工具调用交易所账户接口。撤销了钱包授权,交易所里的 API 密钥照旧有效;反过来也一样。分不清自己点过的是哪一种时,先看授权发生在哪个页面:在交易工具里点「连接币安」的,归 API 管理;在钱包里连 dApp、签名批准的,归钱包。

连接之前想先过一遍用途和权限,可以用权限检查。

按用途核对需要的权限 ↗

继续阅读

05 · 停用工具后收回授权

不再用某个交易工具:卸载之后还要检查什么

区分停用软件、撤销 API 密钥和处理平台未完成状态,完成连接生命周期的最后一步。

阅读指南 ↗
03 · API 密钥创建与配置

HMAC、RSA、Ed25519:先确认工具支持,再选 API 密钥

把算法名称、密钥文件、工具兼容性和迁移计划分开核对,避免换了类型仍无法连接。

阅读指南 ↗