# Alchemy

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

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 36
- **Triggers:** 0
- **Slug:** `ALCHEMY`
- **Version:** 20260312_00

## Tools

### Compute NFT Rarity

**Slug:** `ALCHEMY_COMPUTE_RARITY_V3`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tokenId` | string | Yes | The ID of the specific NFT token within the collection. Can be provided in hexadecimal (e.g., '0x2c') or decimal format (e.g., '44'). |
| `contractAddress` | string | Yes | The Ethereum contract address for the NFT collection. Supports both ERC721 and ERC1155 standards. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get NFT Collection Metadata

**Slug:** `ALCHEMY_GET_COLLECTION_METADATA`

Tool to get metadata for an NFT collection using its marketplace slug (OpenSea, LooksRare, etc). Use when you need collection-level information such as name, description, social links, and floor price. This is useful for discovering collection details without needing the contract address.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `collectionSlug` | string | Yes | OpenSea slug for the NFT collection (e.g., 'boredapeyachtclub', 'cryptopunks') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Collections for Owner

**Slug:** `ALCHEMY_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `owner` | string | Yes | Address for NFT owner (can be in ENS format for Ethereum Mainnet). This is the wallet address whose NFT collections you want to retrieve |
| `pageKey` | string | No | 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 |
| `pageSize` | integer | No | Number of NFT collections to be returned per page. Defaults to 100. Max is 100 |
| `withMetadata` | boolean | No | If set to true, returns NFT metadata. Setting to false reduces payload size and may result in faster API calls. Defaults to true |
| `excludeFilters` | array | No | 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 |
| `includeFilters` | array | No | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Contract Metadata Batch V3

**Slug:** `ALCHEMY_GET_CONTRACT_METADATA_BATCH_V3`

Tool to retrieve metadata for multiple NFT contracts in a single batch request. Use when you need to fetch contract information for several NFT collections at once to improve efficiency and reduce API calls.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contractAddresses` | array | Yes | List of contract addresses to batch metadata requests for. Supports both ERC721 and ERC1155 contracts. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Contract Metadata V3

**Slug:** `ALCHEMY_GET_CONTRACT_METADATA_V3`

Tool to get the metadata for an NFT contract including name, symbol, total supply, and token type (ERC721/ERC1155). Use when you need to retrieve comprehensive contract information such as deployer address, deployment block, OpenSea metadata, and collection details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contractAddress` | string | Yes | Contract address for the NFT contract (ERC721 and ERC1155 supported). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Contracts for Owner (NFT API v3)

**Slug:** `ALCHEMY_GET_CONTRACTS_FOR_OWNER_V3`

Tool to get all NFT contracts owned by an address with contract metadata. Use when you need to retrieve a comprehensive list of NFT collections held by a specific wallet address, including detailed contract information such as token type, total supply, deployer info, spam classification, and OpenSea metadata. Supports pagination for addresses with large NFT holdings.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `owner` | string | Yes | Address for NFT owner (can be in ENS format for Eth Mainnet) |
| `orderBy` | string ("transferTime") | No | Ordering scheme for NFTs |
| `pageKey` | string | No | 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 |
| `pageSize` | integer | No | Number of NFTs to be returned per page. Defaults to 100. Max is 100 |
| `withMetadata` | boolean | No | 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 |
| `excludeFilters` | array | No | 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 |
| `includeFilters` | array | No | 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 |
| `spamConfidenceLevel` | string ("VERY_HIGH" | "HIGH" | "MEDIUM" | "LOW") | No | Spam confidence levels |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get NFT Floor Price

**Slug:** `ALCHEMY_GET_FLOOR_PRICE_V3`

Tool to get the floor price for an NFT collection across multiple marketplaces (OpenSea, LooksRare, etc). Use when you need to check the current floor price of an NFT collection or compare prices across different marketplaces. Returns floor price data including price, currency, collection URL, and timestamp of when the price was retrieved.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `collectionSlug` | string | No | OpenSea slug for the NFT collection. Optional parameter to help identify the collection |
| `contractAddress` | string | Yes | Contract address for the NFT contract (ERC721 and ERC1155 supported) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Historical Token Prices

**Slug:** `ALCHEMY_GET_HISTORICAL_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).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `symbol` | string | No | Token symbol to query (e.g., 'ETH', 'BTC', 'USDC'). Required if network and address are not provided. Cannot be used together with network/address. |
| `address` | string | No | Token contract address on the specified network. Required if symbol is not provided. Must be used together with network. |
| `network` | string | No | Blockchain network identifier (e.g., 'eth-mainnet', 'polygon-mainnet'). Required if symbol is not provided. Must be used together with address. |
| `end_time` | string | Yes | 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. |
| `interval` | string ("5m" | "1h" | "1d") | No | Supported interval types for historical price data |
| `start_time` | string | Yes | 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. |
| `with_market_data` | boolean | No | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get NFT Contracts By Address

**Slug:** `ALCHEMY_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.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get NFT Metadata

