Alchemy Web3技能：区块链数据查询API，支持以太坊、Polygon、Solana等80+链

alchemy-web3 by 0xgizmolab/alchemy-web3-skill

19 周安装量

GitHub

安装命令

npx skills add https://github.com/0xgizmolab/alchemy-web3-skill --skill alchemy-web3

🇨🇳中文介绍

Alchemy Web3 技能

使用 Alchemy 的生产级 API 查询区块链数据、NFT、代币和转账。支持以太坊、Polygon、Arbitrum、Base、Solana 以及 80 多个其他链。

由 GizmoLab 构建 — 专注于 dApp、智能合约和区块链基础设施的 Web3 开发机构。

设置

1. 获取 API 密钥

在 alchemy.com 注册（提供免费套餐）
为目标链创建一个应用
复制您的 API 密钥

💡 刚接触 Web3 开发？GizmoLab 提供全栈区块链开发服务。

2. 配置

# 添加到 ~/.openclaw/.env
ALCHEMY_API_KEY=your_api_key_here

# 可选：设置默认链（默认为 eth-mainnet）
ALCHEMY_CHAIN=eth-mainnet

快速参考

支持的链

链	端点前缀
Ethereum	`eth-mainnet`, `eth-sepolia`
Polygon	`polygon-mainnet`, `polygon-amoy`
Arbitrum	`arb-mainnet`, `arb-sepolia`
Optimism	`opt-mainnet`, `opt-sepolia`

完整列表：alchemy.com/docs/chains

CLI 使用

# 首先设置您的 API 密钥
export ALCHEMY_API_KEY="your_key"

# 使用 CLI
~/.openclaw/workspace/skills/alchemy-web3/scripts/alchemy.sh <命令> [选项]

命令

获取 ETH 余额

./alchemy.sh balance 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
# 返回：1234.56 ETH

获取代币余额

./alchemy.sh tokens 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
# 返回：地址持有的所有 ERC-20 代币

获取所有者持有的 NFT

./alchemy.sh nfts 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
# 返回：地址拥有的所有 NFT

获取 NFT 元数据

./alchemy.sh nft-metadata 0x5180db8F5c931aaE63c74266b211F580155ecac8 1590
# 返回：特定 NFT 的元数据

获取资产转账记录

./alchemy.sh transfers 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
# 返回：交易历史记录（转入/转出）

获取区块信息

./alchemy.sh block latest
./alchemy.sh block 12345678

获取交易信息

./alchemy.sh tx 0x123...abc

解析 ENS

./alchemy.sh ens vitalik.eth
# 返回：0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

切换链

./alchemy.sh --chain polygon-mainnet balance 0x...
./alchemy.sh --chain arb-mainnet nfts 0x...

直接 API 示例

Node API (JSON-RPC)

# 获取 ETH 余额
curl -X POST "https://eth-mainnet.g.alchemy.com/v2/$ALCHEMY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBalance",
    "params": ["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "latest"],
    "id": 1
  }'

NFT API

# 获取所有者持有的 NFT
curl "https://eth-mainnet.g.alchemy.com/nft/v3/$ALCHEMY_API_KEY/getNFTsForOwner?owner=vitalik.eth&pageSize=10"

# 获取 NFT 元数据
curl "https://eth-mainnet.g.alchemy.com/nft/v3/$ALCHEMY_API_KEY/getNFTMetadata?contractAddress=0x5180db8F5c931aaE63c74266b211F580155ecac8&tokenId=1590"

# 获取集合中的 NFT
curl "https://eth-mainnet.g.alchemy.com/nft/v3/$ALCHEMY_API_KEY/getNFTsForContract?contractAddress=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D&limit=10"

Token API

# 获取代币余额
curl -X POST "https://eth-mainnet.g.alchemy.com/v2/$ALCHEMY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "alchemy_getTokenBalances",
    "params": ["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"],
    "id": 1
  }'

# 获取代币元数据
curl -X POST "https://eth-mainnet.g.alchemy.com/v2/$ALCHEMY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "alchemy_getTokenMetadata",
    "params": ["0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"],
    "id": 1
  }'

转账 API

# 获取资产转账记录（交易历史）
curl -X POST "https://eth-mainnet.g.alchemy.com/v2/$ALCHEMY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "alchemy_getAssetTransfers",
    "params": [{
      "fromBlock": "0x0",
      "toBlock": "latest",
      "toAddress": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "category": ["external", "erc20", "erc721", "erc1155"],
      "maxCount": "0x14"
    }],
    "id": 1
  }'

