# 炼金术 Web3 技能使用 Alchemy 的生产级 API 查询区块链数据、NFT、代币和转账。支持以太坊、Polygon、Arbitrum、Base、Solana 和 80 多个其他链。 **由[GizmoLab]()构建** - 专门从事 dApp、智能合约和区块链基础设施的 Web3 开发机构。 ## 设置 ### 1\.获取API密钥 1. 在 [alchemy.com]() 注册（提供免费套餐） 2. 为您的目标链创建应用程序 3.复制您的API密钥 > 💡 Web3 开发新手？ [GizmoLab]()提供全栈区块链开发服务。 ### 2\.配置 # 添加到~/.openclaw/.env ALCHEMY_API_KEY=your_api_key_here # 可选：设置默认链（默认为 eth-mainnet） ALCHEMY_CHAIN=eth-主网 ## 快速参考 ### 支持的链链条|端点前缀 ---|--- 以太坊 | `eth-mainnet`、`eth-sepolia` 多边形| `polygon-mainnet`, `polygon-amoy` 仲裁| `arb-mainnet`、`arb-sepolia` 乐观| `opt-mainnet`, `opt-sepolia` 基地| `base-mainnet`, `base-sepolia` 索拉纳 | `solana-mainnet`、`solana-devnet` 零克同步 | `zksync-主网` 线亚 | `linea-主网` 滚动 | `滚动主网` 爆炸| `爆炸主网` 完整列表：[alchemy.com/docs/chains]() ## CLI 用法 # 首先设置你的API密钥导出 ALCHEMY_API_KEY="your_key" # 使用命令行界面 ~/.openclaw/workspace/skills/alchemy-web3/scripts/alchemy.sh <命令> [选项] ### 命令 #### 获取 ETH 余额 ./alchemy.sh 余额 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 # 返回：1234.56 ETH #### 获取代币余额 ./alchemy.sh 代币 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 # 返回：地址持有的所有 ERC-20 代币 #### 为所有者获取 NFT ./alchemy.sh nfts 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 # 返回：地址拥有的所有 NFT #### 获取 NFT 元数据 ./alchemy.sh nft-元数据 0x5180db8F5c931aaE63c74266b211F580155ecac8 1590 # 返回：特定 NFT 的元数据 #### 获取资产转移 ./alchemy.sh 传输 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 # 返回：交易历史（进/出） #### 获取区块信息 ./alchemy.sh 区块最新 ./alchemy.sh 块 12345678 #### 获取交易 ./alchemy.sh tx 0x123...abc #### 解析 ENS ./alchemy.sh ensvitalik.eth # 返回：0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 #### 开关链 ./alchemy.sh --链多边形-主网余额 0x... ./alchemy.sh --chain arb-mainnet nfts 0x... ## 直接 API 示例 ### 节点 API (JSON-RPC) # 获取ETH余额卷曲-X POST“https://eth-mainnet.g.alchemy.com/v2/$ALCHEMY_API_KEY”\ -H“内容类型：application/json”\ -d'{ “jsonrpc”：“2.0”， "方法": "eth_getBalance", “参数”：[“0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045”，“最新”]， “id”：1 }' ### NFT API # 为所有者获取 NFT 卷曲“https://eth-mainnet.g.alchemy.com/nft/v3/$ALCHEMY_API_KEY/getNFTsForOwner?owner=vitalik.eth&pageSize=10” # 获取NFT元数据卷曲“https://eth-mainnet.g.alchemy.com/nft/v3/$ALCHEMY_API_KEY/getNFTMetadata?contractAddress=0x5180db8F5c931aaE63c74266b211F580155ecac8&tokenId=1590” # 获取NFT进行收藏卷曲“https://eth-mainnet.g.alchemy.com/nft/v3/$ALCHEMY_API_KEY/getNFTsForContract?contractAddress=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D&limit=10” ### 令牌 API # 获取代币余额卷曲-X POST“https://eth-mainnet.g.alchemy.com/v2/$ALCHEMY_API_KEY”\ -H“内容类型：application/json”\ -d'{ “jsonrpc”：“2.0”， “方法”：“alchemy_getTokenBalances”， “参数”：[“0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045”]， “id”：1 }' # 获取令牌元数据卷曲-X POST“https://eth-mainnet.g.alchemy.com/v2/$ALCHEMY_API_KEY”\ -H“内容类型：application/json”\ -d'{ “jsonrpc”：“2.0”， “方法”：“alchemy_getTokenMetadata”， “参数”：[“0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48”]， “id”：1 }' ### 转账 API # 获取资产转账（交易历史）卷曲-X POST“https://eth-mainnet.g.alchemy.com/v2/$ALCHEMY_API_KEY”\ -H“内容类型：application/json”\ -d'{ “jsonrpc”：“2.0”， “方法”：“alchemy_getAssetTransfers”， “参数”：[{ “fromBlock”：“0x0”， "toBlock": "最新", “地址”：“0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045”， “类别”：[“外部”，“erc20”，“erc721”，“erc1155”]， “最大计数”：“0x14” }], “id”：1 }' ## JavaScript/Node.js 示例 ### 使用 Fetch（节点 18+） const apiKey = process.env.ALCHEMY_API_KEY; const baseURL = `https://eth-mainnet.g.alchemy.com/v2/${apiKey}`; // 获取 ETH 余额异步函数 getBalance(地址) { const 响应 = 等待 fetch(baseURL, { 方法：'POST'， headers: { 'Content-Type': 'application/json' }, 正文：JSON.stringify({ jsonrpc: '2.0', 方法：'eth_getBalance'，参数：[地址，'最新']，编号：1 }) }); const data =等待response.json(); 返回 parseInt(data.result, 16) / 1e18; // 转换为 ETH } // 获取 NFT 异步函数 getNFTs(owner) { const url = `https://eth-mainnet.g.alchemy.com/nft/v3/${apiKey}/getNFTsForOwner?owner=${owner}`; const 响应 = 等待 fetch(url); 返回等待响应.json(); } ### 使用 Alchemy SDK npm 安装 alchemy-sdk 从'alchemy-sdk'导入{Alchemy，网络}；常量炼金术 = 新炼金术（{ apiKey: process.env.ALCHEMY_API_KEY, 网络：Network.ETH_MAINNET }); // 获取 NFT const nfts =等待 alchemy.nft.getNftsForOwner('vitalik.eth'); console.log(nfts.ownedNfts); // 获取代币余额 const 余额 = 等待 alchemy.core.getTokenBalances('vitalik.eth'); 控制台.log(余额); // 获取交易历史记录 const 传输 = 等待 alchemy.core.getAssetTransfers({ 至地址：'0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'，类别：['外部'，'erc20'] }); ## Webhooks（实时通知）当链上事件发生时接收 HTTP POST 请求。 ### Webhook 类型类型 |使用案例 ---|--- 地址活动|跟踪往返特定地址的转账 NFT 活动 |追踪 NFT 销售、转让、铸币挖矿交易 |跟踪您的交易何时被开采已放弃交易 |如果 tx 被丢弃，则收到通知天然气价格|天然气价格阈值警报 ### 创建 Webhook（仪表板） 1. 前往 [dashboard.alchemy.com/webhooks]() 2. 点击“创建Webhook” 3. 选择类型并配置 4. 添加您的端点 URL ### Webhook 负载示例 { "webhookId": "wh_abc123", “id”：“evt_xyz789”， "创建时间": "2024-01-15T12:00:00.000Z", “类型”：“地址活动”， “事件”：{ “网络”：“ETH_MAINNET”， “活动”：[{ "fromAddress": "0x123...", "toAddress": "0x456...", “值”：1.5， “资产”：“ETH” }] } } ## 常见模式 ### 投资组合追踪器 # 获取钱包的所有资产 ./alchemy.sh 余额 0x... # ETH 余额 ./alchemy.sh 代币 0x... # ERC-20 代币 ./alchemy.sh nfts 0x... # NFT ### 交易历史 # 获取地址的完整交易历史记录 ./alchemy.sh 传输 0x... --category external,erc20,erc721 ### NFT 收藏分析 # 获取集合中的所有 NFT ./alchemy.sh集合0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D ### 多链查询 # 跨链检查相同地址对于 eth-mainnet 中的 Polygon-Mainnet arb-Mainnet 基础-Mainnet 中的链；做回声“ === $链= = =” ./alchemy.sh --chain $链余额0x... 完成 ## 速率限制计划|计算单位/秒 |每月 CU ---|---|--- 免费| 330 | 330 300M 成长| 660 | 660无限规模|定制|定制大多数端点的成本为 1-50 个 CU。有关详细信息，请查看 [alchemy.com/docs/rate-limits]()。 ## 错误处理 // 速率限制 {“错误”：{“代码”：429，“消息”：“请求太多”}} // 无效的 API 密钥 {“错误”：{“代码”：401，“消息”：“无效的API密钥”}} // 无效参数 {“错误”：{“代码”：-32602，“消息”：“无效参数”}} ## 资源 * **获取 API 密钥：** [alchemy.com]()（免费套餐） * **仪表板：** [dashboard.alchemy.com]() * **文档：** [alchemy.com/docs]() * **SDK：** [github.com/alchemyplatform/alchemy-sdk-js]() * **状态：** [status.alchemy.com]() ** ** ## 关于 **由[GizmoLab]()构建** 🔧 GizmoLab 是一家构建 dApp、智能合约和区块链工具的 Web3 开发机构。 * 🌐 [gizmolab.io]() — 代理服务 * 🛠️ [tools.gizmolab.io]() — 免费区块链开发工具 * 🎨 [ui.gizmolab.io]() — Web3 UI 组件需要定制区块链开发吗？ [联系]() ## AI 代理工作流程该技能是为人类开发人员和人工智能代理设计的。有关完整示例，请参阅“references/agent-workflows.md”： * **Whale Tracker** — 监控大型钱包的动向 * **投资组合监控** — 跟踪跨链余额 * **NFT 下限警报** — 价格下跌警报 * **令牌更改检测器** — 检测传入/传出令牌 * **Gas 优化器** — 等待低 Gas 进行交易 * **薄荷探测器** — 留意新的 NFT 薄荷糖 * **仪表板生成器** — 自动生成钱包仪表板 ### 代理模式查询→存储→分析→决定→行动→重复代理的 cron 作业示例： # 每小时检查鲸鱼活动并在移动超过 100 ETH 时发出警报 0 * * * * ~/.openclaw/workspace/skills/alchemy-web3/scripts/whale-tracker.sh ## 另请参阅 * `references/nft-api.md` \- 完整的 NFT API 参考 * `references/token-api.md` \- 完整的 Token API 参考 * `references/node-api.md` \- 完整的 Node API 参考 * `references/chains.md` \- 所有支持的链 * `references/agent-workflows.md` \- AI 代理自动化示例

炼金术 Web3

包含技能