← 返回使用說明
外部資料庫串接指南

用 Supabase 串接我的資料

這是讓策略透過 ctx.data() 讀取你自己資料庫中指標(例如恐懼貪婪指數、鏈上資料)最簡單的方法。Supabase 免費方案就足夠,連線字串只儲存在代理程式裝置上 — soritrading 伺服器看不到資料,也看不到密碼。

開始之前 — 代理程式必須已安裝並完成配對(在代理程式管理畫面確認)。若資料已經在其他 Postgres 中,可直接從第3步(唯讀帳戶)開始。
1

建立 Supabase 專案

在 supabase.com 建立免費專案。區域最好選離代理程式(VPS)近的地方。

2

建立資料表並匯入資料

用 SQL 編輯器或 Table Editor 建立時間序列資料表。最低需求是時間欄位(時間戳記)與數值欄位兩欄。 例:fear_greed(ts bigint, v numeric) — ts 建議使用秒為單位的 epoch(毫秒與 ISO 也會自動辨識)。 若還沒有要匯入的資料,請先看下方 — 可以整個略過這一步。

沒有要匯入的資料嗎? — 大部分人卡在這裡

從免費公開資料開始最快。我們提供開源收集器,可把恐懼貪婪指數、比特幣算力、美國基準利率、VIX 等指標填入你的資料庫 — 全部免費,不需要 API 金鑰。 收集器會 **自動建立資料表**(ts、v 兩欄)。所以這第2步就沒有要做的事了 — 一行指令匯入資料,註冊 cron 也只要一行。 ★ 匯入時使用有寫入權限的帳戶。第3步建立的唯讀帳戶是代理程式讀取時使用的另一個帳戶。

查看公開資料匯入指南 →
3

建立唯讀帳戶(重要)

策略驗證只需要讀取。把下方 SQL 貼到 Supabase SQL 編輯器以建立唯讀角色 — 這是即使連線字串外洩也無法修改資料的真正防線。

create role readonly_bot login password 'replace-with-strong-password';
grant usage on schema public to readonly_bot;
grant select on all tables in schema public to readonly_bot;
alter default privileges in schema public grant select on tables to readonly_bot;
4

複製連線字串

開啟專案儀表板的 Project Overview → Get connected,複製 Direct 項目下的 URL,然後只把使用者名稱與密碼換成第3步建立的。同一處也會顯示連線池(pooler)方式。 ★ Supabase 可能會修改介面文字 — 是哪種方式,複製下來的 URL 本身就會告訴你: · 主機為 db.專案ref.supabase.co(直連)→ 使用者名稱就是 readonly_bot · 主機包含 pooler.supabase.com → 使用者名稱為 readonly_bot.專案ref(保留點後面的 ref — 刪掉會被拒絕連線) ★ 免費方案的直連(5432)僅支援 IPv6 — 若代理程式伺服器沒有 IPv6,請使用 Session mode(連線池)URL。

5

串接後交給 AI

在 代理程式管理 → 選擇代理程式 → 資料設定 分頁輸入連線名稱(main)與 URL,系統會立即驗證連線。 接著在同一畫面,透過資料表那一列的 [+ 以此資料表新增資料集] 選擇名稱、時間欄與數值欄,再按 [測試] → [儲存](AI 只會讀取資料集)。儲存後,AI 就能以該名稱(例如 ctx.data('fg'))撰寫策略並執行回測。若沒有要匯入的資料,可從 /guide/datasets 的公開資料範例(恐懼貪婪指數等)開始。

須知
  • 免費專案閒置1週後會被暫停 — 代理程式每10分鐘一次的驗證會被算作活動,所以通常會保持喚醒。
  • 即時更新(notify 模式)只在 Session mode URL 下有效(Transaction mode 連線池不支援 LISTEN)。
  • 回測結果會留下資料指紋(列數·雜湊)— 資料庫內容改變後指紋就會不同,指紋不同的兩個結果並非同一條件。