← 所有文章

工具 · 2026.10.10 · 3 min

Bitfinex 放貸利率月報:公開資料算數字,排程開 PR 等人審

利率月報只用 Bitfinex 公開 K 線算,任何人都能重算;Claude Code 的雲端 routine 每月自動開 PR,但一定等人審過才合併。

閱讀設定
主題
字級
寬度

EZLO 教學區有一份每月更新的 Bitfinex 放貸利率月報,靠兩個決定撐著。數字只用 Bitfinex 公開的放貸 K 線算,任何人都能自己重算,也碰不到我的定價方法。產出交給 Claude Code 的雲端 routine,每月自動開 PR,但絕不 merge,每一期都等我審過。試跑時重新產生的 8 月數字跟 repo 裡的版本完全相同,等於順便驗證了可以重算。

會做這份月報,是因為「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%。

刻意不寫的東西有三類:引擎觀察到的時段規律、EZLO 的定價方式、EZLO 使用者的收益。月報只放任何人都算得出來的數字。

結構圖:月報數字只用 Bitfinex 公開的放貸 K 線(api-pub.bitfinex.com/v2/candles),2 天期為主、30 與 120 天期對照,USD 和 USDT 各一份,不用 EZLO 內部的利率快照。放進月報的是平均年化、扣手續費後(再 × 0.85)、成交量加權的 P10 到 P90 常見區間、近 12 個月走勢;刻意不寫引擎的時段規律、EZLO 的定價方式和使用者收益。

指標要能說出東西

原本想算「年化高於 15% 的熱門天數」,結果近 12 個月全是 0,放上去沒有資訊,改成「日均年化低於 5% 的冷門天數」。單筆最高與最低利率也不列,小成交量的單筆常常印出 0% 或 511% 這種數字。

還有一個單位陷阱。K 線和 ticker 給的是每日利率,funding/stats 的 FRR 卻是每日利率再除以 365,兩個混用會差 365 倍。

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

一個 routine 全包,但不 merge

排程用 Claude Code 的 cloud routine,台北時間每月 2 號早上 10 點跑。一個 routine 全包:跑 script、寫評論、登記到清單、跑 lint 與 build、開 PR。prompt 裡的規則是:

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

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

流程圖:Claude Code cloud routine 每月 2 號自動跑,先確認上個月的 JSON 或 PR 不存在,再跑 script、寫評論並登記清單、跑 lint 與 build 後開 PR;routine 絕不 merge,每一期都等人審過才合併。

雲端環境的兩個坑

正式排程之前,先用一次性的 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。

對照圖:雲端環境網路設定 Trusted 是預設,會擋掉 api-pub.bitfinex.com(CONNECT 403);現在用 Full,Bitfinex 回 200,代價是這個環境的雲端 session 都能連任何網站;Custom 可以只放行 api-pub.bitfinex.com。另外容器裡沒有 gh CLI,prompt 改用 GitHub MCP 查 PR、開 PR。

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

小結

  • 對外引用的數字,資料來源要是公開的,讓別人能自己重算。
  • 指標長期都是 0 就沒有資訊,換一個說得出東西的。
  • 不同 API 的利率單位不一樣,混用前先確認。
  • 排程任務的 prompt 要冪等,失敗就停,不要讓它自己找替代方案或估數字。
  • 要打外部服務的雲端排程,先用一次性 routine 試跑,預設白名單不含一般外部 API。
  • 對外內容一定留一道人工審稿。
#Claude Code#Bitfinex#放貸利率#自動化

留言

載入留言中…

下一篇

工程

從績效抽成改成固定年費:訂閱帳單與促銷的設計決定

EZLO 的收費從績效費改成訂閱制。方案上限比收費先落地,促銷加送凍結在帳單上,30 天通知只擋被動收費,停權不碰使用者自己的放貸開關。