SuperAPI AI 工具集

bitquery-graphql-skill

通用与其它

查看项目

更新于 10-16 08:48

技能介绍

用途:该技能让智能体通过 uxc 执行 Bitquery GraphQL API 操作,覆盖链上 DEX 交易、转账、代币余额与持有者分析、区块与交易、内存池实时活动及市场/交易视图等。

主要能力:提供 query/EVM、query/Solana、query/Trading、query/Tron 及对应的 subscription/* 根操作。订阅会自动协商 graphql-transport-ws 与 graphql-ws 兼容配置。

前置条件:uxc 已安装并在 PATH 中;可访问 https://streaming.bitquery.io/graphql;拥有 Bitquery 应用的 client_id 与 client_secret。

认证:使用 bearer 访问令牌,推荐 OAuth client_credentials 流程。登录命令:uxc auth oauth login bitquery-graphql --endpoint https://streaming.bitquery.io/graphql --flow client_credentials --client-id <client_id> --client-secret <client_secret> --scope api --token-endpoint https://oauth2.bitquery.io/oauth2/token。随后绑定端点:uxc auth binding add --id bitquery-graphql --host streaming.bitquery.io --path-prefix /graphql --scheme https --credential bitquery-graphql --priority 100。

使用方式:默认使用固定命令 bitquery-graphql-cli,缺失时用 uxc link bitquery-graphql-cli https://streaming.bitquery.io/graphql 创建。用 -h 查看根操作与参数,以位置 JSON 加显式 _select 执行,例如:bitquery-graphql-cli query/EVM '{"network":"base","dataset":"combined","_select":"DEXTrades(limit: {count: 1}) { Transaction { Hash } }"}'。订阅需提供 _select,建议从 subscription/EVM 开始。

限制:首次查询应保持 _select 精简并加显式过滤;订阅若立即返回 GraphQL 错误,多为查询形状问题而非传输失败;自动化应解析 JSON 输出中的 ok、kind、protocol、data、error 等稳定字段,不要依赖 --text;不要将临时 IDE 令牌写入长期文档。