面向代理开放

GADUIN 提供一个 Model Context Protocol 服务器，让 LLM 代理与交易机器人代表你查看实时市场、持仓与余额。

什么是 MCP？

Model Context Protocol 是一个连接 LLM 客户端与外部数据和工具的开放标准。GADUIN 提供一个 MCP 端点，任何兼容 MCP 的客户端 —— Claude Desktop、Claude.ai、自定义代理 —— 都可以使用用户签发的 API 密钥连接。每次调用都会被认证，并仅限于签发该密钥的用户。

可用工具

v1 工具目录为只读。每个工具都会自行发布输入 schema，LLM 客户端会自动接入 —— 无需手写 JSON。

list_markets
列出关于真实运输结果（航班延误、列车取消、海运瓶颈通过量）的当前开放预测市场。可选输入：category（FLIGHT、TRAIN、SHIP）、status（默认 OPEN）、limit（1–100）。返回市场 id、类别、问题、含当前价格的结果、累计成交量与关闭时间。
get_market
根据 id 获取单个市场，包含当前价格与结果。输入：id（市场 UUID）。
get_my_positions
列出已认证用户在所有市场中的未平仓位。无输入。返回 market_id、outcome_idx、持有份额与总成本基础。
get_balance
返回已认证用户当前的美元余额（以字符串形式）。无输入。

目前交易仅限 REST

交易、充值与提现暂未通过 MCP 开放 —— MCP 驱动的交易比读取动作影响面更大，我们希望在 UX 验证完成前继续保持人工参与。可使用按权限范围签发的 API 密钥通过 REST API 进行程序化交易。

连接客户端

1.注册并完成账户验证。
2.在账户设置中生成 API 密钥 —— MCP 使用 read 权限即可。
3.将下方代码片段粘贴到兼容 MCP 的客户端中，并替换为你的密钥。

端点

https://gaduin.com/mcp

Authorization

Bearer YOUR_API_KEY

Claude Desktop 配置

{
  "mcpServers": {
    "gaduin": {
      "url": "https://gaduin.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

在 macOS 上粘贴到 ~/Library/Application Support/Claude/claude_desktop_config.json，替换为你的 API 密钥，然后重启 Claude。

Endpoint reference

想直接对接？下方是 Model Context Protocol 端点以及匿名只读 REST API——提供与网站和 MCP 服务器完全相同的市场、订单簿与价格。

MCP endpoint

https://gaduin.com/mcp

REST read API (base URL)

https://gaduin.com/api/v1

GET /markets
列出开放中的市场。可按类别（FLIGHT、TRAIN、SHIP）与状态筛选，并通过 limit 和 cursor 分页浏览结果。
GET /markets/{id}
按 id 获取单个市场，包含其结算规则与证据。
GET /markets/{id}/book
某个市场的订单簿快照。
GET /markets/{id}/trades
某个市场的近期成交。
GET /markets/{id}/price-history
某个市场的历史价格快照。
GET /markets/positions
所有市场的实时汇总持仓。
GET /markets/config
交易限额——单笔交易的最小与最大金额。
GET /healthz
Liveness probe.

机器可读的发现机制

代理无需抓取本页面。上述每项能力都在站点根目录提供的标准化文档中有所描述，因此支持 MCP 或 OpenAPI 的客户端可以自行发现市场、API 以及认证方式。

/.well-known/mcp/server-card.json
MCP Server Card（SEP-1649）——Model Context Protocol 端点、其传输方式以及认证方法。
/.well-known/openapi.json
匿名只读 REST API 的 OpenAPI 3.1 描述。
/.well-known/api-catalog
API Catalog（RFC 9727）——将所有机器可读接口串联起来的链接集。
/.well-known/oauth-protected-resource
OAuth 2.0 受保护资源元数据（RFC 9728）——说明由哪个授权服务器签发 API 令牌，以及这些令牌所带的作用域。
/.well-known/oauth-authorization-server
OAuth 2.0 授权服务器元数据（RFC 8414）——签发方、令牌端点，以及以 API 密钥换取令牌的授权方式。
/.well-known/agent-skills/index.json
Agent Skills 索引——代理可获取的 SKILL.md 指南，用于了解如何使用本平台，每份均以摘要值（digest）锁定。
/api/md
通过内容协商获取任意公开页面的 Markdown 渲染版本（请求时发送 Accept: text/markdown）。
/auth.md
面向人类与代理的操作说明，讲解如何完成认证并生成带作用域的 API 密钥。

开始使用管理 API 密钥