Agent skill

Alchemy API

by moonpay in moonpay/skills

Integrates Alchemy blockchain APIs using an API key. An agent skill from moonpay/skills.

MITAuto-check passedBackend & APIs

Install Alchemy API

skills CLI
$ npx skills add moonpay/skills --skill alchemy-api -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install moonpay/skills alchemy-api --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/moonpay/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/alchemy-api .claude/skills/alchemy-api && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
alchemy-api
GitHub stars
113
Token cost
~2.1k tokens
SKILL.md length
640 words
Files
1
Skills in repo
39
Repo updated
First seen
Licence
MIT

At a glance

Integrates Alchemy blockchain APIs using an API key. An agent skill from moonpay/skills.

  • Works in 3 steps: Create a free API key at… → Export the key: export ALCHEMY_API_KEY= → If no API key is available, use the…
  • User asks about EVM JSON-RPC calls
  • SKILL.md covers Prerequisites, Mandatory Routing Gate (Hard…, Base URLs + Auth (Cheat Sheet) and Endpoint Selector (Top Tasks), plus 8 more sections
  • Calls curl; reaches dashboard.alchemy.com and eth-mainnet.g.alchemy.com; needs ALCHEMY_API_KEY and ALCHEMY_NOTIFY_AUTH_TOKEN

What it does

Alchemy API is an agent skill from moonpay/skills. Integrates Alchemy blockchain APIs using an API key. Requires $ALCHEMYAPIKEY to be set; if unavailable, use the alchemy-agentic-gateway skill instead. Use when user asks about EVM JSON-RPC calls, token balances, NFT ownership or metadata, transfer history, token prices, portfolio data, transaction simulation, webhooks, Solana RPC, or any Alchemy product integration. Covers base URLs, authentication, endpoint selection, pagination, and common patterns.

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Requires network access and $ALCHEMYAPIKEY environment variable. Works across Claude.ai, Claude Code, and API.

It sits in Backend & APIs, covering Smart contracts, Crypto and DeFi analysis and Webhooks. It works with Solana. The repository describes itself as: Skills for AI agents to move money — on-ramps, swaps, wallets, deposits, and more via the MoonPay CLI. The licence is MIT.

When your agent uses it

  • User asks about EVM JSON-RPC calls
  • Transfer history
  • Transaction simulation
  • Any Alchemy product integration

Example prompts

  • “Use the alchemy-api skill to integrate Alchemy blockchain APIs using an API key. An agent skill from moonpay/skills”
  • “/alchemy-api”

Requirements

  • A credential in ALCHEMY_API_KEY
  • A credential in ALCHEMY_NOTIFY_AUTH_TOKEN
  • Compatibility (from SKILL.md): Requires network access and $ALCHEMY_API_KEY environment variable. Works across Claude.ai, Claude Code, and API.

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Create a free API key at https://dashboard.alchemy.com/
  2. Export the key: export ALCHEMY_API_KEY=
  3. If no API key is available, use the alchemy-agentic-gateway skill instead (wallet-based auth).

What it can do on your machine

Read from SKILL.md and the folder at commit aa672ab. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • dashboard.alchemy.com
    • eth-mainnet.g.alchemy.com
    • api.g.alchemy.com
    • solana-mainnet.g.alchemy.com
    • base-mainnet.g.alchemy.com
    • arb-mainnet.g.alchemy.com
    • bnb-mainnet.g.alchemy.com

    Also links to:

    • alchemy.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • ALCHEMY_API_KEY
    • ALCHEMY_NOTIFY_AUTH_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Requires network access and $ALCHEMY_API_KEY environment variable. Works across Claude.ai, Claude Code, and API.

    From compatibility in the SKILL.md frontmatter.

Context cost

Alchemy API loads about 2.1k tokens when it runs. Until then it costs about 117 tokens; SKILL.md has 640 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~117
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from moonpay/skills at commit aa672ab, republished under its MIT licence (© moonpay). 640 words, ~2,078 tokens.

Download SKILL.mdSave it as .claude/skills/alchemy-api/SKILL.md (or your agent's skills folder).
name
alchemy-api
description
Integrates Alchemy blockchain APIs using an API key. Requires $ALCHEMY_API_KEY to be set; if unavailable, use the alchemy-agentic-gateway skill instead. Use when user asks about EVM JSON-RPC calls, token balances, NFT ownership or metadata, transfer history, token prices, portfolio data, transaction simulation, webhooks, Solana RPC, or any Alchemy product integration. Covers base URLs, authentication, endpoint selection, pagination, and common patterns.
compatibility
Requires network access and $ALCHEMY_API_KEY environment variable. Works across Claude.ai, Claude Code, and API.
tags
alchemy, blockchain, evm, solana, rpc, nft, api-key, web3
license
MIT
metadata.author
alchemyplatform
metadata.version
1.0

AI + Alchemy API Integration Guide

Prerequisites

  1. Create a free API key at https://dashboard.alchemy.com/
  2. Export the key: export ALCHEMY_API_KEY=<your-key>
  3. If no API key is available, use the alchemy-agentic-gateway skill instead (wallet-based auth).

Mandatory Routing Gate (Hard Requirement)

Before the first network call or implementation step, you MUST ask the user the following question and wait for an explicit answer:

Do you want to use an existing Alchemy API key, or should I use the agentic gateway flow instead?

If the user chooses the API key path, continue with this skill. If the user chooses the agentic gateway path, switch to the alchemy-agentic-gateway skill immediately and follow its existing wallet flow. If the user chooses the API key path but ALCHEMY_API_KEY is unset or empty, tell them they can create a free API key at https://dashboard.alchemy.com/ or switch to the alchemy-agentic-gateway skill.

You MUST NOT call any keyless or public fallback (including .../v2/demo) unless the user explicitly asks for that endpoint. Execute no network calls before this gate is evaluated.

Base URLs + Auth (Cheat Sheet)

ProductBase URLAuthNotes
Ethereum RPC (HTTPS)https://eth-mainnet.g.alchemy.com/v2/$ALCHEMY_API_KEYAPI key in URLStandard EVM reads and writes.
Ethereum RPC (WSS)wss://eth-mainnet.g.alchemy.com/v2/$ALCHEMY_API_KEYAPI key in URLSubscriptions and realtime.
Base RPC (HTTPS)https://base-mainnet.g.alchemy.com/v2/$ALCHEMY_API_KEYAPI key in URLEVM L2.
Arbitrum RPC (HTTPS)https://arb-mainnet.g.alchemy.com/v2/$ALCHEMY_API_KEYAPI key in URLEVM L2.
BNB RPC (HTTPS)https://bnb-mainnet.g.alchemy.com/v2/$ALCHEMY_API_KEYAPI key in URLEVM L1.
Solana RPC (HTTPS)https://solana-mainnet.g.alchemy.com/v2/$ALCHEMY_API_KEYAPI key in URLSolana JSON-RPC.
Solana Yellowstone gRPChttps://solana-mainnet.g.alchemy.comX-Token: $ALCHEMY_API_KEYgRPC streaming (Yellowstone).
NFT APIhttps://<network>.g.alchemy.com/nft/v3/$ALCHEMY_API_KEYAPI key in URLNFT ownership and metadata.
Prices APIhttps://api.g.alchemy.com/prices/v1/$ALCHEMY_API_KEYAPI key in URLPrices by symbol or address.
Portfolio APIhttps://api.g.alchemy.com/data/v1/$ALCHEMY_API_KEYAPI key in URLMulti-chain wallet views.
Notify APIhttps://dashboard.alchemy.com/apiX-Alchemy-Token: <ALCHEMY_NOTIFY_AUTH_TOKEN>Generate token in dashboard.

Endpoint Selector (Top Tasks)

You needUse this
EVM read/writeJSON-RPC eth_*
Realtime eventseth_subscribe (WebSocket)
Token balancesalchemy_getTokenBalances
Token metadataalchemy_getTokenMetadata
Transfers historyalchemy_getAssetTransfers
NFT ownershipGET /getNFTsForOwner
NFT metadataGET /getNFTMetadata
Prices (spot)GET /tokens/by-symbol
Prices (historical)POST /tokens/historical
Portfolio (multi-chain)POST /assets/*/by-address
Simulate txalchemy_simulateAssetChanges
Create webhookPOST /create-webhook
Solana NFT datagetAssetsByOwner (DAS)

Full reference: https://www.alchemy.com/docs

One-File Quickstart (Copy/Paste)

No API key? Use the alchemy-agentic-gateway skill instead.

EVM JSON-RPC (Read)
bash
curl -s https://eth-mainnet.g.alchemy.com/v2/$ALCHEMY_API_KEY \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'
Token Balances
bash
curl -s https://eth-mainnet.g.alchemy.com/v2/$ALCHEMY_API_KEY \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"alchemy_getTokenBalances","params":["0x00000000219ab540356cbb839cbe05303d7705fa"]}'
Transfer History
bash
curl -s https://eth-mainnet.g.alchemy.com/v2/$ALCHEMY_API_KEY \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"alchemy_getAssetTransfers","params":[{"fromBlock":"0x0","toBlock":"latest","toAddress":"0x00000000219ab540356cbb839cbe05303d7705fa","category":["erc20"],"withMetadata":true,"maxCount":"0x3e8"}]}'
NFT Ownership
bash
curl -s "https://eth-mainnet.g.alchemy.com/nft/v3/$ALCHEMY_API_KEY/getNFTsForOwner?owner=0x00000000219ab540356cbb839cbe05303d7705fa"
Prices (Spot)
bash
curl -s "https://api.g.alchemy.com/prices/v1/$ALCHEMY_API_KEY/tokens/by-symbol?symbols=ETH&symbols=USDC"
Prices (Historical)
bash
curl -s -X POST "https://api.g.alchemy.com/prices/v1/$ALCHEMY_API_KEY/tokens/historical" \
  -H "Content-Type: application/json" \
  -d '{"symbol":"ETH","startTime":"2024-01-01T00:00:00Z","endTime":"2024-01-02T00:00:00Z"}'
Show full SKILL.md (260 more words)Show less
Create Notify Webhook
bash
curl -s -X POST "https://dashboard.alchemy.com/api/create-webhook" \
  -H "Content-Type: application/json" \
  -H "X-Alchemy-Token: $ALCHEMY_NOTIFY_AUTH_TOKEN" \
  -d '{"network":"ETH_MAINNET","webhook_type":"ADDRESS_ACTIVITY","webhook_url":"https://example.com/webhook","addresses":["0x00000000219ab540356cbb839cbe05303d7705fa"]}'

To verify webhook signatures, use HMAC-SHA256 with the webhook signing key from your dashboard. See https://www.alchemy.com/docs/webhooks for details.

Network Naming Rules

  • Data APIs and JSON-RPC use lowercase network enums: eth-mainnet, base-mainnet
  • Notify API uses uppercase enums: ETH_MAINNET, BASE_MAINNET

Pagination + Limits (Cheat Sheet)

EndpointLimitNotes
alchemy_getTokenBalancesmaxCount <= 100Use pageKey for pagination.
alchemy_getAssetTransfersmaxCount default 0x3e8Use pageKey for pagination.
Portfolio token balances3 address/network pairs, 20 networks totalpageKey supported.
Portfolio NFTs2 address/network pairs, 15 networks eachpageKey supported.
Prices by address25 addresses, 3 networksPOST body addresses[].

Common Token Addresses

TokenChainAddress
ETHethereum0x0000000000000000000000000000000000000000
WETHethereum0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2
USDCethereum0xA0b86991c6218b36c1d19d4a2e9eb0ce3606eB48
USDCbase0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Failure Modes + Retries

  • HTTP 429 means rate limit. Use exponential backoff with jitter.
  • JSON-RPC errors come in error fields even with HTTP 200.
  • Use pageKey to resume pagination after failures.
  • De-dupe websocket events on reconnect.

Troubleshooting

API key not working
  • Verify: echo $ALCHEMY_API_KEY
  • Confirm the key is valid at https://dashboard.alchemy.com/
  • Check if allowlists restrict the key to specific IPs/domains
HTTP 429 (Rate Limited)
  • Use exponential backoff with jitter before retrying
  • Check your compute unit budget in the Alchemy dashboard
Wrong network slug
  • Data APIs and JSON-RPC use lowercase: eth-mainnet, base-mainnet
  • Notify API uses uppercase: ETH_MAINNET, BASE_MAINNET
JSON-RPC error with HTTP 200
  • Alchemy returns JSON-RPC errors inside the error field even with a 200 status code
  • Always check response.error in addition to HTTP status
  • alchemy-agentic-gateway — Access Alchemy APIs without an API key via x402 or MPP wallet auth

© moonpay, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/alchemy-api of moonpay/skills.

Open the folder on GitHubat commit aa672ab

Compare with similar skills

Alchemy API next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Alchemy API compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Alchemy API this skillmoonpay/skills113—~2.1kAutomated safety check: PassMIT
Alchemy OfficialLeoYeAI/openclaw-master-skills2.2k—~6.1kAutomated safety check: PassMIT
AlchemyBankrBot/skills1.2k—~3.5kAutomated safety check: PassMIT
Quicknodesendaifun/skills1301 repos~5.5kAutomated safety check: NotesApache-2.0
Solana Devsolana-foundation/solana-dev-skill571—~3.8kAutomated safety check: PassMIT
Solana Token Extensionssolanabr/ai-kit108—~3.5kAutomated safety check: PassMIT

Similar skills

  • Alchemy Official

    LeoYeAI/openclaw-master-skills

    Official Alchemy skill. An agent skill from LeoYeAI/openclaw-master-skills.

    2.2k GitHub stars~6.1k tokensUpdated 2 mo ago
    Backend & APIsAuto-check passed
  • Alchemy

    BankrBot/skills

    Blockchain API access via Alchemy. An agent skill from BankrBot/skills.

    1.2k GitHub stars~3.5k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • Quicknode

    sendaifun/skills

    Quicknode blockchain infrastructure for Solana — RPC endpoints, DAS API (Digital Asset Standard) for NFTs and compressed assets, Yellowstone gRPC streaming, Priority Fee API, Streams (real-time data…

    130 GitHub starsUsed in 1 repo~5.5k tokens
    Backend & APIsAuto-check: notes
  • Solana Dev

    solana-foundation/solana-dev-skill

    A skill your agent uses when user asks to "build a Solana dapp", "write an Anchor program", "create a token", "debug Solana errors", "set up wallet connection", "test my Solana program", "fuzz my…

    571 GitHub stars~3.8k tokensUpdated 4 days ago
    Backend & APIsAuto-check passed
  • Helps choose, combine and create Token-2022 mint and account extensions on Solana with the spl-token CLI, @solana/kit or Anchor, and integrate the resulting mints.

    108 GitHub stars~3.5k tokensUpdated today
    Backend & APIsAuto-check passed
  • deBridge Solana SDK Guide

    internet-court/internet-court-skill

    Guides building Solana programs with the deBridge SDK for cross-chain token transfers, message passing and external calls to EVM chains.

    6.4k GitHub starsUsed in 2 repos~4.9k tokens
    Backend & APIsAuto-check passed

More from moonpay/skills

All 39 skills in this repo
  • A skill your agent uses when accessing Alchemy APIs for RPC calls, token balances, NFT metadata, asset transfers, transaction simulation, or Alchemy-specific features.

    113 GitHub stars~2.1k tokensUpdated 27 days ago
    Auto-check: notes
  • Allium Onchain Data

    moonpay/skills

    Query blockchain data via Allium APIs. An agent skill from moonpay/skills.

    113 GitHub stars~1.9k tokensUpdated 27 days ago
    Auto-check passed
  • Corbits Marketplace

    moonpay/skills

    Paid API marketplace for AI agents via Corbits. An agent skill from moonpay/skills.

    113 GitHub stars~1.5k tokensUpdated 27 days ago
    Auto-check passed
  • Dune Analytics

    moonpay/skills

    Blockchain analytics via Dune REST API — execute DuneSQL queries against live on-chain data, discover decoded contract tables, and monitor credit usage.

    113 GitHub stars~1.3k tokensUpdated 27 days ago
    Auto-check passed
  • Moonpay Auth

    moonpay/skills

    Set up the MoonPay CLI, authenticate, and manage local wallets.

    113 GitHub stars~1.2k tokensUpdated 27 days ago
    Auto-check passed
  • Moonpay Check Wallet

    moonpay/skills

    Check wallet balances and holdings. An agent skill from moonpay/skills.

    113 GitHub stars~450 tokensUpdated 27 days ago
    Auto-check passed

Works with

Categories

Questions about Alchemy API

What does Alchemy API do?

Integrates Alchemy blockchain APIs using an API key. An agent skill from moonpay/skills. Alchemy API is an agent skill from moonpay/skills. Integrates Alchemy blockchain APIs using an API key.

When should I use Alchemy API?

Alchemy API fits situations like: user asks about EVM JSON-RPC calls; transfer history; transaction simulation; any Alchemy product integration.

How do I install Alchemy API in Claude Code?

Run `npx skills add moonpay/skills --skill alchemy-api -a claude-code`. Or copy the skill folder (skills/alchemy-api in moonpay/skills) into .claude/skills/alchemy-api in your project. Claude Code loads it when a task matches its description.

How do I install Alchemy API in Codex?

Run `npx skills add moonpay/skills --skill alchemy-api -a codex`. Or copy the skill folder (skills/alchemy-api in moonpay/skills) into .agents/skills/alchemy-api in your project. Codex loads it when a task matches its description.

Can I use Alchemy API in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add moonpay/skills --skill alchemy-api -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/alchemy-api, .gemini/skills/alchemy-api, .github/skills/alchemy-api and .opencode/skills/alchemy-api in your project.

What does Alchemy API need to run?

Going by SKILL.md and its folder, Alchemy API needs the command-line tools its instructions call (curl) and credentials named ALCHEMY_API_KEY and ALCHEMY_NOTIFY_AUTH_TOKEN. Our summary lists: A credential in ALCHEMY_API_KEY; A credential in ALCHEMY_NOTIFY_AUTH_TOKEN. Compatibility (from SKILL.md): Requires network access and $ALCHEMY_API_KEY environment variable. Works across Claude.ai, Claude Code, and API..

Does Alchemy API access the network?

SKILL.md names 8 domains. In commands or code: dashboard.alchemy.com, eth-mainnet.g.alchemy.com, api.g.alchemy.com, solana-mainnet.g.alchemy.com, base-mainnet.g.alchemy.com, arb-mainnet.g.alchemy.com and bnb-mainnet.g.alchemy.com; the agent is likely to contact these when it follows the instructions. As links in the text: alchemy.com. This is read from the text; nothing was executed.

Is Alchemy API safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Alchemy API use?

Alchemy API is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Alchemy API use?

About 2.1k tokens (SKILL.md is roughly 8.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Alchemy API?

Skills that share tags, products or a category with Alchemy API: Alchemy Official (LeoYeAI/openclaw-master-skills, 2.2k stars), Alchemy (BankrBot/skills, 1.2k stars), Quicknode (sendaifun/skills, 130 stars) and Solana Dev (solana-foundation/solana-dev-skill, 571 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Alchemy API?

moonpay (a GitHub organization) maintains it in moonpay/skills, which has 113 GitHub stars. The repository holds 39 skills in this directory. The repository was last updated on September 10, 2026.

Source: moonpay/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.