Zolva

Zolva

展示交易依据的交易 Agent。
zolvaagent.app · 文档 · @zolva_agent

---

Zolva 让任何人都能为 Robinhood Chain 上的代币化美股、ETH 和 BTC 构建无代码交易 Agent。每小时，每个 Agent 都会读取最新的链上价格，决定买入、卖出或持有，并在每项决策旁记录原因。

• 人人都能进行模拟交易。 选择市场和策略（动量、均值回归、抄底，或自定义规则），进行回测，然后让它运行。
• 每项决策都有记录。 买入、卖出、持有和亏损都会公开显示在排行榜和活动动态中。
• AI 副驾驶，设有明确限制。 可选的大模型可以否决规则信号，但不会决定交易规模，也不会跳过止损。
• 开放数据。 只读公共 API 和 MCP 服务会公开 Agent、市场和活动信息。
• 实盘交易（目前仅限所有者）。 同一套引擎可以使用真实钱包运行，并通过硬性上限控制在 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. 记录。 每个 Agent 每小时的决策、交易、持仓和权益都会通过一个数据库函数写入 Postgres。

公共 API 和 MCP

只读，无需密钥，但有速率限制。

端点	返回内容
GET /api/public/v1/agents	带业绩数据的公共 Agent
GET /api/public/v1/agents/{id}	单个 Agent：设置、权益与持有对比、持仓、交易及过去 24 小时的决策
GET /api/public/v1/markets	包含最新小时收盘价的市场
GET /api/public/v1/markets/{symbol}	单个市场、其小时收盘价以及交易该市场的 Agent
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。它返回的每个 Agent 都使用虚拟资金交易（模拟交易）。

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 Agent 的表现比持有策略好得最多？原因是什么？”更多设置详情请见：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

创建 .env.local，其中包含 lib/env.ts 读取的服务器变量：

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 是实验性软件。模拟交易结果仅为模拟结果，过往结果并不能预测未来收益。本文内容不构成任何财务建议。