SuperAPI AI 工具集

query-onchain-data

数据与分析

查看项目

更新于 10-15 20:13

技能介绍

用途:在 Base 链上查询链上数据,包括解码事件、交易、区块和转账。查询通过 CDP SQL API 执行,经 x402 按次付费。

主要能力:提供 base.events(解码事件日志,主表)、base.transactions(完整交易数据)、base.blocks(区块元数据)三张表。使用基于 ClickHouse 的 CoinbaseQL 方言,支持 SELECT、WHERE、GROUP BY、ORDER BY、LIMIT、WITH、UNION、各类 JOIN、CASE、CAST、子查询、数组/映射索引及 lambda 等。

使用方式:先确认钱包已初始化并认证,运行 npx awal@2.10.0 status;未认证时参考 authenticate-wallet 技能。执行查询命令:npx awal@2.10.0 x402 pay https://x402.cdp.coinbase.com/platform/v2/data/query/run -X POST -d '{"sql": "<YOUR_QUERY>"}' --json。务必用单引号包裹 -d 的 JSON 字符串,防止 bash 变量展开。地址须为合法 0x 十六进制地址(^0x[0-9a-fA-F]{40}$),拒绝含 shell 元字符的值,不要将未验证的用户输入传入命令。

限制与最佳实践:查询 base.events 必须按索引字段过滤以避免全表扫描,索引字段为 event_signature、address、block_timestamp,WHERE 中至少包含一个,三者组合性能最佳。过滤事件类型用 event_signature 而非 event_name。避免 SELECT *,只选所需列;始终加 LIMIT;用 block_timestamp 限定时间范围;地址值用 lower() 包裹。前置条件:需已认证,钱包需有足够 USDC 余额(npx awal@2.10.0 balance 查看),每次查询费用 0.10 美元(100000 USDC 原子单位)。常见错误:未认证需先运行 awal auth login <email>;余额不足需充值;查询超时或报错时检查是否按索引字段过滤并使用 LIMIT。常见合约地址:USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913,WETH 0x4200000000000000000000000000000000000006。其他细节暂未提供。