Skip to main content
Alchemy logo
  • Category: developer tools
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 36
  • Triggers: 0
  • Slug: ALCHEMY
  • Version: 20261101_00

Tools

Slug: ALCHEMY_COMPUTE_RARITY_V3Tool 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.

Input Parameters

string
required
The ID of the specific NFT token within the collection. Can be provided in hexadecimal (e.g., ‘0x2c’) or decimal format (e.g., ‘44’).
string
required
The Ethereum contract address for the NFT collection. Supports both ERC721 and ERC1155 standards.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_GET_COLLECTION_METADATAGet NFT collection metadata by OpenSea slug on Ethereum mainnet, including available name, description, social links, and floor price, without requiring a contract address.

Input Parameters

string
required
OpenSea slug for the NFT collection (e.g., ‘boredapeyachtclub’, ‘cryptopunks’)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_GET_COLLECTIONS_FOR_OWNERTool 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.

Input Parameters

string
required
Address for NFT owner (can be in ENS format for Ethereum Mainnet). This is the wallet address whose NFT collections you want to retrieve
string
Key for pagination. If more results are available, a pageKey will be returned in the response. Pass back the pageKey to fetch the next page of results
integer
Number of NFT collections to be returned per page. Defaults to 100. Max is 100
boolean
If set to true, returns NFT metadata. Setting to false reduces payload size and may result in faster API calls. Defaults to true
array
Array of filters that will be applied to the query. NFTs matching one or more of these filters will be excluded. Options: SPAM (NFTs classified as spam), AIRDROPS (NFTs that were airdropped). May not be used with includeFilters. Note: SPAM filter is available exclusively on paid tiers
array
Array of filters that will be applied to the query. Only NFTs matching one or more of these filters will be included. Options: SPAM (NFTs classified as spam), AIRDROPS (NFTs that were airdropped). May not be used with excludeFilters. Note: SPAM filter is available exclusively on paid tiers

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_GET_CONTRACT_METADATA_BATCH_V3Retrieve metadata for multiple Ethereum mainnet NFT contracts in a single batch request.

Input Parameters

array
required
List of contract addresses to batch metadata requests for. Supports both ERC721 and ERC1155 contracts.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_GET_CONTRACT_METADATA_V3Get metadata for an Ethereum mainnet NFT contract, including available name, symbol, total supply, token type, deployer, deployment block, and OpenSea collection details.

Input Parameters

string
required
Contract address for the NFT contract (ERC721 and ERC1155 supported).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_GET_CONTRACTS_FOR_OWNER_V3Retrieve NFT contracts from which an Ethereum mainnet wallet holds tokens, with available contract metadata, spam classification, and OpenSea metadata. Supports pagination.

Input Parameters

string
required
Address for NFT owner (can be in ENS format for Eth Mainnet)
string ("transferTime")
Ordering scheme for NFTs
string
Key for pagination. If more results are available, a pageKey will be returned in the response. Pass back the pageKey as a param to fetch the next page of results
integer
Number of NFTs to be returned per page. Defaults to 100. Max is 100
boolean
If set to true, returns NFT metadata. Setting this to false will reduce payload size and may result in a faster API call. Defaults to true
array
Array of filters that will be applied to the query. NFTs that match one or more of these filters will be excluded from the response. May not be used in conjunction with includeFilters. Filter Options: SPAM (NFTs classified as spam), AIRDROPS (NFTs that were airdropped to the user). Note: SPAM filter is available exclusively on paid tiers
array
Array of filters that will be applied to the query. Only NFTs that match one or more of these filters will be included in the response. May not be used in conjunction with excludeFilters. Filter Options: SPAM (NFTs classified as spam), AIRDROPS (NFTs that were airdropped to the user). Note: SPAM filter is available exclusively on paid tiers
string ("VERY_HIGH" | "HIGH" | "MEDIUM" | "LOW")
Spam confidence levels

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_GET_FLOOR_PRICE_V3Get Ethereum mainnet NFT collection floor prices from OpenSea and LooksRare, including available price, currency, collection URL, and retrieval timestamp. Prices may be cached.

Input Parameters

string
OpenSea slug for the NFT collection. Optional parameter to help identify the collection
string
required
Contract address for the NFT contract (ERC721 and ERC1155 supported)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_GET_HISTORICAL_PRICESRetrieves 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).

Input Parameters