JavaScript/Node.js 示例

使用 Fetch (Node 18+)

const apiKey = process.env.ALCHEMY_API_KEY;
const baseURL = `https://eth-mainnet.g.alchemy.com/v2/${apiKey}`;

// 获取 ETH 余额
async function getBalance(address) {
  const response = await fetch(baseURL, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      method: 'eth_getBalance',
      params: [address, 'latest'],
      id: 1
    })
  });
  const data = await response.json();
  return parseInt(data.result, 16) / 1e18; // 转换为 ETH
}

// 获取 NFT
async function getNFTs(owner) {
  const url = `https://eth-mainnet.g.alchemy.com/nft/v3/${apiKey}/getNFTsForOwner?owner=${owner}`;
  const response = await fetch(url);
  return await response.json();
}

使用 Alchemy SDK

npm install alchemy-sdk



import { Alchemy, Network } from 'alchemy-sdk';

const alchemy = new Alchemy({
  apiKey: process.env.ALCHEMY_API_KEY,
  network: Network.ETH_MAINNET
});

// 获取 NFT
const nfts = await alchemy.nft.getNftsForOwner('vitalik.eth');
console.log(nfts.ownedNfts);

// 获取代币余额
const balances = await alchemy.core.getTokenBalances('vitalik.eth');
console.log(balances);

// 获取交易历史
const transfers = await alchemy.core.getAssetTransfers({
  toAddress: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045',
  category: ['external', 'erc20']
});

Webhooks（实时通知）

当链上事件发生时接收 HTTP POST 请求。

Webhook 类型

类型	使用场景
地址活动	跟踪特定地址的转入/转出
NFT 活动	跟踪 NFT 销售、转账、铸造
已挖出交易	跟踪您的交易何时被挖出
已丢弃交易	如果交易被丢弃则收到通知
Gas 价格	在 Gas 价格达到阈值时提醒

创建 Webhook（仪表板）

访问 dashboard.alchemy.com/webhooks
点击 "创建 Webhook"
选择类型并进行配置
添加您的端点 URL

Webhook 负载示例

{
  "webhookId": "wh_abc123",
  "id": "evt_xyz789",
  "createdAt": "2024-01-15T12:00:00.000Z",
  "type": "ADDRESS_ACTIVITY",
  "event": {
    "network": "ETH_MAINNET",
    "activity": [{
      "fromAddress": "0x123...",
      "toAddress": "0x456...",
      "value": 1.5,
      "asset": "ETH"
    }]
  }
}

常见模式

投资组合跟踪器

# 获取钱包的所有资产
./alchemy.sh balance 0x...      # ETH 余额
./alchemy.sh tokens 0x...       # ERC-20 代币
./alchemy.sh nfts 0x...         # NFT

交易历史记录

# 获取地址的完整交易历史
./alchemy.sh transfers 0x... --category external,erc20,erc721

NFT 集合分析

# 获取集合中的所有 NFT
./alchemy.sh collection 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D

多链查询

# 跨链检查同一地址
for chain in eth-mainnet polygon-mainnet arb-mainnet base-mainnet; do
  echo "=== $chain ==="
  ./alchemy.sh --chain $chain balance 0x...
done

速率限制

套餐	计算单元/秒	月度计算单元
免费	330	300M
增长	660	无限制
规模	自定义	自定义

大多数端点消耗 1-50 个计算单元。详情请查看 alchemy.com/docs/rate-limits。

错误处理

// 超出速率限制
{"error": {"code": 429, "message": "Too Many Requests"}}

// 无效的 API 密钥
{"error": {"code": 401, "message": "Invalid API Key"}}

// 无效的参数
{"error": {"code": -32602, "message": "Invalid params"}}

资源

获取 API 密钥： alchemy.com（免费套餐）
仪表板： dashboard.alchemy.com
文档： alchemy.com/docs
SDK： github.com/alchemyplatform/alchemy-sdk-js
状态： status.alchemy.com

关于

由 GizmoLab 构建 🔧

GizmoLab 是一家 Web3 开发机构，致力于构建 dApp、智能合约和区块链工具。

🌐 gizmolab.io — 机构服务
🛠️ tools.gizmolab.io — 免费区块链开发工具
🎨 ui.gizmolab.io — Web3 UI 组件

