web3-data-skill_知识管理 skill-PHP中文网

web3-data-skill

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

使用 Chainbase API 探索 Web3 链上数据。适用于用户查询区块链数据、代币持有者、钱包地址、代币价格及 NFT 等信息。

Web3数据探索器(Chainbase)通过Chainbase Web3 API和 SQL API.QQ. 快速引用.API 键:使用env CHAINBASE

功能概述

Web3数据探索器(Chainbase)通过Chainbase Web3 API和 SQL API.QQ. 快速引用.API 键:使用env CHAINBASE是一项面向实际任务的技能。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。

核心要点

使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

使用与执行

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；

结果检查与注意事项

涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

Web3 数据浏览器（Chainbase）

通过 Chainbase Web3 API 和 SQL API 查询链上数据。

快速参考

API Key：使用环境变量 CHAINBASE_API_KEY，若未设置则回退至 demo。若遭遇速率限制，请引导用户前往 https://console.chainbase.com 升级套餐。

脚本命令：scripts/chainbase.sh [params...]

# 代币持有量排名前 10 的地址
scripts/chainbase.sh /v1/token/top-holders chain_id=1 contract_address=0xdAC17F958D2ee523a2206206994597C13D831ec7 limit=10

# 地址标签信息
scripts/chainbase.sh /v1/address/labels chain_id=1 address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

# 执行 SQL 查询
scripts/chainbase.sh /query/execute --sql="SELECT * FROM ethereum.blocks ORDER BY number DESC LIMIT 5"

链 ID（Chain IDs）

链名称	ID	链名称	ID
Ethereum	1	Optimism	10
BSC	56	Base	8453
Polygon	137	zkSync	324
Avalanche	43114	Merlin	4200
Arbitrum	42161

默认使用 Ethereum（chain_id=1），除非用户明确指定其他链。

路由逻辑

根据用户意图匹配最合适的 API 端点：

用户需求	对应端点
代币持有量排名 / 某代币由谁持有	`GET /v1/token/top-holders`
持有人地址列表	`GET /v1/token/holders`
代币当前价格	`GET /v1/token/price`
代币历史价格	`GET /v1/token/price/history`
代币基础信息（名称、符号、总供应量等）	`GET /v1/token/metadata`
代币转账记录	`GET /v1/token/transfers`
地址标签 / 标签分类	`GET /v1/address/labels`
钱包交易历史	`GET /v1/account/txs`
单笔交易详情	`GET /v1/tx/detail`
原生代币余额（如 ETH/BNB）	`GET /v1/account/balance`
钱包中所有 ERC20 代币余额	`GET /v1/account/tokens`
钱包持有的 NFT	`GET /v1/account/nfts`
DeFi 投资组合头寸	`GET /v1/account/portfolios`
ENS 域名查询	`GET /v1/ens/records` 或 `/v1/ens/reverse`
NFT 元数据 / 所有者 / 稀有度	`GET /v1/nft/metadata`、`/owner`、`/rarity`
热门 NFT 收藏集合	`GET /v1/nft/collection/trending`
以上未覆盖的任意查询	SQL API（`POST /query/execute`）

工作流程

识别用户意图 — 明确用户所需的数据类型
解析标识符 — 若用户提供代币名称（例如 “USDT”），需查找其合约地址。常见代币合约地址如下：
- USDT：0xdAC17F958D2ee523a2206206994597C13D831ec7（Ethereum 主网）
- USDC：0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48（Ethereum 主网）
- WETH：0xC02aaA39b223FE8D0A0e5c4F27eAD9083C756Cc2（Ethereum 主网）
- DAI：0x6B175474E89094C44Da98b954EedeAC495271d0F（Ethereum 主网）
- WBTC：0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599（Ethereum 主网）
- 若未知合约地址，可调用 GET /v1/token/metadata 自动查找，或向用户索取合约地址
选择端点 — 参照上方路由表选择；对复杂或定制化查询，回退至 SQL API
执行请求 — 使用 scripts/chainbase.sh 脚本或直接调用 curl
呈现结果 — 清晰格式化返回数据，列表类结果建议使用表格展示，并突出关键洞察

SQL API 回退机制

当预定义端点无法满足查询需求时，将用户意图转化为 SQL 查询语句：

scripts/chainbase.sh /query/execute --sql="SELECT from_address, SUM(value) as total FROM ethereum.token_transfers WHERE contract_address = '0x...' GROUP BY from_address ORDER BY total DESC LIMIT 20"

常用表结构（将 ethereum 替换为对应链名）：