string
Token symbol to query (e.g., ‘ETH’, ‘BTC’, ‘USDC’). Required if network and address are not provided. Cannot be used together with network/address.
string
Token contract address on the specified network. Required if symbol is not provided. Must be used together with network.
string
Blockchain network identifier (e.g., ‘eth-mainnet’, ‘polygon-mainnet’). Required if symbol is not provided. Must be used together with address.
string
required
End of the time range for historical data. Can be either a Unix timestamp (integer, seconds since epoch) or ISO 8601 formatted string. Example Unix timestamp: 1707782400 for Feb 13, 2024.
string ("5m" | "1h" | "1d")
Supported interval types for historical price data
string
required
Start of the time range for historical data. Can be either a Unix timestamp (integer, seconds since epoch) or ISO 8601 formatted string. Example Unix timestamp: 1707696000 for Feb 12, 2024.
boolean
Whether to include market capitalization and total volume data in the response. Defaults to false. Set to true if you need market cap and volume metrics alongside price data.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_GET_NFT_CONTRACTS_BY_ADDRESSTool 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.

Input Parameters

string
Pagination cursor from a previous response. Use this to retrieve the next page of results.
integer
Number of results to return per page. Default is 100 if not specified.
array
required
Array of address-network pairs to query. Maximum 2 addresses, each with up to 15 networks.
boolean
Include detailed metadata for each contract (OpenSea data, spam info, etc.). Defaults to true.
array
Filter out specific categories from results (e.g., SPAM, AIRDROPS). Excludes matching contracts.
array
Include only specific categories in results (e.g., SPAM, AIRDROPS). If set, only matching contracts are returned.
string ("VERY_HIGH" | "HIGH" | "MEDIUM" | "LOW")
Spam confidence level filter options.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_GET_NFT_METADATARetrieves metadata for a specific NFT on Ethereum mainnet, including available contract details, media URLs, attributes, and OpenSea data.

Input Parameters

string
required
The ID of the token. Can be in hex or decimal format.
string ("ERC721" | "ERC1155")
NFT token standard types
boolean
If true, will refresh metadata for the given token. If false (default), will check cache first and use it or refresh if cache doesn’t exist.
string
required
Contract address for the NFT contract (ERC721 and ERC1155 supported). Must be a valid Ethereum address.
integer
Timeout (in milliseconds) for the website hosting the metadata to respond. Set to 0 to only access cache and not live fetch metadata for cache misses.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_GET_NFT_METADATA_BATCHRetrieves metadata for up to 100 NFTs on Ethereum mainnet in a single request, including available contract details, media URLs, attributes, and collection data.

Input Parameters

array
required
List of token objects to batch request NFT metadata for. Maximum 100 tokens per request.
boolean
If true, will refresh metadata for the given tokens. If false (default), will check cache first and use it or refresh if cache doesn’t exist.
integer
Timeout (in milliseconds) for the website hosting the metadata to respond. Set to 0 to only access cache and not live fetch metadata for cache misses.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_GET_NFT_SALES_V3Retrieves 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.

Input Parameters

integer
Maximum number of sales to return. Defaults to 100
string ("asc" | "desc")
Sort order for NFT sales results.
string ("BUYER" | "SELLER")
Taker role in NFT trade.
string
Pagination key returned from a previous response. Use to fetch the next page of results
string
Ending block number to fetch NFT sales to. Accepts decimal integers, hex integers, or ‘latest’. Defaults to ‘latest’
string
Filter by specific token ID. Can be in hex or decimal format. Must be used with contract_address
string
Starting block number to fetch NFT sales from. Accepts decimal integers, hex integers (e.g., ‘0x0’), or ‘latest’. Defaults to ‘0’
string ("seaport" | "looksrare" | "x2y2" | "wyvern" | "blur" | "cryptopunks")
Supported NFT marketplaces.
string
Filter sales by buyer’s Ethereum address. Returns sales involving any buyer if not specified
string
Filter sales by seller’s Ethereum address. Returns sales involving any seller if not specified
string
Filter by NFT contract address (supports ERC721 and ERC1155). Returns sales for all contracts if not specified

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_GET_NF_TS_FOR_COLLECTION_V3Retrieves NFTs in an Ethereum mainnet collection using an OpenSea collection slug or contract address. Supports pagination and optional metadata.

Input Parameters

integer
Number of NFTs to return. Defaults to 100
string
Token ID offset for pagination. Can be hex or decimal. Use nextToken from previous response
boolean
If true, returns NFT metadata. Setting to false reduces payload size and may result in faster response. Defaults to true
string
OpenSea slug for the NFT collection. Required if contract_address is not provided
string
Contract address for the NFT collection (ERC721 and ERC1155 supported). Required if collection_slug is not provided
integer
Timeout in milliseconds for fetching token metadata. Set to 0 to only use cached data. No timeout by default

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_GET_NF_TS_FOR_CONTRACTRetrieves 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.

Input Parameters

