alchemy-web3

# 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 by [GizmoLab](https://gizmolab.io?utm_source=alchemy-web3-skill&utm_medium=github&utm_campaign=skill)** — Web3 development agency specializing in dApps, smart contracts, and blockchain infrastructure.

## Setup

### 1. Get API Key
1. Sign up at [alchemy.com](https://www.alchemy.com/?utm_source=gizmolab&utm_medium=skill&utm_campaign=alchemy-web3) (free tier available)
2. Create an app for your target chain
3. Copy your API key

> 💡 New to Web3 development? [GizmoLab](https://gizmolab.io?utm_source=alchemy-web3-skill&utm_medium=github&utm_campaign=skill) offers full-stack blockchain development services.

### 2. Configure
```bash
# 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 |
|-------|-----------------|
| Ethereum | `eth-mainnet`, `eth-sepolia` |
| Polygon | `polygon-mainnet`, `polygon-amoy` |
| Arbitrum | `arb-mainnet`, `arb-sepolia` |
| Optimism | `opt-mainnet`, `opt-sepolia` |
| Base | `base-mainnet`, `base-sepolia` |
| Solana | `solana-mainnet`, `solana-devnet` |
| zkSync | `zksync-mainnet` |
| Linea | `linea-mainnet` |
| Scroll | `scroll-mainnet` |
| Blast | `blast-mainnet` |

Full list: [alchemy.com/docs/chains](https://www.alchemy.com/docs/chains)

## CLI Usage

```bash
# Set your API key first
export ALCHEMY_API_KEY="your_key"

# Use the CLI
~/.openclaw/workspace/skills/alchemy-web3/scripts/alchemy.sh <command> [options]
```

### Commands

#### Get ETH Balance
```bash
./alchemy.sh balance 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
# Returns: 1234.56 ETH
```

#### Get Token Balances
```bash
./alchemy.sh tokens 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
# Returns: All ERC-20 tokens held by address
```...

# alchemy-web3

> Query blockchain data across 80+ chains with one CLI

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Made by GizmoLab](https://img.shields.io/badge/Made%20by-GizmoLab-blue)](https://gizmolab.io?utm_source=alchemy-web3-skill&utm_medium=github&utm_campaign=skill)

Get NFTs, token balances, transaction history, and more using Alchemy's production-grade APIs. Works for human devs AND AI agents.

## Features

- 🔍 Query any wallet's NFTs, tokens, balances
- ⛓️ 80+ chains (Ethereum, Polygon, Arbitrum, Base, Solana...)
- 🤖 AI agent workflows included
- 🛠️ Simple CLI + curl examples + JS SDK

## Quick Start

### 1. Get API Key

Sign up at [alchemy.com](https://www.alchemy.com/?utm_source=gizmolab&utm_medium=skill&utm_campaign=alchemy-web3) (free tier available)

### 2. Set API Key

```bash
export ALCHEMY_API_KEY="your_key_here"
```

### 3. Query

```bash
# Get wallet balance
./scripts/alchemy.sh balance 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

# Get all NFTs
./scripts/alchemy.sh nfts 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

# Get token balances
./scripts/alchemy.sh tokens 0x...

# Check gas price
./scripts/alchemy.sh gas

# Query different chain
./scripts/alchemy.sh --chain polygon-mainnet balance 0x...
```

## Commands

| Command | Description |
|---------|-------------|
| `balance <address>` | Get ETH/native balance |
| `tokens <address>` | Get all ERC-20 token balances |
| `nfts <address>` | Get all NFTs owned |
| `nft-metadata <contract> <id>` | Get specific NFT metadata |
| `collection <contract>` | Get NFTs in collection |
| `transfers <address>` | Get transaction history |
| `block <number\|latest>` | Get block info |
| `tx <hash>` | Get transaction details |
| `gas` | Get current gas prices |

## Supported Chains

Ethereum, Polygon, Arbitrum, Optimism, Base, zkSync, Linea, Scroll, Blast, Solana, and 70+ more.

See [references/chains.md](references/chains.md) for full list.

## A...