テスト用の公開データで始める
自分の DB を連携したものの入れるデータがない場合は、下の3つのうち1つから始めてください。すべて無料・API キー不要で取得でき、取り込みスクリプトと画面で選ぶ値(テーブル・列)までそのとおりに進めれば完了です。 スクリプトはパーサーを追加する構成なので、使いたいソースがあれば項目を1つ書き足すだけです。
フェッチャーを取得
フェッチャーのリポジトリを VPS(エージェントが動いているサーバー)にクローンします。依存関係は pg ひとつだけです。 ★ .env の DATABASE_URL は書き込み用アカウントにしてください。読み取り専用アカウントでは INSERT が拒否されるのが正常で、そのアカウントは SoriTrading 連携専用です。
git clone https://github.com/Value-Connect-Global-Inc/soritrading-fetchers ~/soritrading-fetchers cd ~/soritrading-fetchers && npm install cp .env.example .env # DATABASE_URL
https://github.com/Value-Connect-Global-Inc/soritrading-fetchers · オープンソース · 1フォルダ = 1フェッチャー · cron 自動登録
下の3つは**入門用の例**です。リポジトリには VIX・暗号資産のインプライド・ボラティリティ(DVOL)・長短金利差・ドル指数・ステーブルコイン時価総額・DeFi TVL などもあり、すべて無料・キー不要です — `node run.mjs list` で全一覧を確認できます。市場データは米国の休場日には値がなく(0 ではなく欠損)、DVOL は2021年3月からです。
データ設定画面の見方
エージェント管理 → エージェントを選択 → データ設定タブ。登録・削除はこの画面でご本人だけが行います — AI はデータセットを読むだけで、接続文字列は絶対にチャットに貼り付けません。画面は上から次の順です。
- 外部 DB 連携 — 接続名(例: main)と接続文字列を入力します。エージェントの端末にのみ暗号化して保存され、サーバーには送られません。画面を開くとエージェントがテーブル一覧を自動で読み込みます([接続確認] は再読み込みしたいときに)。
- テーブルとデータセット — DB のテーブルごとに1行です。テーブル名 · おおよその行数 · テーブルコメント、そしてそのテーブルを読むデータセットがその下に表示されます。
- AI 公開レベル(テーブル行の右側) — 非公開(既定 — AI はテーブルの存在すら知りません)· 名前のみ · 列まで · サンプルまで · 照会を許可。選んだら [公開設定を保存]。列・サンプル・照会のレベルでは実際のデータが AI に送られるため、個人情報を含むテーブルは公開しないでください。public スキーマのテーブルのみ公開できます。
- データセット名(テーブル行の下) — 戦略が ctx.data(名前) で呼び出す値です。[+ このテーブルでデータセットを追加] → 名前・時刻列・値列を選ぶと説明はテーブルコメントで埋まり、[テスト] に合格すると [保存] が使えるようになります。1つのテーブルに複数の名前を付けられます(フィルターで取引所・銘柄ごとの系列を分けるとき、または古い戦略が別の名前を使っているとき)。状態バッジ: 利用可能 · 確認前 · 未接続。バッジ横のリアルタイムバッジを押すと起動設定(poll·notify·redis)が開きます — ほとんどは既定値で十分です。
- 計算データセット(SQL) — 移動平均・ラグ値・複数テーブルの組み合わせなど計算が必要な値。SQL は複数のテーブルを読めるため、特定のテーブルの下ではなく別にまとめています。ほとんどの計算は戦略コードで ctx.data を2つ使ってもできるので、SQL は過去区間全体が必要な計算(移動平均・順位)のときだけ使ってください。以前の方式で登録された SQL はここで [SQL 確認済み] · [削除] するか、単純な形ならテーブル選択方式に一括変換します。
- テーブルが見つからないデータセット — 宣言したテーブルが現在の一覧にない場合、消えずに理由とともにここに残ります — テーブル一覧をまだ受信していない(存在しないという意味ではありません)· その DB にテーブルがない(名前変更・削除)· この端末にその接続名がない。
- 範囲は2つあります — AI 公開レベルは今開いているその端末にのみ保存されます。データセットは同じ接続名を持つすべての端末に適用されます。端末が複数ある場合、公開レベルは端末ごとに選びます。
1. 恐怖強欲指数
alternative.me0(極度の恐怖)〜100(極度の強欲)、1日1回。2018-02 から全期間。価格だけでは見えない心理の軸なので、最初のテストに最適です。
node run.mjs fear-greed
接続: main · テーブル: fear_greed 名前: fg · 時刻列: ts · 値列: v
2. ビットコインのハッシュレート
blockchain.comチェーン自体の指標(TH/s)。価格とは別の軸なので局面フィルターとして使えます。値が大きくトレンドが緩やかなので、生の値より移動平均に対する比率で使う方が適しています。
node run.mjs btc-hashrate
接続: main · テーブル: btc_hashrate 名前: hashrate · 時刻列: ts · 値列: v
3. 米国政策金利(練習用)
FRED (DFF)日次の実効フェデラルファンド金利。マクロ局面フィルターの代表的な値です。 ★ 注意: 同じ値が基本指標 base_fedfunds としてすでに入っています(ctx.data('base_fedfunds') — エージェントが FRED から収集)。同じ値を2つの経路で入れると、結果でどちらを使ったか区別できないため、これは連携の練習用としてだけ使ってください。
node run.mjs fed-funds
接続: main · テーブル: macro_fed_funds 名前: dff · 時刻列: ts · 値列: v
定期収集(cron)
フェッチャーごとに宣言された周期で crontab に登録します。再実行しても行が重複せず、自分で追加した cron には触れません。ログは logs/ フォルダのフェッチャー別ログファイルに残ります。
node run.mjs --install-cron
- 時刻カラムは秒単位の epoch を推奨します(ミリ秒・ISO も自動認識され、どちらで読んだかは検証レポートの tsUnit に残ります)。
- スクリプトを再実行しても安全です — 重複なく新しい値だけが更新されます(upsert)。新しいデータは定期的に再実行すれば取り込めます。
- バックテスト結果にはデータのフィンガープリント(行数・ハッシュ)が残ります — DB の内容が変わるとフィンガープリントが変わり、フィンガープリントが異なる2つの結果は同じ条件ではありません。
- 外部データを使うバックテストもエージェントで実行されます — すべてのバックテストはエージェント(マイストア)でのみ実行されます。
- 公開レベルを設定したテーブルは AI に公開されます(カラム・サンプル・照会レベルでは実データが送られます) — 個人情報を含むテーブルは公開しないでください。
すべてのドキュメントはこちら — ご利用ガイド