← Back to toolkits
Alchemy logo

Alchemy

Alchemy is a blockchain development platform that provides powerful APIs and developer tools for building and scaling Ethereum applications

developer tools

Tools (36)

  • Compute NFT Rarity

    Tool to compute the rarity of each attribute for a specific NFT based on its collection. Returns prevalence data for each trait, indicating how common or rare each attribute is compared to other NFTs in the same collection. Use when analyzing NFT rarity for trading decisions, collection analysis, or valuation purposes.

    Inputs: tokenId, contractAddress

  • Get NFT Collection Metadata

    Get NFT collection metadata by OpenSea slug on Ethereum mainnet, including available name, description, social links, and floor price, without requiring a contract address.

    Inputs: collectionSlug

  • Get Collections for Owner

    Tool to retrieve all NFT collections held by a specified owner address. Use when you need to get a comprehensive view of what NFT collections a wallet owns, including collection metadata, ownership counts, and spam classification. Only supported on Ethereum. Supports pagination for large collections and filtering options to include or exclude spam/airdrops.

    Inputs: owner, pageKey, pageSize, withMetadata, excludeFilters, includeFilters

  • Get Contract Metadata Batch V3

    Retrieve metadata for multiple Ethereum mainnet NFT contracts in a single batch request.

    Inputs: contractAddresses

  • Get Contract Metadata V3

    Get metadata for an Ethereum mainnet NFT contract, including available name, symbol, total supply, token type, deployer, deployment block, and OpenSea collection details.

    Inputs: contractAddress

  • Get Contracts for Owner (NFT API v3)

    Retrieve NFT contracts from which an Ethereum mainnet wallet holds tokens, with available contract metadata, spam classification, and OpenSea metadata. Supports pagination.

    Inputs: owner, orderBy, pageKey, pageSize, withMetadata, excludeFilters, includeFilters, spamConfidenceLevel

  • Get NFT Floor Price

    Get Ethereum mainnet NFT collection floor prices from OpenSea and LooksRare, including available price, currency, collection URL, and retrieval timestamp. Prices may be cached.

    Inputs: collectionSlug, contractAddress

  • Get Historical Token Prices

    Retrieves historical price data for a token over a specified time range with configurable intervals. Identify the token either by symbol (e.g., ETH, BTC) or by network and contract address. Use this to build price charts, analyze price trends, calculate historical returns, or display historical price information in your application. Important: Provide either symbol OR both network and address (not both methods simultaneously). Time range is specified with start_time and end_time (Unix timestamps or ISO 8601 strings). The interval parameter controls data point granularity (5m, 1h, or 1d).

    Inputs: symbol, address, network, end_time, interval, start_time, with_market_data

  • Get NFT Contracts By Address

    Tool to retrieve NFT contracts associated with one or more wallet addresses across multiple blockchain networks. Use when you need to discover which NFT collections a wallet owns tokens from, across networks like Ethereum, Base, Polygon, Arbitrum, and Optimism. Returns contract details including metadata, spam classification, and OpenSea data.

    Inputs: pageKey, pageSize, addresses, withMetadata, excludeFilters, includeFilters, spamConfidenceLevel

  • Get NFT Metadata

    Retrieves metadata for a specific NFT on Ethereum mainnet, including available contract details, media URLs, attributes, and OpenSea data.

    Inputs: tokenId, tokenType, refreshCache, contractAddress, tokenUriTimeoutInMs

  • Get NFT Metadata Batch

    Retrieves metadata for up to 100 NFTs on Ethereum mainnet in a single request, including available contract details, media URLs, attributes, and collection data.

    Inputs: tokens, refreshCache, tokenUriTimeoutInMs

  • Get NFT Sales V3

    Retrieves Ethereum mainnet NFT sales through on-chain marketplaces using Alchemy's v3 API, including fees and transaction details. Supports filtering by block range, marketplace, contract, token, buyer, seller, and taker role.

    Inputs: limit, order, taker, page_key, to_block, token_id, from_block, marketplace, buyer_address, seller_address, contract_address

  • Get NFTs for Collection V3

    Retrieves NFTs in an Ethereum mainnet collection using an OpenSea collection slug or contract address. Supports pagination and optional metadata.

    Inputs: limit, start_token, with_metadata, collection_slug, contract_address, token_uri_timeout_ms

  • Get NFTs for Contract

    Retrieves NFTs for an Ethereum mainnet NFT contract, supporting ERC721 and ERC1155. Results can include token IDs, metadata, images, and attributes, with pagination for up to 100 NFTs per request.

    Inputs: limit, start_token, with_metadata, contract_address, token_uri_timeout_ms

  • Get NFTs for Owner

    Retrieves NFTs owned by an address on Ethereum mainnet, supporting ERC721 and ERC1155 tokens, optional metadata, filtering, and pagination.

    Inputs: owner, orderBy, pageKey, pageSize, withMetadata, excludeFilters, includeFilters, contractAddresses, spamConfidenceLevel, tokenUriTimeoutInMs

  • Get Owners for Collection

    Retrieves owner addresses for an Ethereum mainnet NFT collection contract, with optional token balances per owner and pagination. Supports ownership analysis for ERC721 and ERC1155 contracts.

    Inputs: pageKey, contractAddress, withTokenBalances

  • Get Owners for Contract

    Retrieves owners of NFTs in an Ethereum mainnet contract, with optional token balances and pagination. Use for NFT holder distribution and ownership analysis.

    Inputs: pageKey, contractAddress, withTokenBalances

  • Get NFT Owners (v3)

    Retrieves owner addresses for a specific Ethereum mainnet NFT using Alchemy's v3 API.

    Inputs: tokenId, contractAddress

  • Get Portfolio NFTs By Address

    Tool to fetch NFTs owned by multiple wallet addresses across different blockchain networks. Returns comprehensive NFT metadata including contract details, images, attributes, and ownership information. Use when you need to retrieve NFT portfolio data for wallets across multiple chains.

    Inputs: orderBy, pageKey, pageSize, addresses, sortOrder, withMetadata, excludeFilters, includeFilters, spamConfidenceLevel

  • Get Token Prices By Symbol

    Tool to get current token prices by symbol (e.g., ETH, USDC, BTC) using aggregated CEX and DEX data. Use when you need real-time cryptocurrency prices in USD or other currencies. Supports up to 25 symbols per request. Note: Response succeeds even if some tokens are missing - check the error field in each result item.

    Inputs: symbols

  • Get Token Balances

    This tool retrieves ERC20 token balances for a specified Ethereum address. It can either return balances for all tokens an address has ever interacted with or for a specific set of token contract addresses. It is useful for checking token balances for wallets, monitoring ERC20 token holdings, portfolio tracking, and DeFi applications.

    Inputs: address, page_key, max_count, contract_addresses

  • Get Token Balances By Address

    Tool to get token balances for wallet addresses across multiple networks using Alchemy's Portfolio API. Use when you need lightweight balance checks for one or more addresses without full token metadata. Supports up to 3 address/network pairs per request with pagination for large result sets.

    Inputs: pageKey, addresses, includeErc20Tokens, includeNativeTokens

  • Get Token Metadata

    Retrieves Ethereum mainnet ERC-20 token metadata, including available name, symbol, decimals, and logo URL, for display and token amount conversion.

    Inputs: contract_address

  • Get Token Prices By Address

    Retrieves current token prices by contract address and network from decentralized exchanges (DEXes). Use when you need real-time token price data for specific contract addresses across multiple networks. Price data is aggregated from DEXes only (not CEXes) and weighted by total volume. Supports up to 25 addresses per request across maximum 3 different networks. Returns price in USD by default with timestamp. Response succeeds even if some prices are unavailable.

    Inputs: addresses

  • Get Tokens By Address

    Tool to fetch fungible tokens (native, ERC-20, SPL) for multiple wallet addresses across networks. Returns comprehensive token information including balances, metadata (name, symbol, decimals, logo), and current prices. Use when you need complete token portfolio data for wallets across multiple chains (Ethereum, Polygon, Arbitrum, Base, Optimism, Solana, and 30+ EVM chains). Supports up to 2 addresses with 5 networks each per request, with pagination for large result sets.

    Inputs: pageKey, addresses, withPrices, withMetadata, includeErc20Tokens, includeNativeTokens

  • Get Transaction Count

    Retrieves an Ethereum mainnet address's transaction count (nonce) at a specified block tag or hexadecimal block number using eth_getTransactionCount. The count is returned in hexadecimal.

    Inputs: address, block_tag

  • Get Transactions History By Address

    Retrieves transaction history for one wallet address across up to two networks using Alchemy's Data API. Results can include logs and internal transactions, and support pagination with a maximum of 50 transactions per request.

    Inputs: after, limit, before, pageKey, addresses

  • Invalidate NFT Contract Cache

    Tool to invalidate the cached metadata for an NFT contract. Use when you need to force a refresh of stale or outdated NFT metadata on the next request. This is useful after contract updates or when metadata changes are expected.

    Inputs: network, contractAddress

  • Check If NFT Is Airdrop

    Tool to check if a specific NFT token is marked as an airdrop. Use when you need to determine whether an NFT was distributed via airdrop mechanism. Returns true if the token is identified as an airdrop, false otherwise.

    Inputs: tokenId, contractAddress

  • Check If NFT Is Airdrop

    Check whether a specified NFT is marked as an airdrop using its contract address and token ID on Ethereum mainnet.

    Inputs: tokenId, contractAddress

  • Check Collection Ownership

    Tool to check if a wallet address owns any token from a specific NFT collection. Use this when you need to verify collection ownership without retrieving full NFT details, supporting both ERC721 and ERC1155 standards.

    Inputs: wallet, contractAddress

  • Check NFT Holder Status

    Tool to check if a wallet address holds any NFTs from a specific contract. Use when you need to verify NFT ownership for access control, membership verification, or token-gating features. Supports both ERC721 and ERC1155 contracts.

    Inputs: wallet, contract_address

  • Check if Contract is Spam

    Tool to check if an NFT contract is marked as spam by Alchemy. Use when you need to verify the legitimacy of an NFT contract before interacting with it or displaying its assets. Returns true if the contract is flagged as spam, false if it's valid or hasn't been evaluated yet.

    Inputs: contractAddress

  • Check if Contract is Spam (V3)

    Tool to determine if a specific NFT contract is marked as spam by Alchemy. Use when you need to verify the legitimacy of an NFT contract address before interacting with it. Available on paid Alchemy tiers only.

    Inputs: contractAddress

  • Search NFT Contract Metadata

    Search Ethereum mainnet NFT contract metadata by keywords to find collections. Results may include contract addresses, names, symbols, token types, deployer information, and OpenSea metadata.

    Inputs: query

  • Summarize NFT Attributes

    Retrieves a summary of NFT attributes for an Ethereum mainnet collection, including trait value counts. Use it to analyze collection composition and build trait filters.

    Inputs: contract_address