Install
openclaw skills install @thcjp/graph-query-tool-pro功能说明: 本技能涵盖 中文交互、化工作流场景 等核心能力。
链上数据查询（专业版）
概述
专业版在免费版本地路由能力之上，扩展了付费端点、高级 工具、支出控制三大能力，覆盖专业交易员与企业级数据采集场景。配套 402 挑战预览、按次审批、收据与链上结算凭证，让"按需付费、成本可控"成为链上数据查询的默认体验。支持跨场内价差、地址解析、自然语言 SQL 等高价值端点.
核心能力
| 能力 | 说明 | 免费版 | 专业版 |
|---|---|---|---|
| 自然语言路由 | 自动匹配意图到服务 | 是 | 是 |
| 积分余额查询 | EVM/Solana/TON 钱包数据 | 是 | 是 |
| 子图检索 | 15500+ 子图搜索 | 是 | 是 |
| 免费层配额 | 每日 3 次免费 | 是 | 是 |
| 付费端点 | 跨场内价差、地址解析、NL SQL | 否 | 是 |
| 高级 工具 | 订单簿、争议、胜率/回撤 | 否 | 是 |
| 支出控制 | 余额检查、预算熔断、重试 | 否 | 是 |
| 402 挑战预览 | 付款前预览输出样例 | 否 | 是 |
| 按次审批 | 每次付费前 y/N 确认 | 否 | 是 |
| 付费收据 | 链上结算凭证 | 否 | 是 |
| 自定义路由 | 策略配置与批量查询 | 否 | 是 |
| 自主模式安全 | 探测模式与停止条件 | 否 | 是 |
核心功能执行
用input_params参数进行配置.
处理: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回核心功能执行的响应数据,包含状态码、结果和日志.
- 执行此能力时使用
input_params参数,支持创建/查询/导出操作
参数配置与调用
用config_options参数进行配置.
处理: 解析参数配置与调用的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回参数配置与调用的响应数据,包含状态码、结果和日志.
- 执行此能力时使用
config_options参数,支持修改/重置/导入操作
结果处理与输出
用output_format参数进行配置.
处理: 解析结果处理与输出的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回结果处理与输出的响应数据,包含状态码、结果和日志.
- 执行此能力时使用
output_format参数,支持导出/保存/转换操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：全功能链上数据查、含付费端点、收据与批量分析、Use、when、需要数据分析、报表生成、统计洞察、数据可视化时使用、不适用于实时流数、据处理、适用于独立开发者、企业团队和自动化、工作流场景等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.
使用场景
场景 1：跨场内预测市场套利监控
专业交易员监控 Polymarket 与 Limitless 同主题市场的价差，付费端点返回每对市场的 yes-mid 价差（bps）与套利方向。专业版的跨场内 JOIN 能力单场内透传无法实现，配合支出控制确保单次任务成本可控.
场景 2：链上代理信誉评估
企业采购链上代理服务前，调用 /agent/score 付费端点获取 0-100 信誉分，综合 ERC-8004 注册、USDC 结算速度与链上反馈注册表。返回包含 SHA-256 + preimage + 规范化 JCS 字符串，验证者可无回调重新派生字节精确结果.
场景 3：专业交易员深度分析
Hyperliquid 永续合约交易员调用付费端点评估交易员技能分、金库表现、清算记录。配合胜率/回撤/利润因子等高级 工具，构建交易员画像，辅助跟单决策.
场景 4：企业级链上数据批量采集
数据团队批量调用地址解析端点，获取 x402 Base 子图上的地址生命周期统计（付款人/收款人角色）、近期 10 笔双向支付、facilitator 元数据与索引区块高度。配合预算熔断避免超支.
快速开始
上手时间：< 120 秒。专业版支持付费端点，建议先配置支出控制再启用自主模式.
Step 1：查询免费配额
GET https://graph-query.example/quota?sender=0x配置值
返回当日剩余免费查询次数与下一调用是否付费.
Step 2：付费端点 402 预览
每个付费端点的 402 响应体含 output_example 字段，预览付款后将收到的数据结构。检查形状是否符合需求，不符合则放弃付费.
HTTP/1.1 402 Payment Required
X-Payment: { "amount": "0.01", "currency": "USDC", "network": "base",
"recipient": "0x...", "challenge": "<nonce>" }
Step 3：按次审批（推荐）
配置运行时将 402 挑战呈现给用户，每次付费前 y/N 确认。适用于持有非小额余额的钱包.
Step 4：自主模式前配置支出控制
自主模式前必须配置：(1) 专用低余额钱包；(2) 单次上限与总预算；(3) 停止条件（次数上限/时间上限/余额下限）；(4) 首次探测模式.
示例
付费端点定价
| 端点 | 价格 | 用途 |
|---|---|---|
/route | 3 次免费/天，超出 $0.01 USDC | 基础路由 |
/polymarket/* | $0.01 - $0.05/次 | Polymarket 高级查询 |
/hyperliquid/* | $0.02 - $0.10/次 | Hyperliquid 永续分析 |
/predmarket/spread | $0.05 USDC | Polymarket ↔ Limitless 跨场价差 |
/kalshi-polymarket/spread | $0.05 USDC | Kalshi ↔ Polymarket 跨源价差 |
/kalshi/consensus-trend | $0.05 USDC | Kalshi 共识趋势 |
/kalshi/sports-live-edge | $0.05 USDC | Kalshi 体育实时边缘 |
/ask | $0.05 USDC | x402 支付分析自然语言问答 |
/onchain-x402/address | $0.01 USDC | x402 链上地址查询 |
/agent/score | $0.02 USDC | 代理信誉评分 |
支出控制配置
| 配置项 | 说明 | 示例 |
|---|---|---|
maxAmountPerCall | 单次付费上限 | 0.05 USDC |
maxTotalSpend | 总预算上限 | 5 USDC |
max_calls_per_run | 单任务次数上限 | 5 |
| 时间上限 | 任务超时中止 | 5 分钟 |
| 余额下限 | 钱包余额低于阈值中止 | 1 USDC |
confirmBeforePay | 按次审批开关 | true（推荐） |
意图路由表（含付费）
| 意图 | 服务 | 是否付费 |
|---|---|---|
| 积分余额、持仓、NFT | token-api | 免费层 |
| 协议子图检索 | subgraph-registry | 免费层 |
| Aave 借贷高级 | graph-aave 工具 | 免费层 |
| Polymarket 订单簿、争议、胜率 | graph-polymarket 工具 | 免费层 |
| Hyperliquid 技能分、金库、清算 | /hyperliquid/* | 付费 |
| 跨场内价差 | /predmarket/spread | 付费 |
| 跨源价差（Kalshi ↔ Polymarket） | /kalshi-polymarket/spread | 付费 |
| x402 支付分析自然语言 | /ask | 付费 |
| x402 链上地址查询 | /onchain-x402/address | 付费 |
| 代理信誉评分 | /agent/score | 付费 |
优选实践
- 免费层优先：先消耗每日 3 次免费路由，再启用付费端点，降低成本.
- 402 预览必看：每次付费前检查
output_example，避免为不符合需求的数据付费. - 按次审批推荐：持有非小额余额的钱包务必启用
confirmBeforePay，每次付费前 y/N 确认. - 专用低余额钱包：自主模式前仅注入愿意承担损失的余额（如 $5 USDC），绝不连接资金库钱包.
- 停止条件必备：自主模式至少配置一个停止条件（次数上限/时间上限/余额下限），避免失控.
- 首次探测模式：首次执行作为探测，记录每次调用与支出，确认成本符合预期后再启用自主模式.
- 收据必须记录：每次付费返回
x-payment-response头，记录链上结算凭证，便于审计. - 无结算不收费：若调用未返回结算头却扣款，属于异常，应反馈处理.
- 缓存复用降本：返回结果含
cache_for_seconds，相同查询在缓存期内复用，避免重复付费. - 预算熔断兜底：
maxTotalSpend超限时自动熔断并返回已获取的部分结果，避免超支.
常见问题
Q1：付费端点返回 402 但我不确定是否值得付费？
A：检查 402 响应体的 output_example 字段，预览付款后的数据结构。若不符合需求，直接放弃，不产生费用.
Q2：自主模式下如何避免失控支出？
A：必须配置：(1) 专用低余额钱包；(2) maxAmountPerCall 与 maxTotalSpend；(3) 至少一个停止条件；(4) 首次探测模式记录支出.
Q3：收据 x-payment-response 头如何使用？
A：记录该头的链上结算凭证，用于审计与对账。若调用扣款但无该头，属于异常，应反馈处理.
Q4：哪些端点永不收费？
A：/.well-known/agent-card.json、/agents/capabilities.json、/mcp/catalog、/llms.txt、/dashboard、/chat、/quota、GET / 永不触发付费.
Q5：跨场内价差为何单场内透传无法返回？
A：跨场内 JOIN 需要同时关联两个场内的数据，单场内透传只能访问单一数据源，结构上无法返回跨场结果。必须使用 /predmarket/spread 专用端点.
Q6：代理信誉评分如何验证？
A：/agent/score 返回包含 SHA-256 + preimage + 规范化 JCS 字符串，验证者可无回调重新派生字节精确结果，无需回查服务.
Q7：Polymarket 路由规则？
A：常见查询（市场、OHLCV、活动、持仓、P&L、平台统计）优先用 token-api；高级查询（订单簿深度、价差、争议市场、UMA 解决、胜率/回撤、CTF 拆分合并）路由到 graph-polymarket 工具.
Q8：请求跨两个服务怎么办？
A：Skill 会同时调用两个服务并合并结果。如"Hyperliquid 原始市场数据 + 派生技能分"，前者走 token-api，后者走 /hyperliquid/* 付费端点.
Q9：如何审计每日支出？
A：定时轮询 /quota 端点，记录每日每发送者的免费配额使用与付费调用次数，结合收据汇总支出.
Q10：专业版是否支持自定义路由策略？
A：支持。通过配置文件指定优先服务、付费阈值、缓存策略，适合批量采集与自动化分析场景.
错误处理
| 错误场景(现象) | 可能原因 | 解决步骤 | 优先级 |
|---|---|---|---|
| 402 反复出现 | 免费配额耗尽 | 升级付费或次日执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令 | P2 |
| 付费后无收据头 | 链上结算未完成 | 反馈处理，无结算不收费 | P1 |
| 路由置信度低 | 提问不具体 | 补充链名、协议名、地址 | P2 |
| 自主模式失控 | 未配置停止条件 | 立即停止，配置支出控制后重启 | P1 |
| 跨场价差为空 | 两场无同主题市场 | 换主题或检查市场命名 | P3 |
| 地址解析无结果 | 地址无 x402 活动 | 确认地址参与过 x402 支付 | P3 |
| 钱包余额不足 | 注入余额过低 | 补充低余额钱包余额 | P1 |
| 缓存不命中 | 缓存过期 / 参数不一致 | 检查 cache_for_seconds 与参数 | P3 |
专业版特性
本专业版相比免费版新增以下能力：
- 付费端点全集：跨场内价差、跨源价差、地址解析、自然语言 SQL、代理信誉评分
- 高级 工具：订单簿深度、争议市场、胜率/回撤/利润因子统计
- 支出控制：单次上限、总预算、停止条件、首次探测模式
- 402 挑战预览：付款前预览输出样例，避免无效付费
- 按次审批：每次付费前 y/N 确认，适合非小额余额钱包
- 付费收据：链上结算凭证，支持审计与对账
- 自定义路由策略：优先服务、付费阈值、缓存策略配置
- 自主模式安全：专用低余额钱包与必备停止条件
定价
| 版本 | 价格 | 功能 | 适用场景 |
|---|---|---|---|
| 免费体验版 | ¥0 | 免费层路由 + 基础查询 + 配额查询 | 个人试用 |
| 收费专业版 | ¥49.9/月 | 全功能 + 付费端点 + 高级 工具 + 支出控制 + 优先支持 | 专业交易 / 企业 |
专业版通过 SkillHub SkillPay 发布.
依赖说明
运行环境
- Agent 平台：支持 SKILL.md 的任意 AI Agent（Claude Code / Cursor / Codex / Gemini CLI 等）
- 操作系统：Windows / macOS / Linux
- 网络：需访问链上数据服务端点与 x402 支付网络（Base 主网）
依赖详情
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由 Agent 平台内置 LLM 提供 |
| 链上数据服务 | 外部 API | 必需 | 路由服务与子图网关，免费层无需 Key |
| x402 支付运行时 | 运行时 | 付费端点必需 | 支持 x402 协议的 Agent 运行时，用于接受 402 挑战 |
| USDC（Base） | 加密货币 | 付费端点必需 | Base 主网 USDC，用于付费端点结算 |
| Python 标准库 | 运行时 | 必需 | Python 自带（urllib / json） |
| requests（可选） | Python 包 | 可选 | pip install requests，用于更稳定的 HTTP 请求 |
API Key 配置
- 免费层：无需 API Key
- 付费端点：通过 x402 协议自动结算，无需额外 API Key；需配置支持 x402 的 Agent 运行时
- 钱包密钥：存储于系统密钥管理工具或硬件钱包，禁止硬编码于 SKILL.md 或脚本
- 禁止：在 SKILL.md 或脚本中硬编码密钥、助记词或资金库钱包凭证
可用性分类
- 分类：MD+EXEC（纯 Markdown 指令，部分功能需要 exec 命令行执行能力）
- 说明：基于 Markdown 的 AI Skill，通过自然语言指令驱动 Agent 执行任务，支持付费端点与支出控制
已知限制
- 需LLM支持,无LLM环境不可用
- 复杂业务场景建议结合人工经验判断
- 执行效率受模型能力与网络环境影响
输出格式
{
"success": true,
"data": {
"result": "链上数据查询(专业版)处理结果",
"execution_time": "0.5s",
"metadata": {
"version": "1.0",
"processor": "graph query pro"
}
},
"execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
"error": null
}
安全注意事项
| 风险类型 | 防范措施 |
|---|---|
| API密钥泄露 | 通过环境变量配置，禁止硬编码到代码或配置文件中 |
| 命令执行风险 | 仅执行白名单命令，避免拼接用户输入到命令行参数中 |
| 网络通信安全 | 使用HTTPS协议，验证SSL证书有效性 |
| 敏感数据暴露 | 输出结果中不包含密钥、令牌等敏感信息 |
使用前请确认已阅读依赖说明章节，确保运行环境满足安全要求。
效率量化分析
| 操作场景 | 手动耗时 | 自动化耗时 | 效率提升 |
|---|---|---|---|
| 文件解析与提取 | 5-10分钟/个 | <5秒/个 | 60-120x |
| 批量文件处理(100个) | 8-16小时 | <5分钟 | 96-192x |
| API调用与响应解析 | 2-3分钟/次 | <1秒/次 | 120-180x |
| 多接口数据聚合 | 15-30分钟 | <10秒 | 90-180x |
| 命令执行与结果收集 | 3-5分钟/次 | <2秒/次 | 90-150x |
| 重复任务批量执行 | 因任务而异 | 线性缩减 | 5-50x |
| 错误排查与修复 | 10-30分钟 | <30秒 | 20-60x |
差异化对比
| 对比维度 | 链上数据查询(专业版) | 传统手动方式 | 通用脚本工具 |
|---|---|---|---|
| 自动化程度 | 全流程自动 | 完全手动 | 部分自动 |
| 错误处理 | 内置错误恢复 | 依赖人工经验 | 基本try-catch |
| 可复用性 | 参数化配置 | 一次性脚本 | 模板化 |
| 安全合规 | 内置安全检查 | 无安全保障 | 无安全保障 |
| 适用场景 | 全功能链上数据查询，含付费端点、高级 工具、支出控制、收据与批量分析。。全功能链 | 通用场景 | 通用场景 |
Related skills
- Downloads
- Security audit
- Review
- Last updated
- 2w ago
- Current version
- v1.0.1
- License
- MIT-0