需要定制区块链开发？联系我们

AI 智能体工作流

此技能专为人类开发者和 AI 智能体设计。完整示例请参见 references/agent-workflows.md：

巨鲸追踪器 — 监控大额钱包的动向
投资组合监控器 — 跨链跟踪余额
NFT 底价警报 — 价格下跌时发出警报
代币变动检测器 — 检测转入/转出的代币
Gas 优化器 — 等待低 Gas 时进行交易
铸造检测器 — 监视新的 NFT 铸造
仪表板生成器 — 自动生成钱包仪表板

智能体模式

查询 → 存储 → 分析 → 决策 → 行动 → 重复

智能体的示例定时任务：

# 每小时检查一次巨鲸活动，如果移动超过 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 智能体自动化示例

每周安装量

仓库

0xgizmolab/alch…b3-skill

首次出现

2026年2月15日

安全审计

Gen Agent Trust HubFail SocketPass SnykWarn

安装于

cursor11

opencode11

gemini-cli9

amp9

claude-code9

github-copilot9

🇺🇸English

Alchemy Web3 Skill

Query blockchain data, NFTs, tokens, and transfers using Alchemy's production-grade APIs. Supports Ethereum, Polygon, Arbitrum, Base, Solana, and 80+ other chains.

Built byGizmoLab — Web3 development agency specializing in dApps, smart contracts, and blockchain infrastructure.

Setup

1. Get API Key

Sign up at alchemy.com (free tier available)
Create an app for your target chain
Copy your API key

💡 New to Web3 development? GizmoLab offers full-stack blockchain development services.

2. Configure

# Add to ~/.openclaw/.env
ALCHEMY_API_KEY=your_api_key_here

# Optional: Set default chain (defaults to eth-mainnet)
ALCHEMY_CHAIN=eth-mainnet

Quick Reference

Supported Chains

Chain	Endpoint Prefix

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

JavaScript/Node.js Examples

Using Fetch (Node 18+)

const apiKey = process.env.ALCHEMY_API_KEY;
const baseURL = `https://eth-mainnet.g.alchemy.com/v2/${apiKey}`;

// Get ETH Balance
async function getBalance(address) {
  const response = await fetch(baseURL, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      method: 'eth_getBalance',
      params: [address, 'latest'],
      id: 1
    })
  });
  const data = await response.json();
  return parseInt(data.result, 16) / 1e18; // Convert to ETH
}

// Get NFTs
async function getNFTs(owner) {
  const url = `https://eth-mainnet.g.alchemy.com/nft/v3/${apiKey}/getNFTsForOwner?owner=${owner}`;
  const response = await fetch(url);
  return await response.json();
}

npm install alchemy-sdk



import { Alchemy, Network } from 'alchemy-sdk';

const alchemy = new Alchemy({
  apiKey: process.env.ALCHEMY_API_KEY,
  network: Network.ETH_MAINNET
});

// Get NFTs
const nfts = await alchemy.nft.getNftsForOwner('vitalik.eth');
console.log(nfts.ownedNfts);

// Get token balances
const balances = await alchemy.core.getTokenBalances('vitalik.eth');
console.log(balances);

// Get transaction history
const transfers = await alchemy.core.getAssetTransfers({
  toAddress: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045',
  category: ['external', 'erc20']
});

Webhooks (Real-time Notifications)

Receive HTTP POST requests when onchain events happen.

Type	Use Case
Address Activity	Track transfers to/from specific addresses
NFT Activity	Track NFT sales, transfers, mints
Mined Transactions	Track when your txs are mined
Dropped Transactions	Get notified if tx is dropped
Gas Price	Alert on gas price thresholds

Create Webhook (Dashboard)

Go to dashboard.alchemy.com/webhooks
Click "Create Webhook"
Select type and configure
Add your endpoint URL

Webhook Payload Example

{
  "webhookId": "wh_abc123",
  "id": "evt_xyz789",
  "createdAt": "2024-01-15T12:00:00.000Z",
  "type": "ADDRESS_ACTIVITY",
  "event": {
    "network": "ETH_MAINNET",
    "activity": [{
      "fromAddress": "0x123...",
      "toAddress": "0x456...",
      "value": 1.5,
      "asset": "ETH"
    }]
  }
}

