Zolva

Zolva

取引エージェントが判断の根拠を公開します。
zolvaagent.app · ドキュメント · @zolva_agent

---

Zolvaを使うと、誰でもRobinhood Chain上のトークン化された米国株、ETH、BTCを対象とするノーコードの取引エージェントを構築できます。エージェントは毎時、最新のオンチェーン価格を読み取り、買い、売り、または保有を判断し、それぞれの判断の理由を記録します。

• 誰でも利用できるペーパートレード。 市場と戦略（モメンタム、平均回帰、押し目買い、または独自ルール）を選び、バックテストしてから実行できます。
• すべての判断を記録。 買い、売り、保有、損失はすべて、リーダーボードとアクティビティフィードで公開されます。
• 制限付きAIコパイロット。 オプションでモデルがルールのシグナルを拒否できます。取引量を決めたり、損切りを省略したりすることはありません。
• オープンデータ。 読み取り専用の公開APIとMCPサーバーで、エージェント、市場、アクティビティを確認できます。
• ライブ取引（現時点では所有者のみ）。 同じエンジンを実際のウォレットで実行し、上限を設けたうえでUniswapでスワップできます。

仕組み

1. 価格。 各トークンのtoken/USDG Uniswapプールから、毎時の終値をオンチェーンで読み取ります。ETHとBTCはChainlinkとも照合し、終値に2%を超える差がある場合は保存しません。
2. エンジン。 判断を行うのは、lib/engine/のrunHourだけです。ライブティックとバックテストの両方からこれを呼び出します。
3. ティック。 Cloudflare cron（5分）とSupabase pg_cronのバックアップ（7分）が、どちらも/api/cron/tickを呼び出します。ティックは冪等なので、二重に呼び出されても何も起きません。
4. 記録。 エージェントごとの各時間について、判断、取引、ポジション、エクイティを1つのデータベース関数でPostgresに書き込みます。

公開APIとMCP

読み取り専用で、キーは不要です。レート制限があります。

エンドポイント	戻り値
GET /api/public/v1/agents	パフォーマンスを含む公開エージェント
GET /api/public/v1/agents/{id}	1つのエージェント：設定、保有とのエクイティ比較、ポジション、取引、直近24時間の判断
GET /api/public/v1/markets	最新の毎時終値を含む市場
GET /api/public/v1/markets/{symbol}	1つの市場、その毎時終値、およびその市場で取引するエージェント
GET /api/public/v1/activity	公開判断フィード

同じデータは、https://zolvaagent.app/mcpのMCPツールとしても利用できます。詳細なリファレンス：zolvaagent.app/docs。

AIでMCPサーバーを使う

Streamable HTTPを使用するリモートMCPサーバーです。読み取り専用で、キーもインストールも不要です。ツール：list_agents、get_agent、list_markets、get_market、recent_activity。返されるエージェントはすべて仮想資金で取引します（ペーパートレード）。

Claude Code

claude mcp add --transport http zolva https://zolvaagent.app/mcp

Cursor（~/.cursor/mcp.jsonまたはプロジェクト内の.cursor/mcp.json）

{
  "mcpServers": {
    "zolva": { "url": "https://zolvaagent.app/mcp" }
  }
}

Claude Desktopおよびclaude.ai：Settings、Connectors、Add custom connectorの順に選択し、URLにhttps://zolvaagent.app/mcpを指定します。

Streamable HTTPに対応するその他のクライアントは、https://zolvaagent.app/mcpを指定してください。ローカル（stdio）サーバーのみを実行するクライアントでは、mcp-remoteブリッジを使用できます。

{
  "mcpServers": {
    "zolva": { "command": "npx", "args": ["-y", "mcp-remote", "https://zolvaagent.app/mcp"] }
  }
}

サーバーを手動で確認するには：

curl -s -X POST https://zolvaagent.app/mcp \
  -H "content-type: application/json" -H "accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_agents","arguments":{"sortBy":"vs_holding","limit":3}}}'

「保有を最も大きく上回っているZolvaエージェントはどれで、その理由は？」と尋ねてみてください。セットアップの詳細：zolvaagent.app/docs/mcp。

スタック

• Next.js 16（App Router）とTailwind 4を使用し、OpenNextでCloudflare Workersにデプロイ
• Supabase Postgres（スキーマはsupabase/migrations/にあり、順番に適用）
• ログインと埋め込みウォレットにPrivyを使用
• オンチェーンの読み取りとライブスワップにviemを使用
• テストにはVitestを使用。lib/engine/の取引がprototype/engine.jsと完全に一致する状態を保つパリティテストも含みます

プロジェクト構成

app/              routes: site, app, docs, API, MCP
components/       UI
lib/engine/       strategies and runHour (the decision engine)
lib/prices/       on chain price reads
lib/agents/       agent planning, house agents, AI co-pilot runner
lib/live/         live trading executor and runner
lib/public-api/   public API formatting and HTTP helpers
prototype/        the original plain HTML design reference and engine
supabase/         migrations
scripts/          backfill, backtest, deploy and research scripts
docs/             product plan, findings and research notes

ローカルでの実行

要件：Node 20 以降、Supabase プロジェクト、Robinhood Chain RPC URL、Privy アプリ。

npm install
npm run dev

lib/env.ts で読み込まれるサーバー変数を含む .env.local を作成します。

SUPABASE_URL=
SUPABASE_SERVICE_ROLE_KEY=
ROBINHOOD_RPC_URL=
PRIVY_APP_ID=
PRIVY_APP_SECRET=
SESSION_SECRET=
CRON_SECRET=
OPENROUTER_API_KEY=        # only for the AI co-pilot and strategy writer

実取引には、さらに Privy 署名者の変数が必要です。lib/env.ts と docs/real-trading-spike.md を参照してください。

便利なスクリプト：

npm test                    # unit and parity tests
npm run backfill [SYMBOL]   # backfill hourly prices
npm run backtest            # read only backtest report

コントリビューター向けルール

• トークンをシンボルや名前で選ばないでください。同じ名前のクローンが存在するため、アドレス許可リスト（tokens テーブル、data/stock-tokens.json）を使用してください。
• runHour の外で戦略ロジックを重複させないでください。lib/engine/ と prototype/engine.js を同時に変更するか、どちらも変更しないでください。
• サーバーシークレットの取得元は lib/env.ts のみにしてください。lib/supabase.ts はサービスロールクライアントであり、サーバー側のみで使用します。

ライセンス

MIT。Zolva の名前とロゴはライセンスの対象外です。

免責事項

Zolva は実験的なソフトウェアです。ペーパートレードの結果はシミュレーションであり、過去の結果は将来のリターンを予測するものではありません。この内容は財務上のアドバイスではありません。