**Slug:** `ALCHEMY_GET_NFT_METADATA`

Tool to retrieve comprehensive metadata for a specific NFT, including contract details, media URLs, attributes, ownership info, and OpenSea data. Use when you need detailed information about a particular NFT token, such as its image, traits, description, or contract metadata.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tokenId` | string | Yes | The ID of the token. Can be in hex or decimal format. |
| `tokenType` | string ("ERC721" | "ERC1155") | No | NFT token standard types |
| `refreshCache` | boolean | No | 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. |
| `contractAddress` | string | Yes | Contract address for the NFT contract (ERC721 and ERC1155 supported). Must be a valid Ethereum address. |
| `tokenUriTimeoutInMs` | integer | No | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get NFT Metadata Batch

**Slug:** `ALCHEMY_GET_NFT_METADATA_BATCH`

Tool to retrieve metadata for multiple NFTs in a single request (up to 100 NFTs), including contract details, media URLs, attributes, and collection data. Use when you need detailed information about multiple NFT tokens efficiently. More efficient than making individual calls for each NFT.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tokens` | array | Yes | List of token objects to batch request NFT metadata for. Maximum 100 tokens per request. |
| `refreshCache` | boolean | No | 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. |
| `tokenUriTimeoutInMs` | integer | No | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get NFT Sales V3

**Slug:** `ALCHEMY_GET_NFT_SALES_V3`

Retrieves NFT sales that have occurred through on-chain marketplaces using Alchemy's v3 API. Supports Ethereum (Seaport, Wyvern, X2Y2, Blur, LooksRare, Cryptopunks), Polygon (Seaport), and Optimism (Seaport) mainnets. Use this to track NFT sales activity, analyze market trends, monitor specific collections or tokens, and gather comprehensive sales data including prices, fees, and transaction details. Supports flexible filtering by block range, marketplace, contract, token, buyer, seller, and taker role.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get NFTs for Collection V3

**Slug:** `ALCHEMY_GET_NF_TS_FOR_COLLECTION_V3`

Retrieves all NFTs in a collection using OpenSea collection slug or contract address. Use when you need to fetch NFTs by collection name rather than contract address. Similar to getNFTsForContract but uses collection slug for easier querying. Supports pagination for large collections.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get NFTs for Contract

**Slug:** `ALCHEMY_GET_NF_TS_FOR_CONTRACT`

Retrieves all NFTs for a given NFT contract address. Supports both ERC721 and ERC1155 token standards. Returns detailed NFT data including token IDs, metadata, images, and attributes. Use this to analyze NFT collections, build marketplace features, track collection holdings, or create analytics dashboards. Supports pagination to handle large collections efficiently (returns up to 100 NFTs per request).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Sets the total number of NFTs returned in the response. Defaults to 100. Maximum is 100 |
| `start_token` | string | No | Token ID to start pagination from. Supports both hex (0x...) and decimal format. Use the pageKey from previous response |
| `with_metadata` | boolean | No | When true, returns NFT metadata. Set to false to reduce payload size. Defaults to true |
| `contract_address` | string | Yes | The contract address of the NFT collection (supports ERC721 and ERC1155) |
| `token_uri_timeout_ms` | integer | No | Timeout in milliseconds for fetching token metadata. Set to 0 to only use cached data |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get NFTs for Owner

**Slug:** `ALCHEMY_GET_NF_TS_FOR_OWNER`

Tool to get all NFTs currently owned by a given address. Supports ERC721 and ERC1155 tokens on Ethereum and L2s including Polygon, Arbitrum, Optimism, Base. Use when you need to retrieve NFT holdings for an address with optional metadata.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `owner` | string | Yes | Address for NFT owner (can be in ENS format for Eth Mainnet) |
| `orderBy` | string ("transferTime") | No | Ordering scheme for NFTs in the response |
| `pageKey` | string | No | 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 |
| `pageSize` | integer | No | Number of NFTs to be returned per page. Defaults to 100. Max is 100 |
| `withMetadata` | boolean | No | 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 |
| `excludeFilters` | array | No | 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) |
| `includeFilters` | array | No | 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) |
| `contractAddresses` | array | No | Array of contract addresses to filter the responses with. Max limit 45 contracts |
| `spamConfidenceLevel` | string ("VERY_HIGH" | "HIGH" | "MEDIUM" | "LOW") | No | Confidence level for spam filtering |
| `tokenUriTimeoutInMs` | integer | No | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Owners for Collection