integer
Sets the total number of NFTs returned in the response. Defaults to 100. Maximum is 100
string
Token ID to start pagination from. Supports both hex (0x…) and decimal format. Use the pageKey from previous response
boolean
When true, returns NFT metadata. Set to false to reduce payload size. Defaults to true
string
required
The contract address of the NFT collection (supports ERC721 and ERC1155)
integer
Timeout in milliseconds for fetching token metadata. Set to 0 to only use cached data

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_GET_NF_TS_FOR_OWNERRetrieves NFTs owned by an address on Ethereum mainnet, supporting ERC721 and ERC1155 tokens, optional metadata, filtering, and pagination.

Input Parameters

string
required
Address for NFT owner (can be in ENS format for Eth Mainnet)
string ("transferTime")
Ordering scheme for NFTs in the response
string
Key for pagination. If more results are available, a pageKey will be returned in the response. Pass back the pageKey as a param to fetch the next page of results
integer
Number of NFTs to be returned per page. Defaults to 100. Max is 100
boolean
If set to true, returns NFT metadata. Setting this to false will reduce payload size and may result in a faster API call. Defaults to true
array
Array of filters that will be applied to the query. NFTs that match one or more of these filters will be excluded from the response. May not be used in conjunction with includeFilters. Options: SPAM (NFTs classified as spam), AIRDROPS (NFTs that were airdropped to the user)
array
Array of filters that will be applied to the query. Only NFTs that match one or more of these filters will be included in the response. May not be used in conjunction with excludeFilters. Options: SPAM (NFTs classified as spam), AIRDROPS (NFTs that were airdropped to the user)
array
Array of contract addresses to filter the responses with. Max limit 45 contracts
string ("VERY_HIGH" | "HIGH" | "MEDIUM" | "LOW")
Confidence level for spam filtering
integer
Timeout in milliseconds for the website hosting the metadata to respond when metadata is requested. Set to 0 to only access the cache and not live fetch any metadata for cache misses

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_GET_OWNERS_FOR_COLLECTIONRetrieves 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.

Input Parameters

string
Key for pagination. If more results are available, a pageKey will be returned in the response. Pass back the pageKey as a param to fetch the next page of results
string
required
Contract address for the NFT contract (ERC721 and ERC1155 supported)
boolean
If set to true, the query will include the token balances per token id for each owner. False by default

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_GET_OWNERS_FOR_CONTRACTRetrieves owners of NFTs in an Ethereum mainnet contract, with optional token balances and pagination. Use for NFT holder distribution and ownership analysis.

Input Parameters

string
Key for pagination. Pass back the pageKey from previous response to fetch the next page of results
string
required
Contract address for the NFT contract (supports ERC721 and ERC1155)
boolean
If true, includes token balances per token ID for each owner. Defaults to false

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_GET_OWNERS_FOR_NFTV3Retrieves owner addresses for a specific Ethereum mainnet NFT using Alchemy’s v3 API.

Input Parameters

string
required
The ID of the token. Can be in hex or decimal format
string
required
Contract address for the NFT contract (ERC721 and ERC1155 supported). Must be a valid Ethereum address

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_GET_PORTFOLIO_NF_TS_BY_ADDRESSTool 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.

Input Parameters

string ("transferTime")
Order by field.
string
Pagination key from previous response to fetch next page of results
integer
Number of results per page (default 100, max 100)
array
required
Array of address and networks pairs (limit 2 pairs, max 15 networks each)
string ("asc" | "desc")
Sort order for results.
boolean
Include NFT metadata in response. Default true
array
Filter out SPAM or AIRDROPS. Default: SPAM
array
Include SPAM or AIRDROPS in results
string ("VERY_HIGH" | "HIGH" | "MEDIUM" | "LOW")
Spam confidence levels.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_GET_PRICES_BY_SYMBOLTool 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.

Input Parameters

array
required
Array of token symbols to fetch prices for (e.g., [‘ETH’, ‘BTC’, ‘USDC’]). Maximum 25 symbols per request. Symbols are case-insensitive.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_GET_TOKEN_BALANCESThis 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.

Input Parameters

string
required
The Ethereum wallet address (40 hex characters with 0x prefix) to get ERC-20 token balances for
string
Pagination key from a previous response’s pageKey field. Use this to retrieve the next page of results when there are more tokens than max_count.
integer
Maximum number of token balances to return per request. Must be between 1 and 1000. Default is 100 if not specified.
array
Optional list of specific ERC-20 token contract addresses to check balances for. If not provided, returns balances for all tokens the address has interacted with. Each address must be a 40 hex character string with 0x prefix.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_GET_TOKEN_BALANCES_BY_ADDRESSTool 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.

Input Parameters

