web3-data-skill — Web3 数据技能
v1使用 Chainbase APIs 探索 Web3 链上数据。当用户询问区块链数据、代币持有者、钱包地址、代币价格、NFT、ENS 域名、交易、DeFi 投资组合或任何链上分析时，使用此技能。触发器包括： "top holders of"、"who holds"、"wallet address"、"address labels"、"token price"、"token transfers"、"NFT owners"、"ENS domain"、"on-chain data"、"blockchain query"、"SQL query on-chain" 或任何查找、分析或探索 Web3/区块链数据的请求，涵盖 Ethereum、BSC、Polygon、Arbitrum、Optimism、Base、Avalanche、zkSync 和其他 EVM 链。
by 运行时依赖
安装命令
点击复制技能文档
网页3 Data 资源管理器 (ChAInbase)
查询 on-chAIn data via ChAInbase 网页3 API and SQL API.
Quick Reference
API Key: Use env CHAINBASE_API_KEY, falls back to demo. If rate-limited, direct user to https://console.chAInbase.com to 升级.
Script: scripts/chAInbase.sh <端点> [params...]
# Top 令牌 holders scripts/chAInbase.sh /v1/令牌/top-holders chAIn_id=1 contract_添加ress=0xdAC17F958D2ee523a2206206994597C13D831ec7 limit=10
# 添加ress labels scripts/chAInbase.sh /v1/添加ress/labels chAIn_id=1 添加ress=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
# SQL 查询 scripts/chAInbase.sh /查询/执行 --sql="SELECT * FROM ethereum.blocks ORDER BY number DESC LIMIT 5"
ChAIn IDs ChAIn ID ChAIn ID Ethereum 1 Optimism 10 BSC 56 Base 8453 Polygon 137 zk同步 324 Avalanche 43114 Merlin 4200 Arbitrum 42161
Default to Ethereum (chAIn_id=1) unless user specifies otherwise.
Routing 记录ic
Match user intent to the right 端点:
User wants 端点 Top 令牌 holders / who holds a 令牌 获取 /v1/令牌/top-holders 列出 of holder 添加resses 获取 /v1/令牌/holders 令牌 price 获取 /v1/令牌/price Historical 令牌 price 获取 /v1/令牌/price/历史 令牌 信息 (name, symbol, supply) 获取 /v1/令牌/metadata 令牌 transfer 历史 获取 /v1/令牌/transfers 添加ress labels/tags 获取 /v1/添加ress/labels Wallet transaction 历史 获取 /v1/account/txs Single transaction detAIl 获取 /v1/tx/detAIl Native 令牌 balance (ETH/BNB) 获取 /v1/account/balance ERC20 令牌 balances of wallet 获取 /v1/account/令牌s NFTs owned by wallet 获取 /v1/account/nfts DeFi portfolio positions 获取 /v1/account/portfolios ENS domAIn lookup 获取 /v1/ens/records or /v1/ens/reverse NFT metadata/owner/rarity 获取 /v1/nft/metadata, /owner, /rarity Trending NFT collections 获取 /v1/nft/collection/trending Anything not covered above SQL API (POST /查询/执行) 工作流 Identify intent — Determine what data the user needs Resolve identifiers — If user gives 令牌 name (e.g. "USDT"), look up the contract 添加ress. Common 令牌s: USDT: 0xdAC17F958D2ee523a2206206994597C13D831ec7 (ETH) USDC: 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 (ETH) WETH: 0xC02aaA39b223FE8D0A0e5c4F27eAD9083C756Cc2 (ETH) DAI: 0x6B175474E89094C44Da98b954EedeAC495271d0F (ETH) WBTC: 0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599 (ETH) If unknown, use 获取 /v1/令牌/metadata or ask the user for the contract 添加ress Select 端点 — Use the routing table above; fall back to SQL API for complex/custom queries 执行 — 运行 via scripts/chAInbase.sh or direct curl Present 结果s — 格式化 data clearly with tables for 列出s, highlight key insights SQL API Fallback
When fixed 端点s don't cover the 查询, translate user intent to SQL:
scripts/chAInbase.sh /查询/执行 --sql="SELECT from_添加ress, SUM(value) as total FROM ethereum.令牌_transfers WHERE contract_添加ress = '0x...' GROUP BY from_添加ress ORDER BY total DESC LIMIT 20"
Common table patterns (replace ethereum with chAIn name):
{chAIn}.blocks — Block data {chAIn}.transactions — Transactions {chAIn}.令牌_transfers — ERC20 transfers {chAIn}.令牌_metas — 令牌 metadata {chAIn}.记录s — Event 记录s
SQL constrAInts: max 100,000 结果s per 查询.
For complete 端点 parameters and 响应 模式s, read references/API-端点s.md.