# Get all assets for a wallet
./alchemy.sh balance 0x...      # ETH balance
./alchemy.sh tokens 0x...       # ERC-20 tokens
./alchemy.sh nfts 0x...         # NFTs

# Get full tx history for address
./alchemy.sh transfers 0x... --category external,erc20,erc721

NFT Collection Analysis

# Get all NFTs in a collection
./alchemy.sh collection 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D

# Check same address across chains
for chain in eth-mainnet polygon-mainnet arb-mainnet base-mainnet; do
  echo "=== $chain ==="
  ./alchemy.sh --chain $chain balance 0x...
done

Plan	Compute Units/sec	Monthly CUs
Free	330	300M
Growth	660	Unlimited
Scale	Custom	Custom

Most endpoints cost 1-50 CUs. Check alchemy.com/docs/rate-limits for details.

// Rate limited
{"error": {"code": 429, "message": "Too Many Requests"}}

// Invalid API key
{"error": {"code": 401, "message": "Invalid API Key"}}

// Invalid params
{"error": {"code": -32602, "message": "Invalid params"}}

Get API Key: alchemy.com (free tier)
Dashboard: dashboard.alchemy.com
Docs: alchemy.com/docs
SDK: github.com/alchemyplatform/alchemy-sdk-js
Status: status.alchemy.com

Built byGizmoLab 🔧

GizmoLab is a Web3 development agency building dApps, smart contracts, and blockchain tools.

🌐 gizmolab.io — Agency services
🛠️ tools.gizmolab.io — Free blockchain dev tools
🎨 ui.gizmolab.io — Web3 UI components

Need custom blockchain development? Get in touch

The skill is designed for both human developers AND AI agents. See references/agent-workflows.md for complete examples:

Whale Tracker — Monitor large wallets for moves
Portfolio Monitor — Track balances across chains
NFT Floor Alert — Alert on price drops
Token Change Detector — Detect incoming/outgoing tokens
Gas Optimizer — Wait for low gas to transact
Mint Detector — Watch for new NFT mints
Dashboard Generator — Auto-generate wallet dashboards

QUERY → STORE → ANALYZE → DECIDE → ACT → REPEAT

Example cron job for an agent:

# Every hour, check whale activity and alert if >100 ETH moved
0 * * * * ~/.openclaw/workspace/skills/alchemy-web3/scripts/whale-tracker.sh

references/nft-api.md - Full NFT API reference
references/token-api.md - Full Token API reference
references/node-api.md - Full Node API reference
references/chains.md - All supported chains
references/agent-workflows.md - AI agent automation examples

React Router 框架模式指南：全栈开发、文件路由、数据加载与渲染策略

Alchemy Web3技能：区块链数据查询API，支持以太坊、Polygon、Solana等80+链

🇨🇳中文介绍

Alchemy Web3 技能

设置

1. 获取 API 密钥

2. 配置

快速参考

支持的链

CLI 使用

命令

获取 ETH 余额

获取代币余额

获取所有者持有的 NFT

获取 NFT 元数据

获取资产转账记录

获取区块信息

获取交易信息

解析 ENS

切换链

直接 API 示例

Node API (JSON-RPC)

NFT API

Token API

转账 API

JavaScript/Node.js 示例

使用 Fetch (Node 18+)

使用 Alchemy SDK

Webhooks（实时通知）

Webhook 类型

创建 Webhook（仪表板）

Webhook 负载示例

常见模式

投资组合跟踪器

交易历史记录

NFT 集合分析

多链查询

速率限制

错误处理

资源

关于

AI 智能体工作流

智能体模式

另请参阅

🇺🇸English

Alchemy Web3 Skill

Setup

1. Get API Key

2. Configure

Quick Reference

Supported Chains

相关 Skills

最新 Skills

CLI Usage

Commands

Get ETH Balance

Get Token Balances

Get NFTs for Owner

Get NFT Metadata

Get Asset Transfers

Get Block Info

Get Transaction

Resolve ENS

Switch Chain

Direct API Examples

Node API (JSON-RPC)

NFT API

Token API

Transfers API

JavaScript/Node.js Examples

Using Fetch (Node 18+)

Using Alchemy SDK

Webhooks (Real-time Notifications)

Webhook Types

Create Webhook (Dashboard)

Webhook Payload Example

Common Patterns

Portfolio Tracker

Transaction History

NFT Collection Analysis

Multi-chain Query