assymetrix

Assymetrix Agent 工具

来自 Assymetrix 数据 API 的 Polymarket、Kalshi 和 Limitless 预测市场数据，供 AI Agent 使用：

• @assymetrix/mcp-server：包含三个只读工具的 MCP 服务，位于 packages/mcp-server。
• prediction-market-data：一个 Agent Skill，教会 Agent 使用 curl 调用同一 API，位于 skills/prediction-market-data。
• Claude Code 插件，将两者打包在一起（.claude-plugin/）。

这里的所有功能都只会读取市场数据。不会下单、转移资金或关联钱包，也不构成任何金融建议。你需要使用自己的 Assymetrix API 密钥，免费密钥也可使用。

获取 API 密钥

1. 在 https://dashboard.assymetrix.com/signup?utm_source=github&utm_campaign=agent-tools 创建免费账户。
2. 打开 API Keys 并创建密钥。密钥只会显示一次，且以 asy_ 开头。
3. 将其保存在环境变量中，例如添加到 shell 配置文件：export ASSYMETRIX_API_KEY=asy_...

免费计划包含每 30 天滚动周期内 10,000 次请求、每秒 1 次请求以及 30 天的历史数据。每次工具调用计为 1 次请求。付费计划：https://dashboard.assymetrix.com/billing

安装

推荐：Claude Code 插件（MCP 服务和 Skill）

/plugin marketplace add assymetrix/assymetrix-agent-tools
/plugin install assymetrix@assymetrix

启用插件时，Claude Code 会询问你的 API 密钥，并将其保存在系统的安全存储中，因此密钥不会存放在配置文件或聊天记录中。

其他客户端

这些客户端会从环境变量或各自的配置文件中读取密钥。请将密钥保存在 shell 配置文件中（export ASSYMETRIX_API_KEY=asy_...），而不要将其输入命令。

未使用插件的 Claude Code（--transport 放在名称前）：

claude mcp add --env ASSYMETRIX_API_KEY="$ASSYMETRIX_API_KEY" --transport stdio assymetrix -- npx -y @assymetrix/mcp-server

Codex：

codex mcp add assymetrix --env ASSYMETRIX_API_KEY="$ASSYMETRIX_API_KEY" -- npx -y @assymetrix/mcp-server

Cursor（~/.cursor/mcp.json 或 .cursor/mcp.json）：

{
  "mcpServers": {
    "assymetrix": {
      "command": "npx",
      "args": ["-y", "@assymetrix/mcp-server"],
      "env": { "ASSYMETRIX_API_KEY": "${env:ASSYMETRIX_API_KEY}" }
    }
  }
}

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "assymetrix": {
      "command": "npx",
      "args": ["-y", "@assymetrix/mcp-server"],
      "env": { "ASSYMETRIX_API_KEY": "asy_..." }
    }
  }
}

VS Code（.vscode/mcp.json，会提示输入密钥并将其隐藏）：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "assymetrix-key",
      "description": "Assymetrix API key",
      "password": true
    }
  ],
  "servers": {
    "assymetrix": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@assymetrix/mcp-server"],
      "env": { "ASSYMETRIX_API_KEY": "${input:assymetrix-key}" }
    }
  }
}

仅安装 Skill（Claude Code、Codex、Cursor 和其他 Agent）

npx skills add assymetrix/assymetrix-agent-tools

Skill 会从 Agent 的环境中读取 ASSYMETRIX_API_KEY，且不会打印该密钥。

工具

工具	返回内容
search_markets	问题中包含指定文本的市场，按 24 小时成交量排序：id、交易平台、最新价格、最佳买价和卖价、结束日期。
get_market_prices	某个市场的当前赔率：最新价格、买价、卖价、价差、价格变化、每个结果的价格、成交量和流动性。
get_market_history	指定时间范围内的 OHLCV 蜡烛图（自动选择合适的时间间隔），或该市场的交易记录，按时间从新到旧排列。

价格是 0 到 1 之间的概率。历史数据的可查询范围取决于你的计划；如果计划限制了时间范围，结果中会说明。

配置

变量	默认值	含义
ASSYMETRIX_API_KEY	none	你的 API 密钥。未设置时，服务仍会启动并说明如何获取密钥。
ASSYMETRIX_API_BASE_URL	https://api.assymetrix.com/api/v1	仅用于测试。必须使用 https（localhost 除外，此时可使用普通 http）。
ASSYMETRIX_TIMEOUT_MS	15000	单次 API 请求的超时时间，范围为 1000 至 60000。
ASSYMETRIX_LOG_LEVEL	warn	error、warn、info 或 debug。日志输出到 stderr。

隐私

• MCP 服务只与 Assymetrix Data API 通信，在 x-api-key 标头中发送你的密钥、包含其版本的 User-Agent，以及一个随机请求 ID，支持人员可用它查找调用记录。
• 它不会收集遥测数据、不会向磁盘写入任何内容，也绝不会记录或返回你的密钥。
• 该技能会在你的设备上使用 curl 调用同一个 API。
• 隐私政策：https://www.assymetrix.com/privacy-policy。支持邮箱：[email protected]。

开发

cd packages/mcp-server
pnpm install
pnpm run check      # type check, build, then the tests (no network)
node ../../skills/validate-skill.cjs ../../skills/prediction-market-data            # skill format checks
node ../../skills/validate-skill.cjs ../../skills/prediction-market-data --release  # also fails on open TODO markers

许可证

MIT