**Slug:** `ALCHEMY_GET_OWNERS_FOR_COLLECTION`

Tool to retrieve all owner addresses for a given NFT collection contract. Use when you need to analyze NFT ownership distribution, find all holders of a collection, or build ownership analytics for ERC721 and ERC1155 contracts. Optionally returns token balances per owner.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `pageKey` | string | No | 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 |
| `contractAddress` | string | Yes | Contract address for the NFT contract (ERC721 and ERC1155 supported) |
| `withTokenBalances` | boolean | No | If set to true, the query will include the token balances per token id for each owner. False by default |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Owners for Contract

**Slug:** `ALCHEMY_GET_OWNERS_FOR_CONTRACT`

Tool to get all owners of NFTs in a contract with optional token balances. Use when you need to analyze NFT holder distribution, prepare airdrops, or identify token owners for specific collections.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `pageKey` | string | No | Key for pagination. Pass back the pageKey from previous response to fetch the next page of results |
| `contractAddress` | string | Yes | Contract address for the NFT contract (supports ERC721 and ERC1155) |
| `withTokenBalances` | boolean | No | If true, includes token balances per token ID for each owner. Defaults to false |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get NFT Owners (v3)

**Slug:** `ALCHEMY_GET_OWNERS_FOR_NFTV3`

Tool to retrieve all owners for a specific NFT using Alchemy's v3 API. For ERC-721 tokens returns single owner, for ERC-1155 tokens returns all owners with quantities. Use when you need to identify current ownership of an NFT token.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tokenId` | string | Yes | The ID of the token. Can be in hex or decimal format |
| `contractAddress` | string | Yes | Contract address for the NFT contract (ERC721 and ERC1155 supported). Must be a valid Ethereum address |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Portfolio NFTs By Address

**Slug:** `ALCHEMY_GET_PORTFOLIO_NF_TS_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `orderBy` | string ("transferTime") | No | Order by field. |
| `pageKey` | string | No | Pagination key from previous response to fetch next page of results |
| `pageSize` | integer | No | Number of results per page (default 100, max 100) |
| `addresses` | array | Yes | Array of address and networks pairs (limit 2 pairs, max 15 networks each) |
| `sortOrder` | string ("asc" | "desc") | No | Sort order for results. |
| `withMetadata` | boolean | No | Include NFT metadata in response. Default true |
| `excludeFilters` | array | No | Filter out SPAM or AIRDROPS. Default: SPAM |
| `includeFilters` | array | No | Include SPAM or AIRDROPS in results |
| `spamConfidenceLevel` | string ("VERY_HIGH" | "HIGH" | "MEDIUM" | "LOW") | No | Spam confidence levels. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Token Prices By Symbol

**Slug:** `ALCHEMY_GET_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `symbols` | array | Yes | Array of token symbols to fetch prices for (e.g., ['ETH', 'BTC', 'USDC']). Maximum 25 symbols per request. Symbols are case-insensitive. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Token Balances

**Slug:** `ALCHEMY_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `address` | string | Yes | The Ethereum wallet address (40 hex characters with 0x prefix) to get ERC-20 token balances for |
| `page_key` | string | No | 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. |
| `max_count` | integer | No | Maximum number of token balances to return per request. Must be between 1 and 1000. Default is 100 if not specified. |
| `contract_addresses` | array | No | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Token Balances By Address

**Slug:** `ALCHEMY_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.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Token Metadata

**Slug:** `ALCHEMY_GET_TOKEN_METADATA`

Retrieves metadata for an ERC-20 token on Ethereum mainnet, including its name, symbol, decimals, and logo URL. This information is essential for displaying token details in user interfaces, calculating token amounts (using decimals), and showing token branding. Use this when you need to: - Display token information to users (name, symbol, logo) - Convert token amounts between human-readable and contract formats (requires decimals) - Build token listings or portfolio displays - Validate or enrich token data Note: Returns empty/null values for invalid or non-token contract addresses.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contract_address` | string | Yes | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Token Prices By Address

**Slug:** `ALCHEMY_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `addresses` | array | Yes | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Tokens By Address

