Skip to main content
Alchemy
Alchemy
39 actions · 1 auth method
Preview

Authentication

API Key

Uses an Alchemy App API key placed in the URL path and a chain subdomain (e.g. eth-mainnet, base-mainnet) for chain-scop…Guides: Connector Profile, Link Account
Actions
39 actions
Action
Description
Get NFTs For Owner
Retrieve all NFTs currently owned by a specified wallet address on the selected EVM network, with optional metadata and…
Get NFTs For Contract
Retrieve all NFTs associated with a specific NFT contract on the selected EVM network, with optional metadata and pagina…
Get Owners For NFT
Retrieve the current owner(s) of a specific NFT token identified by contract address and token ID.
Get Owners For Contract
Retrieve all wallet addresses that own at least one token from an NFT contract, with optional per-token balances and pag…
Get Contracts For Owner
Retrieve all NFT contracts (collections) from which a wallet address holds at least one token, with optional metadata an…
Get NFT Metadata
Retrieve full metadata (name, image, attributes, token URI) for a single NFT identified by contract address and token ID…
Get NFT Metadata Batch
Retrieve metadata for up to 100 NFTs across multiple contracts in a single batched request.
Get Contract Metadata
Retrieve collection-level metadata (name, symbol, total supply, OpenSea data) for a single NFT contract.
Get Contract Metadata Batch
Retrieve collection-level metadata for multiple NFT contracts in a single batched request.
Search Contract Metadata
Search for NFT contracts by keyword across all ERC-721 and ERC-1155 contract metadata (name, symbol, description).
Get Floor Price
Retrieve the current floor prices for an NFT collection across supported marketplaces (OpenSea, LooksRare). Provide EITH…
Compute Rarity
Compute the rarity score of each attribute for a specific NFT token within an NFT contract.
Summarize NFT Attributes
Generate a summary of how frequently each attribute value appears across all NFTs in a collection.
Invalidate Contract
Mark all cached tokens for the specified NFT contract as stale so the next read fetches fresh on-chain data.
Is Spam Contract
Check whether a specific NFT contract is classified as spam by Alchemy.
Get Spam Contracts
Retrieve the complete list of NFT contracts that Alchemy has classified as spam. Requires the Growth tier or higher — fr…
Report Spam
Report an NFT contract address to Alchemy as suspected spam. Requires the Enterprise tier or higher — lower tiers receiv…
Is Airdrop NFT
Check whether a specific NFT token was airdropped (minted to the owner via a transaction sent by a different address).
Get NFT Sales
Retrieve historical NFT sales data across supported on-chain marketplaces, filterable by block range, marketplace, contr…
Get Tokens By Address
Get tokens (fungible + native) held by one or more wallet addresses across specified EVM networks in a single chain-agno…
Get Token Balances By Address
Get token balances (native + ERC-20) held by one or more wallet addresses across specified EVM networks in a single chai…
Get NFTs By Address
Get NFTs held by one or more wallet addresses across specified EVM networks, with optional spam/airdrop filters, in a si…
Get NFT Contracts By Address
Get NFT contracts (collections) that one or more wallet addresses hold at least one token from, across specified EVM net…
Get Token Prices By Symbol
Fetch current market prices for up to 25 tokens identified by their ticker symbols (e.g. ETH, BTC, USDC).
Get Token Prices By Address
Fetch current DEX-sourced prices for up to 25 tokens identified by network and contract address pairs.
Get Historical Token Prices
Fetch time-series price history for a single token over a caller-specified time window at 5-minute, hourly, or daily gra…
Get Native Balance
Get the native token balance (ETH / MATIC / BNB / etc.) for an address on the selected EVM network.
Read Contract State (eth_call)
Execute a read-only contract call (view/pure function) against the current chain state, returning the raw ABI-encoded re…
Get Block By Number
Get block information (timestamp, hash, transactions, gas usage) for a specific block number on the selected EVM network…
Get Transaction By Hash
Get transaction details (from, to, value, input data, gas, block) for a specific transaction hash.
Get Transaction Receipt
Get the transaction receipt (status, gas used, logs, block hash) for a single transaction hash.
Get Event Logs
Get contract event logs matching filter criteria (block range, address, topics) — the core method for indexing token tra…
Get Gas Price
Get the current gas price (in wei, hex-encoded) on the selected EVM network.
Estimate Gas
Estimate the gas required to execute a transaction, without submitting it to the network.
Get Token Allowance
Returns the ERC-20 token allowance granted by an owner to a spender for a given contract.
Get Token Balances
Returns ERC-20 token balances for a given wallet address, optionally filtered to specific contracts or token type.
Get Token Metadata
Returns metadata (name, symbol, decimals, logo) for a given ERC-20 token contract.
Get Asset Transfers
Fetch historical asset transfer events (external, internal, ERC-20, ERC-721, ERC-1155, special NFT) for any address on t…
Get Transaction Receipts
Batch-fetch all transaction receipts for an entire block in a single call, identified by block number or block hash.

Getting Started

1

Create or Select a Project

Set up a new project or select an existing one. See Organizations & Projects.
2

Configure the Connector

Enable the connector and set up a connector profile in your project. See Managing Connectors.

Connector Profile

Alchemy - API Key
3

Link an Account

Connect an account using StackOne Hub or Auth Link.

Link Account

Alchemy - API Key
4

Use Actions

Invoke actions using one of the methods below:
  • MCP – Model Context Protocol for AI assistants
  • A2A – Agent-to-Agent protocol
  • Agent SDK – TypeScript and Python SDKs for AI agents
  • Actions RPC – Direct API calls
  • Playground – Test actions in the dashboard