Bitfinex API Key 申请教学:唯读权限设置完整步骤(2026)
发布于 2026年7月17日
作者 ExAgg 团队 — 我们亲手打造了串接 10 家交易所与 40+ 条链的资产追踪 App,以下都是实作路上踩过、验证过的经验。
Bitfinex 是不少人放贷(Margin Funding)收息的主力交易所,想把放贷部位跟其他交易所的资产一起看总额,申请一把唯读 API Key 就能做到:App 只能读取,任何下单、提币请求都会被 Bitfinex 服务器挡掉(原理见唯读 API Key 安全吗?)。
Bitfinex 的权限做得特别细:每个类别都分 Read / Write 两个开关。我们要开的是五项 Read,所有 Write 一律不碰。
还没有 Bitfinex 帐号?可以用 Bitfinex 注册链接完成注册(放贷功能齐全,繁中界面)。
申请步骤
⚠️ Bitfinex 的 API 只能用网页版申请——手机 App 没有这个功能。请用电脑(或手机浏览器)登录 bitfinex.com 操作。
第一步:进入 API Keys 页面
登录 Bitfinex 后,点右上角头像打开帐户菜单,选最下方的「API Keys」。
第二步:点「Create New Key」创建新密钥
在 API 页面上方会看到三个分页:「Bitfinex APIs」「My API Keys」「Create New Key」。点最右边的「Create New Key」开始创建一把新密钥。
第三步:只开 Read、关掉所有 Write 与提币,命名后产生密钥
进入权限设置页,Bitfinex 每个类别都分 Read / Write 两个独立开关。原则很简单:要读的类别把 Read 拨成 On、所有 Write 一律 Off、Withdrawals(提币)也 Off。
要追踪总资产与放贷,把这几类的 Read 打开就够:
- Wallets(钱包余额)
- Account History(帐户历史)
- Margin Trading(杠杆交易部位)
- Margin Funding(放贷——放贷族的利息与挂单就靠这项)
- Read account settings(帐户信息)
同时确认:
- Withdrawals → Create a new withdrawal 保持 Off(提币关闭)
- 所有 Write 开关(如 Write account settings)保持 Off
最后在下方字段帮密钥取个好认的名字(例如 Exagg),按绿色的「Generate API key」。
⚠️ 按下 Generate 之后还没结束! Bitfinex 会寄一封确认信到你的注册信箱,你必须去收信、点信里的确认链接,这把 API Key 才会真正创建并生效。没点链接的话,密钥不会激活——「明明建了却连不上」几乎都是漏了这一步。确认生效后,再把 API Key 与 Secret 拷贝,贴回 ExAgg 的「添加交易所 → Bitfinex」。
Bitfinex 特有的注意事项
- 五项 Read 一项都别漏:漏掉 Margin Funding 就看不到放贷部位,漏掉 Wallets 连余额都读不到。
- 确认信要点:创建密钥后 Bitfinex 会寄 email 要你确认,没点密钥不会生效——「明明建了却连不上」多半是这个原因。
- Read 与 Write 是独立开关:确认每一行只亮 Read,任何 Write 都不开,符合最小权限原则。
常见问题 FAQ
唯读密钥外流,Bitfinex 的钱(含放贷中的资金)会被动吗?
不会。所有 Write 与提币关闭的密钥,只能查找,不能下放贷单、不能撤单、不能提币;对方最多看到你的余额、放贷部位与纪录。详见唯读 API Key 安全吗?。
放贷的利息收益读得到吗?
可以。开了 Margin Funding 与 Account History 的 Read,放贷部位与历史纪录都能读取,ExAgg 会把放贷中的资金算进总资产。
密钥存在哪里?
只存在你手机的系统安全保存区(iOS Keychain / Android Keystore),不上传服务器。
怎么撤销?
登录 Bitfinex → API Keys,删除该密钥即可立刻永久失效。
连好之后呢?
Key 贴进 ExAgg,Bitfinex 的钱包、杠杆与放贷部位就会汇进同一个总资产数字,跟币安、OKX 同框比较。其他交易所接法:Binance 币安 API Key 申请教学、Pionex 派网 API Key 申请教学。