核心用法
Graph Advocate 定位为"区块链数据的自然语言网关"，用户以 plain English 提问，系统自动路由至最优数据源并返回实时数据。核心架构分为三层：
1. 智能路由层
- 意图识别引擎匹配 15,500+ The Graph subgraph、Token API（EVM/Solana/TON）、专用 MCP 服务器
- 关键词触发：subgraph、TVL、swap、Polymarket、Hyperliquid、x402 等
- 双服务协同：跨协议查询时自动合并结果
2. 数据源矩阵
| 服务 | 场景 | 成本 |
|------|------|------|
| subgraph-registry | 查找协议专用 subgraph | 免费 |
| token-api | 代币余额、NFT、Polymarket 市场/OHLCV/仓位 | 免费+付费 |
| graph-aave-mcp | Aave V2/V3/V4 清算、利率（40 工具） | 免费 |
| graph-polymarket-mcp | 订单簿深度、争议市场、交易者胜率/回撤（31 工具） | 免费 |
| /hyperliquid/* | 交易者评分、金库评估、顶级交易员筛选 | $0.02-0.10 |
| /predmarket/spread | Polymarket ↔ Limitless 跨平台价差套利 | $0.05 |
| /kalshi-polymarket/spread | Kalshi ↔ Polymarket 跨源套利 | $0.05 |
| /ask | 132M+ x402 结算数据的自然语言查询 | $0.05 |
3. 付费机制（x402 协议）
- 完全 opt-in：默认零钱包运行，付费端点返回 402 挑战后才可能扣款
- 每调用前置 402 响应预览输出样例（
output_example），用户可检视后决定 - 推荐配置：交互式逐笔确认（
confirmBeforePay）+ 专用低余额钱包 + 运行时花费上限
显著优点
数据覆盖广度：聚合 The Graph 全生态（15,500+ subgraph）+ 多链 Token API + 预测市场三平台（Polymarket/Limitless/Kalshi）+ Hyperliquid 衍生品数据，单一入口替代多站点查询。
实时性与专业性：直接对接 The Graph 网关与协议专用 MCP，Polymarket/Hyperliquid 等场景提供订单簿深度、交易者胜率、回撤等专业指标，非聚合站点的表层数据。
付费灵活性：免费层完全可用（3 次/天基础路由 + 大量免费 subgraph 查询），高级功能按需付费，无订阅绑架。x402 标准实现链上结算可追溯。
无本地攻击面：纯云端指令式服务，零代码下载、零本地文件访问、零凭证索取，隔离了传统 MCP 的供应链攻击风险。
潜在局限与风险
付费端点的资金安全：虽为 opt-in，但若用户配置自动接受 402 挑战且无花费上限，存在意外扣款风险。必须严格遵循官方建议的"低余额钱包+逐笔确认+运行时上限"三重防护。
数据来源单一性：所有查询经 graphadvocate.com（Railway 托管，@paulieb14 运营）代理，形成中心化信任点。虽 The Graph 网络本身去中心化，但路由服务的可用性与诚实性依赖运营方。
预测市场数据的监管敏感：Polymarket/Kalshi 等平台受地域监管限制，跨平台套利数据可能涉及合规灰色地带，用户需自行评估司法辖区风险。
查询隐私：钱包地址、交易意图等元数据发送至第三方服务器，虽无私钥风险，但存在行为画像可能。
价格与响应时间：高级端点（如 /ask 的 NL→SQL）依赖 LLM 推理，可能产生延迟与解析误差；付费定价（$0.05/次）高频调用下成本累积显著。
适合人群
- DeFi 研究员/分析师：需要跨协议 TVL、清算、利率对比的专业数据
- 预测市场做市商/套利者：依赖跨平台价差（Polymarket/Limitless/Kalshi）的量化策略
- Hyperliquid 生态参与者：评估交易者技能、金库绩效、筛选顶级地址
- AI Agent 开发者：构建链上数据感知 Agent，需标准化 A2A JSON-RPC 接口
- x402 生态探索者：体验无摩擦链上微支付与支付数据分析
常规风险
| 类别 | 风险 | 缓解措施 |
|------|------|---------|
| 资金 | 误配置自动付款导致超额消费 | 专用低余额钱包 + 逐笔确认 + `maxTotalSpend` |
| 信任 | 路由服务端点故障或数据篡改 | 交叉验证关键数据；关注链上结算收据 |
| 合规 | 预测市场数据使用的司法风险 | 自行评估所在地法规；避免敏感策略明文查询 |
| 可用性 | 免费配额耗尽或付费网络拥堵 | 预检 `/quota` 端点；备援数据源 |
| 隐私 | 查询模式被第三方记录 | 避免关联敏感地址批量查询 |