string
Cursor for pagination through results. Use the pageKey returned from a previous request to get the next page of results.
array
required
Array of address and network pairs to check balances for. Maximum 3 address pairs, with up to 20 networks per address.
boolean
Whether to include ERC-20 tokens. Default is true.
boolean
Whether to include chain native tokens (e.g., ETH on Ethereum). Default is true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_GET_TOKEN_METADATARetrieves Ethereum mainnet ERC-20 token metadata, including available name, symbol, decimals, and logo URL, for display and token amount conversion.

Input Parameters

string
required
The Ethereum contract address of the ERC-20 token (e.g., ‘0xdAC17F958D2ee523a2206206994597C13D831ec7’ for USDT). Must be a valid 20-byte hexadecimal address starting with ‘0x’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_GET_TOKEN_PRICES_BY_ADDRESSRetrieves 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.

Input Parameters

array
required
Array of token network and address pairs. Maximum 25 addresses per request, maximum 3 different networks. Each entry specifies a network and contract address to fetch price for.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_GET_TOKENS_BY_ADDRESSTool 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.

Input Parameters

string
Cursor for pagination through results. Use the pageKey returned from a previous request to get the next page of results.
array
required
Array of address and network pairs to fetch tokens for. Maximum 2 addresses, with up to 5 networks per address.
boolean
Whether to include token prices in USD and other currencies. Default is true. Set to false for faster responses with smaller payloads.
boolean
Whether to include token metadata (decimals, logo, name, symbol). Default is true. Set to false for faster responses with smaller payloads.
boolean
Whether to include ERC-20 tokens. Default is true. Set to false for faster responses with smaller payloads.
boolean
Whether to include chain native tokens (e.g., ETH on Ethereum, MATIC on Polygon). Default is true. Native tokens have a null contract address.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_GET_TRANSACTION_COUNTRetrieves 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.

Input Parameters

string
required
The Ethereum address to get the transaction count for
string
The block number or tag to get the transaction count from

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_GET_TRANSACTIONS_HISTORY_BY_ADDRESSRetrieves 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.

Input Parameters

string
Cursor pointing to the end of the current result set for forward pagination.
integer
Number of items to return per page. Maximum 50, defaults to 25 if not specified.
string
Cursor pointing to the start of the previous result set for backward pagination.
string
Pagination key for fetching the next page of results. Use the pageKey returned from a previous request.
array
required
Array of address and network pairs to query transaction history for. Maximum 1 address pair, with up to 2 networks per address.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_INVALIDATE_CONTRACT_V3Tool 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.

Input Parameters

string
The blockchain network to use. Examples: ‘eth-mainnet’, ‘eth-sepolia’, ‘polygon-mainnet’, ‘arb-mainnet’, ‘opt-mainnet’, ‘base-mainnet’.
string
required
Contract address for the NFT contract (ERC721 and ERC1155 supported). Invalidating the cache forces a refresh of metadata on the next request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_IS_AIRDROPTool 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.

Input Parameters

string
required
The ID of the token. Can be in hex or decimal format.
string
required
Contract address for the NFT contract (ERC721 and ERC1155 supported). Must be a valid Ethereum address.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_IS_AIRDROP_NFTCheck whether a specified NFT is marked as an airdrop using its contract address and token ID on Ethereum mainnet.

Input Parameters

string
required
The ID of the token. Can be in hex or decimal format
string
required
Contract address for the NFT contract (ERC721 and ERC1155 supported)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_IS_HOLDER_OF_COLLECTIONTool 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.

Input Parameters

string
required
Address for NFT owner (can be in ENS format for Eth Mainnet)
string
required
Contract address for the NFT contract (ERC721 and ERC1155 supported)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_IS_HOLDER_OF_CONTRACTTool 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.

Input Parameters

string
required
Wallet address to check for contract ownership
string
required
Contract address for the NFT contract (ERC721 and ERC1155 supported)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_IS_SPAM_CONTRACTTool 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.

Input Parameters

string
required
Contract address for the NFT contract (ERC721 and ERC1155 supported). Must be a valid Ethereum address.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_IS_SPAM_CONTRACT_V3Tool 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.

Input Parameters

string
required
Contract address for the NFT contract (ERC721 and ERC1155 supported). Must be a valid Ethereum address.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_SEARCH_CONTRACT_METADATA_V3Search Ethereum mainnet NFT contract metadata by keywords to find collections. Results may include contract addresses, names, symbols, token types, deployer information, and OpenSea metadata.

Input Parameters

string
required
The search string to search for in contract metadata. Searches across contract names, symbols, and descriptions

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ALCHEMY_SUMMARIZE_NFT_ATTRIBUTESRetrieves a summary of NFT attributes for an Ethereum mainnet collection, including trait value counts. Use it to analyze collection composition and build trait filters.

Input Parameters

string
required
The contract address of the NFT collection (supports ERC721 and ERC1155)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not