Bitfinex API Key 申請教學:唯讀權限設定完整步驟(2026)

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 打開就夠:

1. Wallets(錢包餘額)
2. Account History(帳戶歷史)
3. Margin Trading(槓桿交易部位)
4. Margin Funding(放貸——放貸族的利息與掛單就靠這項)
5. 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 申請教學。