← ご利用案内に戻る
外部DB連携ガイド

Supabase で自分のデータを連携する

ご自身のデータベースの指標(例: 恐怖・強欲指数、オンチェーンデータ)を戦略から ctx.data() で読めるようにする最も簡単な方法です。Supabase の無料プランで十分で、接続文字列はエージェントのデバイスにのみ保存されます — soritrading のサーバーはデータもパスワードも見ることができません。

始める前に — エージェントがインストール・ペアリング済みである必要があります(エージェント管理画面で確認)。データがすでに別の Postgres にある場合は、ステップ3(読み取り専用アカウント)からそのまま適用できます。
1

Supabase プロジェクトを作成

supabase.com で無料プロジェクトを作成します。リージョンはエージェント(VPS)に近い場所がおすすめです。

2

テーブルを作成してデータを入れる

SQL エディターまたは Table Editor で時系列テーブルを作成します。最低限必要なのは時刻列(タイムスタンプ)と値列の2つです。 例: fear_greed(ts bigint, v numeric) — ts は秒単位の epoch を推奨(ミリ秒・ISO も自動認識されます)。 入れるデータがまだない場合は、まず下をご覧ください — このステップを丸ごと省略できます。

入れるデータがありませんか? — 多くの人がここでつまずきます

無料の公開データから始めるのが最も早い方法です。恐怖・強欲指数・ビットコインのハッシュレート・米国政策金利・VIX などの指標をご自身の DB に入れるオープンソースの収集器を提供しています — すべて無料で API キーは不要です。 収集器が **テーブルも自動で作成します**(ts・v の2列)。そのため、このステップ2でやることがなくなります — コマンド1行でデータを読み込み、cron の登録も1行です。 ★ 読み込みには書き込み権限のあるアカウントを使います。ステップ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)方式も表示されます。 ★ UI の表記は 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 非対応)。
  • バックテスト結果にはデータの指紋(行数・ハッシュ)が残ります — DB の内容が変わると指紋が変わり、指紋が異なる2つの結果は同じ条件ではありません。