Bitfinex 放貸利率月報自動化：Claude Code routine 每月開 PR，等人審才合併

讓 Claude Code 每月自動產生對外的 Bitfinex 放貸利率月報，數字要能讓別人驗證，內容也要有人審。

我靠兩個決定撐著。第一，數字只用 Bitfinex 公開的放貸 K 線算，任何人都能自己重算，也碰不到我的定價方法。

第二，產出交給 Claude Code 的雲端 routine，每月自動開 PR，但絕不 merge，每一期都等我審過。

試跑時重新產生的 8 月數字，跟 repo 裡的版本完全相同，等於順便驗證了可以重算。

月報放在我的 Bitfinex 自動放貸平台 EZLO 的教學區。會做這份月報，是因為「Bitfinex 放貸利率」這個詞一直有人搜尋。

我希望它能被別人引用，又不想靠自己每個月記得手動跑。

只用公開 K 線

EZLO 內部有自己記錄的利率快照，月報不用它。

資料只用 Bitfinex 公開的 api-pub.bitfinex.com/v2/candles，主要看 2 天期，30 天與 120 天期當對照，USD 和 USDT 各一份。

數字的定義：

• 平均年化：2 天期的小時收盤利率，依成交量加權後乘 365。
• 扣手續費後：再乘 0.85（Bitfinex 對放貸收 15%），還沒扣資金閒置的時間。
• 常見區間：成交量加權的 P10 到 P90 百分位。
• 走勢：近 12 個月的 2 天期月平均。

月份一律以 UTC 切，算法寫在頁面的「數字怎麼算」裡。8 月的 2 天期平均年化，USD 是 7.11%，USDT 是 6.22%。

8 月那一期的月報，算法直接寫在頁面上。

刻意不寫的東西有三類：引擎觀察到的時段規律、EZLO 的定價方式、EZLO 使用者的收益。

月報只放任何人都算得出來的數字。

指標要說得出東西

原本想算「年化高於 15% 的熱門天數」，結果近 12 個月全是 0，放上去沒有資訊。

我改成「日均年化低於 5% 的冷門天數」。

單筆最高與最低利率也不列，小成交量的單筆常常印出 0% 或 511% 這種數字。

還有一個單位陷阱。K 線和 ticker 給的是每日利率，funding/stats 的 FRR（市場平均放貸利率）卻是每日利率再除以 365，兩個混用會差 365 倍。

不同 API 的利率單位不一樣，混用前要先確認。

評論也有硬規則：每個數字都要對得回 JSON，不做預測，不猜原因。

一個 routine 全包，但不 merge

排程用 Claude Code 的 cloud routine，台北時間每月 2 號早上 10 點跑。

一個 routine 全包：跑 script、寫評論、登記到清單、跑 lint 與 build、開 PR。prompt 裡的規則是：

• 上個月的 JSON 已經存在，或已經有對應的 PR，就直接結束，重跑不會開出第二個 PR。
• script 失敗就停，不換資料來源，不自己估數字。
• lint 和 build 都通過才開 PR。
• 絕不 merge。

最後一條是刻意的。我的個人專案慣例是自動 merge，但月報是對外內容，每一期都要人審過才合併。

排程任務的 prompt 要冪等（重跑幾次結果都一樣），失敗就停，不要讓它自己找替代方案或估數字。

雲端環境的白名單與 gh

正式排程之前，先用一次性的 routine 試跑。

雲端環境預設的 Trusted 網路白名單擋掉了 api-pub.bitfinex.com（CONNECT 403），script 第一個 fetch 就中止。容器裡也沒有 gh CLI。

網路的問題可以改成 GitHub Actions 抓數字、Claude 只寫評論，但要多維護一支 workflow。

我選擇把雲端環境的網路改成 Full，維持單一 routine。改完重跑，Bitfinex 回 200。

沒有 gh，就改在 prompt 裡用 GitHub MCP 查 PR 和開 PR。

改成 Full 的代價是，所有用這個環境的雲端 session 都能連任何網站。想收緊的話，可以改成 Custom，只放行 api-pub.bitfinex.com。

要打外部服務的雲端排程，先用一次性 routine 試跑，預設白名單不含一般外部 API。

10 月 2 號第一次正式跑，routine 開出了 9 月那一期的 PR，已經合併。

對外內容一定留一道人工審稿。