**Slug:** `ALCHEMY_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `pageKey` | string | No | Cursor for pagination through results. Use the pageKey returned from a previous request to get the next page of results. |
| `addresses` | array | Yes | Array of address and network pairs to fetch tokens for. Maximum 2 addresses, with up to 5 networks per address. |
| `withPrices` | boolean | No | Whether to include token prices in USD and other currencies. Default is true. Set to false for faster responses with smaller payloads. |
| `withMetadata` | boolean | No | Whether to include token metadata (decimals, logo, name, symbol). Default is true. Set to false for faster responses with smaller payloads. |
| `includeErc20Tokens` | boolean | No | Whether to include ERC-20 tokens. Default is true. Set to false for faster responses with smaller payloads. |
| `includeNativeTokens` | boolean | No | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Transaction Count

**Slug:** `ALCHEMY_GET_TRANSACTION_COUNT`

This tool retrieves the number of transactions sent from a specific address (also known as the nonce). It uses the eth_getTransactionCount endpoint to return the transaction count for an address at a specified block tag (latest, pending, earliest, or a HEX block number), which is essential for determining the nonce for subsequent transactions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `address` | string | Yes | The Ethereum address to get the transaction count for |
| `block_tag` | string | No | The block number or tag to get the transaction count from |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Transactions History By Address

**Slug:** `ALCHEMY_GET_TRANSACTIONS_HISTORY_BY_ADDRESS`

Tool to get transaction history for wallet addresses across multiple networks using Alchemy's Data API. Use when you need to retrieve historical transactions with detailed metadata including logs and internal transactions. Supports pagination for large result sets with a maximum of 50 transactions per request.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Invalidate NFT Contract Cache

**Slug:** `ALCHEMY_INVALIDATE_CONTRACT_V3`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `network` | string | No | The blockchain network to use. Examples: 'eth-mainnet', 'eth-sepolia', 'polygon-mainnet', 'arb-mainnet', 'opt-mainnet', 'base-mainnet'. |
| `contractAddress` | string | Yes | Contract address for the NFT contract (ERC721 and ERC1155 supported). Invalidating the cache forces a refresh of metadata on the next request. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Check If NFT Is Airdrop

**Slug:** `ALCHEMY_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tokenId` | string | Yes | The ID of the token. Can be in hex or decimal format. |
| `contractAddress` | string | Yes | Contract address for the NFT contract (ERC721 and ERC1155 supported). Must be a valid Ethereum address. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Check If NFT Is Airdrop

**Slug:** `ALCHEMY_IS_AIRDROP_NFT`

Tool to determine whether an NFT was airdropped to the owner address. Use when you need to identify if a specific token was received as an airdrop rather than through a purchase or mint.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tokenId` | string | Yes | The ID of the token. Can be in hex or decimal format |
| `contractAddress` | string | Yes | Contract address for the NFT contract (ERC721 and ERC1155 supported) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Check Collection Ownership

**Slug:** `ALCHEMY_IS_HOLDER_OF_COLLECTION`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `wallet` | string | Yes | Address for NFT owner (can be in ENS format for Eth Mainnet) |
| `contractAddress` | string | Yes | Contract address for the NFT contract (ERC721 and ERC1155 supported) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Check NFT Holder Status

**Slug:** `ALCHEMY_IS_HOLDER_OF_CONTRACT`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `wallet` | string | Yes | Wallet address to check for contract ownership |
| `contract_address` | string | Yes | Contract address for the NFT contract (ERC721 and ERC1155 supported) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Check if Contract is Spam

**Slug:** `ALCHEMY_IS_SPAM_CONTRACT`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contractAddress` | string | Yes | Contract address for the NFT contract (ERC721 and ERC1155 supported). Must be a valid Ethereum address. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Check if Contract is Spam (V3)

**Slug:** `ALCHEMY_IS_SPAM_CONTRACT_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contractAddress` | string | Yes | Contract address for the NFT contract (ERC721 and ERC1155 supported). Must be a valid Ethereum address. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search NFT Contract Metadata

**Slug:** `ALCHEMY_SEARCH_CONTRACT_METADATA_V3`

Tool to search for keywords across metadata of all ERC-721 and ERC-1155 smart contracts. Use when you need to find NFT collections by name, symbol, or description keywords. Returns contract addresses, names, symbols, token types, deployer info, and OpenSea metadata for matching collections.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | Yes | The search string to search for in contract metadata. Searches across contract names, symbols, and descriptions |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Summarize NFT Attributes

**Slug:** `ALCHEMY_SUMMARIZE_NFT_ATTRIBUTES`

Retrieves a comprehensive summary of all attributes and traits for NFTs in a collection, including trait counts and distribution statistics. Use this to analyze rarity, understand collection composition, or build trait filters for NFT marketplaces and analytics dashboards.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contract_address` | string | Yes | The contract address of the NFT collection (supports ERC721 and ERC1155) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |