预测市场交易协议

@阿尔法街机/mcp

MCP（模型上下文协议）服务器 阿尔法商场 Algorand的预测市场。

让人工智能代理（Claude、Cursor、Copilot等）浏览市场，获取完整的API支持订单簿，下订单，管理头寸，并交易链上预测市场。

SDK vs MCP vs CLI

• SDK(@alpha-arcade/sdk)：用于机器人、后端和应用程序的低级TypeScript原语。
• MCP(@alpha-arcade/mcp)：为AI代理提供与MCP工具相同的功能。
• CLI(@alpha-arcade/cli)：人机终端用户体验 table/json 输出、提示和 --dry-run/--yes 安全护栏。

CLI和MCP都使用相同的运行时/客户端设置逻辑，因此行为保持一致。

Alpha CLI（终端）

CLI包位于 alpha-cli/ 在此仓库中，可以独立发布为 @alpha-arcade/cli.

快速入门

cd alpha-cli
npm install
npm run build
node dist/index.js markets list --limit 5

常用命令

# Read-only
node dist/index.js markets list --limit 5
node dist/index.js markets get <marketId>
node dist/index.js orderbook <marketAppId>
node dist/index.js positions --wallet-address <addr>

# Trading (requires ALPHA_MNEMONIC)
node dist/index.js trade limit --market <id> --position yes --side buy --price 0.52 --quantity 10
node dist/index.js trade market --market <id> --position no --side buy --price 0.45 --quantity 20 --slippage 0.05
node dist/index.js orders amend --market <id> --escrow-app-id <escrow> --price 0.60 --quantity 3
node dist/index.js orders cancel --market <id> --escrow-app-id <escrow> --order-owner <addr>

CLI安全模型

• 默认情况下，写入命令提示确认。
• --dry-run 无需提交即可打印有效载荷（和市场订单匹配估计）。
• --yes 绕过非交互式自动化的提示。
• 价格验证强制执行 (0,1) 美元和上限的滑点异常高。

工具

get_full_orderbook

从Alpha REST API获取市场ID的完整处理订单簿快照。需要 ALPHA_API_KEY.

• 市场ID （必填）：Alpha市场ID（UUID），不是 marketAppId

返回与websocket相同的应用程序密钥快照形状 orderbook_changed.orderbook:

• 顶级聚合 bids, asks，以及 spread
• 详细的 yes 和 no 买入/卖出订单 escrowAppId 和 owner

组合询价

任意AND/OR组合购买的竞争性报价(request_combo_rfq / place_combo_rfq).

• 需要 ALPHA_API_KEY. place_combo_rfq 还要求 ALPHA_MNEMONIC.
• tree: { groups: [{ op: "AND"|"OR", legs: [...] }], connectors: ["AND"|"OR", ...] }
• AA腿： { source: "aa", marketId, selection: "yes"|"no" }
• SGP支腿： { source: "sgp", graderId, sgp, league?, eventId? }
• grossStakeMicro：小额USDC的确切借记股份
• 报价可能包括 unsignedUserTxns 当钱包地址已知时
• 外部制造商拒绝/超时需要新的报价（同一签名腿上没有复赛）

*已标记的API-关键工具 No* 仍需 ALPHA_API_KEY.

资源

WebSocket流工具

这 stream_* 工具连接到Alpha Arcade WebSocket API(wss://platform-wss.alphaarcade.com)实时数据。不需要API密钥。每个工具都会打开一个连接，收集数据，然后关闭——不需要管理持久订阅。

stream_orderbook

获取市场的实时订单簿快照。比链上更快 get_orderbook 工具（~5s vs ~10s）。返回与相同的完整处理快照形状 get_full_orderbook，包括出价、询问、分散和每方是/否详细信息。

• 鼻涕虫 （必填）：市场的URL友好名称（例如。 "will-btc-hit-100k")
• 超时毫秒数 （可选）：最大等待时间（毫秒）（默认值：15000）

stream_live_markets

收集一段时间内市场概率的变化。返回所有累积的变化，包括市场ID、概率补丁和点差/中点更新。有助于了解哪些市场目前处于活跃状态。

• 持续时间毫秒 （可选）：收集事件的时间（毫秒）（默认值：5000）

stream_market

通过slug观察单个市场，并返回第一个变化事件。如果没有任何变化，则超时。

• 鼻涕虫 （必填）：市场的URL友好名称
• 超时毫秒数 （可选）：最大等待时间（毫秒）（默认值：15000）

stream_wallet_orders

监视钱包中的订单更改（新订单、更新订单或已完成订单），并返回第一个事件。使用已配置的 ALPHA_MNEMONIC 如果没有提供地址，请使用钱包。

• 墙地址 （可选）：Algorand钱包地址
• 超时毫秒数 （可选）：最大等待时间（毫秒）（默认值：15000）

设置

环境变量

获取API密钥

API密钥是 optional没有它，你仍然可以在链上获取市场、下订单和使用大多数SDK功能。使用API密钥，您可以获得更丰富的市场数据、完整的API支持订单簿、流动性奖励信息、钱包订单查找等。

获取API密钥：

1. 首选 alphaarcade.com 和 注册 使用您的电子邮件或谷歌帐户。
2. 打开 账户 页
3. 打开 伙伴 选项卡。
4. 点击 创建API密钥 并复制密钥。
5. 将其添加到您的环境中（例如 .env 项目根目录中的文件）：

光标（只读，零配置）

添加到您的 .cursor/mcp.json （项目层面）或 ~/.cursor/mcp.json （全球）：

{
  "mcpServers": {
    "alpha-arcade": {
      "command": "npx",
      "args": ["-y", "@alpha-arcade/mcp"]
    }
  }
}

就是这样--不需要API密钥。你的人工智能可以浏览市场、查看订单簿和检查头寸。

光标（带交易）

要启用交易，请添加您的助记符：

{
  "mcpServers": {
    "alpha-arcade": {
      "command": "npx",
      "args": ["-y", "@alpha-arcade/mcp"],
      "env": {
        "ALPHA_MNEMONIC": "your twenty five word mnemonic here"
      }
    }
  }
}

克劳德桌面/克劳德代码

相同的配置对两者都有效 Claude 桌面版 （GUI应用程序）和 Claude 代码 （终端CLI）。

增添 ~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上（或 %APPDATA%\Claude\claude_desktop_config.json 在Windows上）：

{
  "mcpServers": {
    "alpha-arcade": {
      "command": "npx",
      "args": ["-y", "@alpha-arcade/mcp"],
      "env": {
        "ALPHA_MNEMONIC": "your twenty five word mnemonic here"
      }
    }
  }
}

对于 Claude 代码 具体来说，您还可以通过CLI添加它：

claude mcp add alpha-arcade -- npx -y @alpha-arcade/mcp

VS代码/副本

增添 .vscode/mcp.json:

{
  "servers": {
    "alpha-arcade": {
      "command": "npx",
      "args": ["-y", "@alpha-arcade/mcp"],
      "env": {
        "ALPHA_MNEMONIC": "your twenty five word mnemonic here"
      }
    }
  }
}

零配置模式

服务器在完全没有环境变量的情况下工作 只读模式.市场直接从Algorand区块链中发现，不需要API密钥。您可以浏览市场、查看订单簿和查看头寸。交易工具将返回一个错误，说明需要助记符。

价格和数量单位

所有价格和数量均使用 微型单位 （1000000=1.00美元或1股）：

• 价格 500000 = $0.50
• 数量 1000000 =1股
• 滑点 50000 = $0.05

链接

• SDK： npmjs.com/package/@alpha街机/sdk
• github： github/phara23/alpha-mcp
• 阿尔法街机： alphaarcade.com
• Alpha Arcade API： platform.alphaarcade.com