Bitfinex Funding（放貸）API 教學
Bitfinex 的 Funding 市場讓您把 USDT / USD 借給融資用戶、賺取每日利息。PERPETUA 會自動幫您掛單、調整利率、收回本金。此教學說明如何建立「只限 Funding」的 API Key、確保安全。
1 註冊 Bitfinex 帳號
若您還沒有 Bitfinex 帳號：
Bitfinex 主要用於 放貸（Funding）、而非合約交易。請確認您理解 Funding 機制： 資金借出、利息每日結算、本金被借期間無法即時動用（預設最短 2 天、最長 30/120 天）。
2 完成 KYC
- 進入 Account → Verification
- Bitfinex 分 Basic / Intermediate / Full 三級
- 放貸用建議至少通過「Intermediate」（身分證 + 地址證明）
- 審核通常 1–3 工作日、建議準備英文版地址證明（銀行月結單、水電費）
3 建立 Funding 專用 API Key
- 登入後進入 API 管理頁
- 點「Create New Key」
- Key 標籤填：
PERPETUA-FUNDING-2026 - 完成 2FA 驗證
權限設定（關鍵）
Bitfinex 權限選項非常細、分 Account / Orders / Margin / Funding / Wallet 等區塊。只勾以下項目：
- Account History：Get historical balances (Read)
- Wallets：Get wallet balances (Read)
- Funding：Get funding statuses / Create funding offers / Cancel funding offers（全勾 Read + Write）
- Orders：全部不勾（PERPETUA 不在 Bitfinex 做現貨 / 合約）
- Margin Trading：全部不勾
- Withdraw：絕對不勾
警告：Bitfinex 的「Withdraw」權限與提幣綁定。
只要未勾選、即使 key 外洩、攻擊者也無法把 USDT / USD 提走、最多只能取消您的 offer。
資金仍安全鎖在您的帳戶中。
IP 白名單（建議）
Bitfinex 支援 IP 限制、請填：
151.145.67.78
4 取得 Key 和 Secret
- 建立後、API Key + Secret 會顯示一次
- 立即複製、關閉視窗後 Secret 永久消失、無法補看
- 若遺失、到 API 管理頁刪除、重建即可
5 貼進 PERPETUA
- 將 USDT / USD 從 Exchange Wallet 轉到 Funding Wallet（Bitfinex 內部轉帳、免手續費）
- 回 /onboard API 設定頁
- 交易所選「Bitfinex」
- 貼入 Key + Secret
- 儲存後、PERPETUA 會自動偵測 Funding Wallet 餘額、開始掛放貸單
PERPETUA 放貸策略目前僅對 USDT / USD 操作、利率參考市場深度動態調整、最短借期 2 天。若您臨時需要取回、可到 Bitfinex 手動取消未成交 offer；已成交的部分須等借期結束。
FAQ
Q: 放貸有風險嗎？
主要風險是 Bitfinex 平台本身（交易所風險）。借貸本金由 Bitfinex 系統強制平倉機制保障、歷史上極少發生呆帳。但請勿放入超過您可承受損失的金額。
Q: 我可以隨時取回嗎？
已掛單未成交：可立即取消。已成交：須等到借期結束（2–30 天、PERPETUA 預設優先短期）。
Q: 這把 key 能下合約嗎？
不能。按本教學只勾 Funding 權限、即使誰拿到 key 也只能操作放貸、無法交易或提幣。
Q: 我想停用？
（1）PERPETUA 設定頁停用放貸策略；（2）到 Bitfinex 刪掉這把 key；（3）把資金從 Funding Wallet 轉回 Exchange Wallet。