The Alchemy connector lets your AI agent act in each user's Alchemy account. Each user connects their own Alchemy API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 60 tools.
- Tools
- 60
- What they doRead · write · destructive
- 56 · 4 · 056 read4 write0 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Alchemy connection
In AgentKit > Connections, create an Alchemy connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'alchemy'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Alchemy:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'alchemy_block_number_get',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "alchemy"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Alchemy:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="alchemy_block_number_get",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Alchemy credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolalchemy_access_list_createBuild an EIP-2930 access list for a transaction (eth_createAccessList).Read-onlyCreate Access List
Build an EIP-2930 access list for a transaction (eth_createAccessList). Returns the access list and the gas used with it. Use Estimate Gas for a plain gas estimate.
Inputs
tostringrequired- Address the call is sent to. Example: 0xA0b86991c6218b36c1d19d4a2e9eB0cE3606eB48.
blockstring- Block number in hex (for example 0x10d4f), or a tag: latest (default), safe, finalized, earliest or pending. Example: latest.
datastring- Hex-encoded call data: method signature hash and encoded arguments. Example: 0x70a08231000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045.
fromstring- Address the call is sent from. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
gasstring- Gas limit, as hex. Example: 0x5208.
gas_pricestring- Gas price in wei, as hex. Rarely needed. Example: 0x9184e72a000.
valuestring- Value to send, in wei, as hex. Example: 0x0.
alchemy_airdrop_nft_checkCheck whether an NFT was airdropped (minted to the holder by another sender).Read-onlyIs Airdrop NFT
Check whether an NFT was airdropped (minted to the holder by another sender). Returns isAirdrop true or false. Use Get NFTs for Owner with exclude_filters AIRDROPS to hide airdrops.
Inputs
contract_addressstringrequired- Contract address of the NFT collection (ERC-721 or ERC-1155). Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.
token_idstringrequired- Token ID, in decimal or hex. Example: 44.
alchemy_asset_transfers_getGet the history of native, internal and token transfers to or from an address (alchemy_getAssetTransfers).Read-onlyGet Asset Transfers
Get the history of native, internal and token transfers to or from an address (alchemy_getAssetTransfers). Returns transfers with block, hash, from, to, value, asset and category, plus pageKey. Use Get Wallet Transaction History for full transactions across networks.
Inputs
categoryarrayrequired- Transfer types: external, internal, erc20, erc721, erc1155, specialnft. internal is only on Ethereum and Polygon mainnet. Example: ["external", "erc20"].
contract_addressesarray- Only token transfers from these contracts (erc20, erc721, erc1155). Example: ["0xA0b86991c6218b36c1d19d4a2e9eB0cE3606eB48"].
exclude_zero_valueboolean- Skip zero-value transfers. Defaults to true. Example: true.
from_addressstring- Only transfers sent from this address. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
from_blockstring- First block, hex or latest. Defaults to 0x0. Example: 0x0.
max_countstring- Maximum results per page, as hex, up to 0x3e8 (1000). Example: 0x64.
orderstring- asc (default) or desc by block. Example: desc.one of
ascdesc page_keystring- Pagination key from the previous call. Example: 8f1c2d3e-4b5a-6978-8a9b-0c1d2e3f4a5b.
to_addressstring- Only transfers sent to this address. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
to_blockstring- Last block, hex or latest. Defaults to latest. Example: latest.
with_metadataboolean- Include block timestamps. Example: true.
alchemy_balance_getGet an address's native coin balance (for example ETH) at a block (eth_getBalance).Read-onlyGet Balance
Get an address's native coin balance (for example ETH) at a block (eth_getBalance). Returns the balance in wei as hex. Use Get Token Balances for ERC-20 tokens.
Inputs
addressstringrequired- Account or contract address (20 bytes, hex). Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
blockstring- Block number in hex (for example 0x10d4f), or a tag: latest (default), safe, finalized, earliest or pending. Example: latest.
alchemy_block_by_hash_getGet a block by its hash (eth_getBlockByHash).Read-onlyGet Block by Hash
Get a block by its hash (eth_getBlockByHash). Returns the block header and its transaction hashes, or full transactions. Use Get Block by Number for a block number or tag.
Inputs
block_hashstringrequired- Block hash (32 bytes, hex). Example: 0xb3b20624f8f0f86eb50dd04688409e5cea4bd02d700bf6e79e9384d47d6a5a35.
full_transactionsboolean- true returns full transaction objects; false (default) returns only hashes. Example: false.
alchemy_block_by_number_getGet a block by number or tag (eth_getBlockByNumber).Read-onlyGet Block by Number
Get a block by number or tag (eth_getBlockByNumber). Returns the block header and its transaction hashes, or full transactions. Use Get Block by Hash when you have the hash.
Inputs
blockstringrequired- Block number in hex, or a tag: latest, safe, finalized, earliest or pending. Example: latest.
full_transactionsboolean- true returns full transaction objects; false (default) returns only hashes. Example: false.
alchemy_block_by_timestamp_getFind the first block before or after a timestamp on one or more networks.Read-onlyGet Block by Timestamp
Find the first block before or after a timestamp on one or more networks. Returns each network's block number and on-chain timestamp. Use it to turn dates into block ranges for Get Logs or Get Asset Transfers.
Inputs
directionstringrequired- Return the first block "BEFORE" or "AFTER" the provided timestamp. Example: BEFORE.one of
BEFOREAFTER networksarrayrequired- Network IDs to query, for example eth-mainnet or base-mainnet. Example: ["eth-mainnet"].
timestampstringrequired- Unix or ISO timestamp. Example: 2026-11-01T00:00:00Z.
alchemy_block_number_getGet the latest block number on the connection's network (eth_blockNumber).Read-onlyGet Block Number
Get the latest block number on the connection's network (eth_blockNumber). Returns the block number as a hex string. Use Get Block by Number for the block's contents.
Inputs
This tool takes no inputs.
alchemy_block_receipts_getGet the receipts of every transaction in a block (eth_getBlockReceipts).Read-onlyGet Block Receipts
Get the receipts of every transaction in a block (eth_getBlockReceipts). Returns a list of receipts with status, gas used and logs. Use Get Transaction Receipt for one transaction.
Inputs
blockstringrequired- Block number in hex, block hash, or a tag such as latest. Example: latest.
alchemy_callRun a read-only contract call at a block without sending a transaction (eth_call).Read-onlyCall Contract
Run a read-only contract call at a block without sending a transaction (eth_call). Returns the hex-encoded return data. Use Estimate Gas to price a real transaction.
Inputs
tostringrequired- Address the call is sent to. Example: 0xA0b86991c6218b36c1d19d4a2e9eB0cE3606eB48.
blockstring- Block number in hex (for example 0x10d4f), or a tag: latest (default), safe, finalized, earliest or pending. Example: latest.
datastring- Hex-encoded call data: method signature hash and encoded arguments. Example: 0x70a08231000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045.
fromstring- Address the call is sent from. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
gasstring- Gas limit, as hex. Example: 0x5208.
gas_pricestring- Gas price in wei, as hex. Rarely needed. Example: 0x9184e72a000.
valuestring- Value to send, in wei, as hex. Example: 0x0.
alchemy_chain_id_getGet the chain ID of the connection's network (eth_chainId).Read-onlyGet Chain ID
Get the chain ID of the connection's network (eth_chainId). Returns the chain ID as hex (0x1 for Ethereum mainnet). Use Get Network Version for the legacy network ID.
Inputs
This tool takes no inputs.
alchemy_client_version_getGet the node client version (web3_clientVersion).Read-onlyGet Client Version
Get the node client version (web3_clientVersion). Returns the client version string. Use it to check the connection works.
Inputs
This tool takes no inputs.
alchemy_code_getGet the bytecode deployed at an address (eth_getCode).Read-onlyGet Contract Code
Get the bytecode deployed at an address (eth_getCode). Returns the code as hex, or 0x for a wallet with no code. Use it to tell contracts from regular accounts.
Inputs
addressstringrequired- Account or contract address (20 bytes, hex). Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
blockstring- Block number in hex (for example 0x10d4f), or a tag: latest (default), safe, finalized, earliest or pending. Example: latest.
alchemy_collection_metadata_getGet an NFT collection's metadata by OpenSea slug.Read-onlyGet Collection Metadata
Get an NFT collection's metadata by OpenSea slug. Returns name, slug, description, image, external URL and floor price. Use Get Contract Metadata when you have the contract address.
Inputs
collection_slugstringrequired- OpenSea collection slug. Example: boredapeyachtclub.
alchemy_collections_for_owner_getList the NFT collections a wallet holds tokens from.Read-onlyGet Collections for Owner
List the NFT collections a wallet holds tokens from. Returns collections with name, slug, floor price and number owned, plus pageKey. Use Get Contracts for Owner for a per-contract view.
Inputs
ownerstringrequired- Wallet address of the NFT owner (an ENS name also works on Ethereum mainnet). Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
exclude_filtersarray- Exclude NFTs that match these filters: SPAM or AIRDROPS. Example: ["SPAM"].
include_filtersarray- Only include NFTs that match these filters: SPAM or AIRDROPS. Example: ["AIRDROPS"].
page_keystring- Pagination key returned as pageKey by the previous call. Omit for the first page. Example: 0x0000000000000000000000000000000000000000000000000000000000000065.
page_sizeinteger- Number of NFTs to be returned per page. Defaults to 100. Max is 100. Example: 50.
with_metadataboolean- true returns NFT metadata; false makes the response smaller and faster. Example: true.
alchemy_contract_metadata_batch_getGet metadata for several NFT contracts in one call.Read-onlyGet Contract Metadata Batch
Get metadata for several NFT contracts in one call. Returns each contract's name, symbol, supply, token type and OpenSea data. Use Get Contract Metadata for one contract.
Inputs
contract_addressesarrayrequired- Only NFTs from these contract addresses (up to 45). Example: ["0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"].
alchemy_contract_metadata_getGet an NFT contract's metadata.Read-onlyGet Contract Metadata
Get an NFT contract's metadata. Returns name, symbol, total supply, token type, deployer and OpenSea collection data such as floor price. Use Get Contract Metadata Batch for several contracts.
Inputs
contract_addressstringrequired- Contract address of the NFT collection (ERC-721 or ERC-1155). Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.
alchemy_contract_metadata_searchSearch NFT contract metadata (names, descriptions) for a keyword.Read-onlySearch Contract Metadata
Search NFT contract metadata (names, descriptions) for a keyword. Returns matching contracts with their metadata. Use Get Contract Metadata when you know the address.
Inputs
querystringrequired- String - The search string that you want to search for in contract metadata. Example: bored.
alchemy_contracts_for_owner_getList the NFT contracts a wallet holds tokens from.Read-onlyGet Contracts for Owner
List the NFT contracts a wallet holds tokens from. Returns contracts with name, symbol, token type, number owned and OpenSea data, plus pageKey. Use Get NFTs for Owner for the individual tokens.
Inputs
ownerstringrequired- Wallet address of the NFT owner (an ENS name also works on Ethereum mainnet). Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
exclude_filtersarray- Exclude NFTs that match these filters: SPAM or AIRDROPS. Example: ["SPAM"].
include_filtersarray- Only include NFTs that match these filters: SPAM or AIRDROPS. Example: ["AIRDROPS"].
order_bystring- Enum - ordering scheme to use for ordering NFTs in the response. If unspecified, NFTs will be ordered by contract address and token ID. - transferTime: NFTs will be ordered by the time they were transferred into the wallet, with newest NFTs first. NOTE: this ordering is only supported on Ethereum Mainnet and Polygon Mainnet. Example: transferTime.one of
transferTime page_keystring- Pagination key returned as pageKey by the previous call. Omit for the first page. Example: 0x0000000000000000000000000000000000000000000000000000000000000065.
page_sizeinteger- Number of NFTs to be returned per page. Defaults to 100. Max is 100. Example: 50.
spam_confidence_levelstring- Spam confidence level used with the SPAM filter: VERY_HIGH, HIGH, MEDIUM or LOW. Example: HIGH.one of
VERY_HIGHHIGHMEDIUMLOW with_metadataboolean- true returns NFT metadata; false makes the response smaller and faster. Example: true.
alchemy_fee_history_getGet base fees, gas used ratios and priority fee percentiles for a range of recent blocks (eth_feeHistory).Read-onlyGet Fee History
Get base fees, gas used ratios and priority fee percentiles for a range of recent blocks (eth_feeHistory). Returns oldestBlock, baseFeePerGas, gasUsedRatio and reward arrays. Use Get Gas Price for a single current price.
Inputs
block_countintegerrequired- Number of blocks to return, 1 to 1024. Example: 4.
newest_blockstringrequired- Newest block of the range, as hex or a tag such as latest. Example: latest.
reward_percentilesarray- Priority fee percentiles to sample from each block, for example [25, 75]. Example: [25, 75].
alchemy_floor_price_getGet an NFT collection's floor price on OpenSea and LooksRare, by contract or slug.Read-onlyGet Floor Price
Get an NFT collection's floor price on OpenSea and LooksRare, by contract or slug. Returns the floor price, currency, collection URL and retrieval time for each marketplace. Use Get NFT Sales for actual sale prices.
Inputs
collection_slugstring- OpenSea collection slug. Example: boredapeyachtclub.
contract_addressstring- Contract address of the NFT collection (ERC-721 or ERC-1155). Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.
alchemy_gas_estimateEstimate the gas a transaction would use (eth_estimateGas).Read-onlyEstimate Gas
Estimate the gas a transaction would use (eth_estimateGas). Returns the gas estimate as hex. Use Get Gas Price or Get Fee History to price it.
Inputs
tostringrequired- Address the call is sent to. Example: 0xA0b86991c6218b36c1d19d4a2e9eB0cE3606eB48.
datastring- Hex-encoded call data: method signature hash and encoded arguments. Example: 0x70a08231000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045.
fromstring- Address the call is sent from. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
gasstring- Gas limit, as hex. Example: 0x5208.
gas_pricestring- Gas price in wei, as hex. Rarely needed. Example: 0x9184e72a000.
valuestring- Value to send, in wei, as hex. Example: 0x0.
alchemy_gas_price_getGet the current gas price in wei (eth_gasPrice).Read-onlyGet Gas Price
Get the current gas price in wei (eth_gasPrice). Returns the gas price as hex. Use Get Fee History or Get Max Priority Fee for EIP-1559 fees.
Inputs
This tool takes no inputs.
alchemy_holder_of_contract_checkCheck whether a wallet holds any NFT from a contract.Read-onlyIs Holder of Contract
Check whether a wallet holds any NFT from a contract. Returns isHolderOfContract true or false. Use Get Owners for Contract to list all holders.
Inputs
contract_addressstringrequired- Contract address of the NFT collection (ERC-721 or ERC-1155). Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.
walletstringrequired- String - Wallet address to check for contract ownership. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
alchemy_logs_getGet event logs matching contract addresses, topics and a block range (eth_getLogs).Read-onlyGet Logs
Get event logs matching contract addresses, topics and a block range (eth_getLogs). Returns logs with address, topics, data, block number and transaction hash. Keep block ranges small; use Get Asset Transfers for token transfer history.
Inputs
block_hashstring- Only logs from this block. Not used with from_block or to_block. Example: 0xb3b20624f8f0f86eb50dd04688409e5cea4bd02d700bf6e79e9384d47d6a5a35.
contract_addressesarray- Only logs from these contract addresses. Example: ["0xA0b86991c6218b36c1d19d4a2e9eB0cE3606eB48"].
from_blockstring- First block, as hex or a tag. Defaults to latest. Example: 0x1312d00.
to_blockstring- Last block, as hex or a tag. Defaults to latest. Example: latest.
topicsarray- Topic filters by position; use null for any, or a list for OR. Topic 0 is the event signature hash. Example: ["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"].
alchemy_max_priority_fee_getGet a suggested EIP-1559 priority fee (tip) per gas (eth_maxPriorityFeePerGas).Read-onlyGet Max Priority Fee
Get a suggested EIP-1559 priority fee (tip) per gas (eth_maxPriorityFeePerGas). Returns the fee in wei as hex. Use Get Fee History for historical base fees.
Inputs
This tool takes no inputs.
alchemy_network_version_getGet the network ID of the connection's network (net_version).Read-onlyGet Network Version
Get the network ID of the connection's network (net_version). Returns the network ID as a decimal string. Use Get Chain ID for the EIP-155 chain ID.
Inputs
This tool takes no inputs.
alchemy_nft_attributes_summarizeSummarize how common each attribute value is across a collection.Read-onlySummarize NFT Attributes
Summarize how common each attribute value is across a collection. Returns total supply and counts per trait type and value. Use Compute Rarity for one NFT's attribute rarity.
Inputs
contract_addressstringrequired- Contract address of the NFT collection (ERC-721 or ERC-1155). Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.
alchemy_nft_metadata_batch_getGet metadata for up to 100 NFTs in one call.Read-onlyGet NFT Metadata Batch
Get metadata for up to 100 NFTs in one call. Returns each NFT's name, image, attributes and contract details. Use Get NFT Metadata for a single NFT.
Inputs
tokensarrayrequired- NFTs to look up, up to 100, each with contractAddress, tokenId and optional tokenType (ERC721 or ERC1155). Example: [{"contractAddress": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D", "tokenId": "44", "tokenType": "ERC721"}].
refresh_cacheboolean- Defaults to false for faster response times. If true will refresh metadata for given token. If false will check the cache and use it or refresh if cache doesn't exist. Example: false.
token_uri_timeout_in_msnumber- Milliseconds to wait for the token URI when fetching metadata live. Example: 5000.
alchemy_nft_metadata_getGet one NFT's metadata by contract address and token ID.Read-onlyGet NFT Metadata
Get one NFT's metadata by contract address and token ID. Returns its name, description, image, attributes, token URI, contract details and timestamps. Use Get NFT Metadata Batch for up to 100 NFTs.
Inputs
contract_addressstringrequired- Contract address of the NFT collection (ERC-721 or ERC-1155). Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.
token_idstringrequired- Token ID, in decimal or hex. Example: 44.
refresh_cacheboolean- Defaults to false for faster response times. If true will refresh metadata for given token. If false will check the cache and use it or refresh if cache doesn't exist. Example: false.
token_typestring- String - 'ERC721' or 'ERC1155'; specifies type of token to query for. API requests will perform faster if this is specified. Example: ERC721.
token_uri_timeout_in_msinteger- Milliseconds to wait for the token URI when fetching metadata live. Example: 5000.
alchemy_nft_rarity_computeCompute the rarity of each attribute of one NFT within its collection.Read-onlyCompute Rarity
Compute the rarity of each attribute of one NFT within its collection. Returns each trait type and value with its prevalence. Use Summarize NFT Attributes for collection-wide counts.
Inputs
contract_addressstringrequired- Contract address of the NFT collection (ERC-721 or ERC-1155). Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.
token_idstringrequired- Token ID, in decimal or hex. Example: 44.
alchemy_nft_sales_getList NFT sales on supported marketplaces, filterable by block range, contract, token, buyer, seller and marketplace.Read-onlyGet NFT Sales
List NFT sales on supported marketplaces, filterable by block range, contract, token, buyer, seller and marketplace. Returns sales with marketplace, buyer, seller, prices, fees and transaction hash, plus pageKey. Use Get Floor Price for current listing floors.
Inputs
buyer_addressstring- String - The address of the NFT buyer to filter sales by. Defaults to returning sales involving any buyer. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
contract_addressstring- Contract address of the NFT collection (ERC-721 or ERC-1155). Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.
from_blockstring- String - The block number to start fetching NFT sales data from. Allowed values are decimal and hex integers, and "latest". Defaults to "0". Example: 0.
limitinteger- Integer - The maximum number of NFT sales to return. Maximum and default values are 1000. Example: 50.
marketplacestring- Enum - The name of the NFT marketplace to filter sales by. The endpoint currently supports "seaport", "wyvern", "looksrare", "x2y2", "blur", and "cryptopunks". Defaults to returning sales from all supported marketplaces. Example: seaport.one of
seaportlooksrarex2y2wyvernblurcryptopunks orderstring- Enum - Whether to return the results ascending from startBlock or descending from startBlock. Defaults to descending (false). Example: desc.one of
ascdesc page_keystring- Pagination key returned as pageKey by the previous call. Omit for the first page. Example: 0x0000000000000000000000000000000000000000000000000000000000000065.
seller_addressstring- String - The address of the NFT seller to filter sales by. Defaults to returning sales involving any seller. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
takerstring- Enum - Filter by whether the buyer or seller was the taker in the NFT trade. Allowed filter values are "BUYER" and "SELLER". Defaults to returning both buyer and seller taker trades. Example: BUYER.one of
BUYERSELLER to_blockstring- String - The block number to start fetching NFT sales data from. Allowed values are decimal and hex integers, and "latest". Defaults to "latest". Example: latest.
token_idstring- Token ID, in decimal or hex. Example: 44.
alchemy_nfts_for_collection_getList the NFTs in a collection, by contract address or OpenSea slug.Read-onlyGet NFTs for Collection
List the NFTs in a collection, by contract address or OpenSea slug. Returns nfts with token ID, name, image and metadata, plus pageKey. Use Get NFTs for Contract when you have the contract address.
Inputs
collection_slugstring- OpenSea collection slug. Example: boredapeyachtclub.
contract_addressstring- Contract address of the NFT collection (ERC-721 or ERC-1155). Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.
limitinteger- Integer - Sets the total number of NFTs returned in the response. Defaults to 100. Example: 50.
start_tokenstring- String - A tokenID offset used for pagination. Can be a hex string, or a decimal. Users can specify the offset themselves to start from a custom offset, or to fetch multiple token ranges in parallel. Example: 100.
token_uri_timeout_in_msinteger- Milliseconds to wait for the token URI when fetching metadata live. Example: 5000.
with_metadataboolean- true returns NFT metadata; false makes the response smaller and faster. Example: true.
alchemy_nfts_for_contract_getList the NFTs in one contract, paged by token ID.Read-onlyGet NFTs for Contract
List the NFTs in one contract, paged by token ID. Returns nfts with token ID, name, image and metadata, plus pageKey. Use Get NFTs for Collection to look up by OpenSea slug.
Inputs
contract_addressstringrequired- Contract address of the NFT collection (ERC-721 or ERC-1155). Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.
limitinteger- Integer - Sets the total number of NFTs returned in the response. Defaults to 100. Example: 50.
start_tokenstring- String - A tokenID offset used for pagination. Can be a hex string, or a decimal. Users can specify the offset themselves to start from a custom offset, or to fetch multiple token ranges in parallel. Example: 100.
token_uri_timeout_in_msinteger- Milliseconds to wait for the token URI when fetching metadata live. Example: 5000.
with_metadataboolean- true returns NFT metadata; false makes the response smaller and faster. Example: true.
alchemy_nfts_for_owner_getList the NFTs a wallet owns on the connection's network, with optional contract and spam filters.Read-onlyGet NFTs for Owner
List the NFTs a wallet owns on the connection's network, with optional contract and spam filters. Returns ownedNfts with contract, token ID, name, image and metadata, plus totalCount and pageKey. Use Get Contracts for Owner or Get Collections for Owner for a per-collection view.
Inputs
ownerstringrequired- Wallet address of the NFT owner (an ENS name also works on Ethereum mainnet). Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
contract_addressesarray- Only NFTs from these contract addresses (up to 45). Example: ["0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"].
exclude_filtersarray- Exclude NFTs that match these filters: SPAM or AIRDROPS. Example: ["SPAM"].
include_filtersarray- Only include NFTs that match these filters: SPAM or AIRDROPS. Example: ["AIRDROPS"].
order_bystring- Enum - ordering scheme to use for ordering NFTs in the response. If unspecified, NFTs will be ordered by contract address and token ID. - transferTime: NFTs will be ordered by the time they were transferred into the wallet, with newest NFTs first. NOTE: this ordering is only supported on Ethereum Mainnet and Polygon Mainnet. Example: transferTime.one of
transferTime page_keystring- Pagination key returned as pageKey by the previous call. Omit for the first page. Example: 0x0000000000000000000000000000000000000000000000000000000000000065.
page_sizeinteger- Number of NFTs to be returned per page. Defaults to 100. Max is 100. Example: 50.
spam_confidence_levelstring- Spam confidence level used with the SPAM filter: VERY_HIGH, HIGH, MEDIUM or LOW. Example: HIGH.one of
VERY_HIGHHIGHMEDIUMLOW token_uri_timeout_in_msinteger- Milliseconds to wait for the token URI when fetching metadata live. Example: 5000.
with_metadataboolean- true returns NFT metadata; false makes the response smaller and faster. Example: true.
alchemy_owners_for_contract_getList every wallet holding an NFT from a contract, optionally with per-token balances.Read-onlyGet Owners for Contract
List every wallet holding an NFT from a contract, optionally with per-token balances. Returns owner addresses (and token balances), plus pageKey for large collections. Use Is Holder of Contract to check one wallet.
Inputs
contract_addressstringrequired- Contract address of the NFT collection (ERC-721 or ERC-1155). Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.
page_keystring- Pagination key returned as pageKey by the previous call. Omit for the first page. Example: 0x0000000000000000000000000000000000000000000000000000000000000065.
with_token_balancesboolean- Boolean - If set to `true` the query will include the token balances per token id for each owner. `false` by default. Example: false.
alchemy_owners_for_nft_getGet the wallet(s) that own a specific NFT.Read-onlyGet Owners for NFT
Get the wallet(s) that own a specific NFT. Returns the owner addresses. Use Get Owners for Contract for every holder of a collection.
Inputs
contract_addressstringrequired- Contract address of the NFT collection (ERC-721 or ERC-1155). Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.
token_idstringrequired- Token ID, in decimal or hex. Example: 44.
alchemy_proof_getGet the Merkle proof of an account and some of its storage slots (eth_getProof).Read-onlyGet Proof
Get the Merkle proof of an account and some of its storage slots (eth_getProof). Returns balance, nonce, code hash, storage hash and account and storage proofs. Use Get Storage At to read a value without a proof.
Inputs
addressstringrequired- Account or contract address (20 bytes, hex). Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
storage_keysarrayrequired- Storage slots to prove, as hex. Example: ["0x0"].
blockstring- Block number in hex (for example 0x10d4f), or a tag: latest (default), safe, finalized, earliest or pending. Example: latest.
alchemy_spam_contract_checkCheck whether Alchemy marks a contract as spam.Read-onlyIs Spam Contract
Check whether Alchemy marks a contract as spam. Returns isSpamContract true or false. Use List Spam Contracts for the full list.
Inputs
contract_addressstringrequired- Contract address of the NFT collection (ERC-721 or ERC-1155). Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.
alchemy_spam_contracts_listList the contracts Alchemy marks as spam on the connection's network.Read-onlyList Spam Contracts
List the contracts Alchemy marks as spam on the connection's network. Returns the spam contract addresses. Use Is Spam Contract to check one contract.
Inputs
This tool takes no inputs.
alchemy_storage_at_getRead the value of a contract storage slot at a block (eth_getStorageAt).Read-onlyGet Storage At
Read the value of a contract storage slot at a block (eth_getStorageAt). Returns the 32-byte value as hex. Use Call Contract to read through a contract's functions instead.
Inputs
addressstringrequired- Account or contract address (20 bytes, hex). Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
positionstringrequired- Storage slot position, as hex. Example: 0x0.
blockstring- Block number in hex (for example 0x10d4f), or a tag: latest (default), safe, finalized, earliest or pending. Example: latest.
alchemy_token_allowance_getGet how many tokens a spender may move on an owner's behalf (alchemy_getTokenAllowance).Read-onlyGet Token Allowance
Get how many tokens a spender may move on an owner's behalf (alchemy_getTokenAllowance). Returns the allowance as a decimal string. Use Get Token Metadata for the token's decimals.
Inputs
contractstringrequired- ERC-20 token contract address. Example: 0xA0b86991c6218b36c1d19d4a2e9eB0cE3606eB48.
ownerstringrequired- Token owner address. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
spenderstringrequired- Spender address the allowance was given to. Example: 0xdef1c0ded9bec7f1a1670819833240f027b25eff.
alchemy_token_balances_getGet an address's ERC-20 token balances, for all tokens it has held or for given contracts (alchemy_getTokenBalances).Read-onlyGet Token Balances
Get an address's ERC-20 token balances, for all tokens it has held or for given contracts (alchemy_getTokenBalances). Returns tokenBalances with contract address and hex balance, plus pageKey. Use Get Token Metadata for symbol and decimals. Use Get Balance for the native coin.
Inputs
addressstringrequired- Account or contract address (20 bytes, hex). Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
contract_addressesarray- Only these token contracts (up to 100). Omit to get every ERC-20 token the address has held. Example: ["0xA0b86991c6218b36c1d19d4a2e9eB0cE3606eB48"].
max_countinteger- Balances per page, up to 100 (all-tokens mode only). Example: 100.
page_keystring- Pagination key from the previous call (all-tokens mode only). Example: 0x00000000000000000000000000000000000000000000000000000000000001a3.
alchemy_token_metadata_getGet an ERC-20 token's metadata (alchemy_getTokenMetadata).Read-onlyGet Token Metadata
Get an ERC-20 token's metadata (alchemy_getTokenMetadata). Returns name, symbol, decimals and logo URL. Use it to format balances from Get Token Balances.
Inputs
contract_addressstringrequired- ERC-20 token contract address. Example: 0xA0b86991c6218b36c1d19d4a2e9eB0cE3606eB48.
alchemy_token_prices_by_address_getGet current prices for up to 25 tokens by network and contract address.Read-onlyGet Token Prices by Address
Get current prices for up to 25 tokens by network and contract address. Returns each token's prices, or an error. Use Get Token Prices by Symbol for well-known symbols.
Inputs
addressesarrayrequired- Tokens to price, up to 25 (at most 3 networks), each with network (for example eth-mainnet) and address (the token contract). Example: [{"network": "eth-mainnet", "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"}].
alchemy_token_prices_by_symbol_getGet current USD prices for up to 25 tokens by symbol.Read-onlyGet Token Prices by Symbol
Get current USD prices for up to 25 tokens by symbol. Returns each symbol's prices with currency, value and last updated time, or an error. Use Get Token Prices by Address for a specific contract on a network.
Inputs
symbolsarrayrequired- Token symbols to price, up to 25, for example ETH and BTC. Example: ["ETH", "BTC"].
alchemy_token_prices_historical_getGet a token's price history over a time range, by symbol or by network and address.Read-onlyGet Historical Token Prices
Get a token's price history over a time range, by symbol or by network and address. Returns price data points with value and timestamp (and market data if asked). Use Get Token Prices by Symbol for the current price.
Inputs
end_timestringrequired- End of the range, ISO 8601. Example: 2026-10-31T00:00:00Z.
start_timestringrequired- Start of the range, ISO 8601 (or Unix seconds as text). Example: 2026-10-01T00:00:00Z.
addressstring- Token contract address. Use with network. Example: 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48.
intervalstring- Data point interval: 5m (up to 7 days), 1h (up to 30 days) or 1d (default, up to 1 year). Example: 1d.one of
5m1h1d networkstring- Network of the token contract, for example eth-mainnet. Use with address. Example: eth-mainnet.
symbolstring- Token symbol, for example ETH. Give this, or network and address. Example: ETH.
with_market_databoolean- Include market cap and volume. Example: false.
alchemy_transaction_count_getGet the number of transactions sent from an address, its nonce (eth_getTransactionCount).Read-onlyGet Transaction Count
Get the number of transactions sent from an address, its nonce (eth_getTransactionCount). Returns the count as hex. Use block pending to get the next nonce to use.
Inputs
addressstringrequired- Account or contract address (20 bytes, hex). Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
blockstring- Block number in hex (for example 0x10d4f), or a tag: latest (default), safe, finalized, earliest or pending. Example: latest.
alchemy_transaction_getGet a transaction by hash (eth_getTransactionByHash).Read-onlyGet Transaction
Get a transaction by hash (eth_getTransactionByHash). Returns from, to, value, gas, input data, nonce and block details, or null if unknown. Use Get Transaction Receipt for its status and logs.
Inputs
tx_hashstringrequired- Transaction hash (32 bytes, hex). Example: 0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b.
alchemy_transaction_receipt_getGet a mined transaction's receipt (eth_getTransactionReceipt).Read-onlyGet Transaction Receipt
Get a mined transaction's receipt (eth_getTransactionReceipt). Returns status, gas used, effective gas price, contract address and logs. Use Get Transaction for the transaction's input fields.
Inputs
tx_hashstringrequired- Transaction hash (32 bytes, hex). Example: 0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b.
alchemy_transaction_receipts_getGet all transaction receipts in a block by number or hash (alchemy_getTransactionReceipts).Read-onlyGet Transaction Receipts
Get all transaction receipts in a block by number or hash (alchemy_getTransactionReceipts). Returns the receipts with status, gas used and logs. Use Get Block Receipts for the standard method.
Inputs
block_hashstring- Block hash. Give this or block_number. Example: 0xb3b20624f8f0f86eb50dd04688409e5cea4bd02d700bf6e79e9384d47d6a5a35.
block_numberstring- Block number, as hex. Give this or block_hash. Example: 0xF1D1C6.
alchemy_wallet_nft_contracts_getGet the NFT collections (contracts) held by up to 2 wallets across several networks.Read-onlyGet Wallet NFT Collections
Get the NFT collections (contracts) held by up to 2 wallets across several networks. Returns collections per wallet and network with metadata, plus pageKey. Use Get Wallet NFTs for the individual tokens.
Inputs
addressesarrayrequired- Wallets to query, up to 2 wallets with up to 15 networks each, each with address and a networks list (for example eth-mainnet, base-mainnet). Example: [{"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "networks": ["eth-mainnet", "base-mainnet"]}].
page_keystring- Pagination key returned by the previous call. Omit for the first page. Example: 0x0000000000000000000000000000000000000000000000000000000000000065.
page_sizeinteger- Number of NFTs to be returned per page. Defaults to 100. Max is 100. Example: 50.
with_metadataboolean- true returns metadata; false makes the response smaller. Example: true.
alchemy_wallet_nfts_getGet the NFTs held by up to 2 wallets across several networks.Read-onlyGet Wallet NFTs
Get the NFTs held by up to 2 wallets across several networks. Returns NFTs per wallet and network with metadata, plus pageKey. Use Get NFTs for Owner for one wallet on the connection's network.
Inputs
addressesarrayrequired- Wallets to query, up to 2 wallets with up to 15 networks each, each with address and a networks list (for example eth-mainnet, base-mainnet). Example: [{"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "networks": ["eth-mainnet", "base-mainnet"]}].
page_keystring- Pagination key returned by the previous call. Omit for the first page. Example: 0x0000000000000000000000000000000000000000000000000000000000000065.
page_sizeinteger- Number of NFTs to be returned per page. Defaults to 100. Max is 100. Example: 50.
with_metadataboolean- true returns metadata; false makes the response smaller. Example: true.
alchemy_wallet_token_balances_getGet native and ERC-20 token balances for up to 3 wallets across up to 20 networks each.Read-onlyGet Wallet Token Balances
Get native and ERC-20 token balances for up to 3 wallets across up to 20 networks each. Returns token balances per wallet and network, plus pageKey. Use Get Wallet Tokens to also get prices and metadata.
Inputs
addressesarrayrequired- Wallets to query, up to 3 wallets with up to 20 networks each, each with address and a networks list (for example eth-mainnet, base-mainnet). Example: [{"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "networks": ["eth-mainnet", "base-mainnet"]}].
include_native_tokensboolean- Whether to include each chain's native token in the response (e.g. ETH on Ethereum). The native token will have a null contract address. Example: true.
alchemy_wallet_tokens_getGet the native and ERC-20 tokens held by up to 2 wallets across several networks, with balances, prices and metadata.Read-onlyGet Wallet Tokens
Get the native and ERC-20 tokens held by up to 2 wallets across several networks, with balances, prices and metadata. Returns tokens per wallet and network with balance, price and metadata, plus pageKey. Use Get Wallet Token Balances for balances only across more networks.
Inputs
addressesarrayrequired- Wallets to query, up to 2 wallets with up to 5 networks each, each with address and a networks list (for example eth-mainnet, base-mainnet). Example: [{"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "networks": ["eth-mainnet", "base-mainnet"]}].
include_native_tokensboolean- Whether to include each chain's native token in the response (e.g. ETH on Ethereum). The native token will have a null contract address. Example: true.
with_metadataboolean- true returns metadata; false makes the response smaller. Example: true.
with_pricesboolean- Boolean - if set to `true`, returns token prices. Setting this to false will reduce payload size and may result in a faster API call. Defaults to `true`. Example: true.
alchemy_wallet_transactions_getGet the full transaction history (internal and external) of a wallet on up to 2 networks.Read-onlyGet Wallet Transaction History
Get the full transaction history (internal and external) of a wallet on up to 2 networks. Returns transactions with hash, block, from, to, value, logs and timestamps, plus before and after cursors. Use Get Asset Transfers for token transfer history on the connection's network.
Inputs
addressesarrayrequired- Wallets to query, 1 wallet with up to 2 networks, each with address and a networks list (for example eth-mainnet, base-mainnet). Example: [{"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "networks": ["eth-mainnet", "base-mainnet"]}].
afterstring- The cursor that points to the end of the current set of results. Example: eyJibG9jayI6MTIzfQ.
beforestring- The cursor that points to the previous set of results. Example: eyJibG9jayI6MTIzfQ.
limitinteger- Sets the maximum number of items per page (Max: 100). Example: 50.
alchemy_contract_cache_invalidateMark every cached token of a contract as stale so the next queries fetch live data.WriteInvalidate Contract Cache
Mark every cached token of a contract as stale so the next queries fetch live data. Returns the number of tokens invalidated. Use Refresh NFT Metadata to refresh one token.
- Idempotent
Inputs
contract_addressstringrequired- Contract address of the NFT collection (ERC-721 or ERC-1155). Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.
alchemy_nft_metadata_refreshAsk Alchemy to refresh the cached metadata of one NFT.WriteRefresh NFT Metadata
Ask Alchemy to refresh the cached metadata of one NFT. Returns the refresh status. Use Invalidate Contract Cache to refresh a whole contract.
Inputs
contract_addressstringrequired- Contract address of the NFT collection (ERC-721 or ERC-1155). Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.
token_idstringrequired- Token ID, in decimal or hex. Example: 44.
alchemy_raw_transaction_sendBroadcast a transaction you have already signed (eth_sendRawTransaction).WriteSend Raw Transaction
Broadcast a transaction you have already signed (eth_sendRawTransaction). Returns the transaction hash. This moves funds on-chain and cannot be undone. Use Get Transaction Receipt to follow it.
Inputs
signed_transactionstringrequired- Signed, RLP-encoded transaction as hex. Sign it with your own wallet first. Example: 0xf86c808504a817c80082520894....
alchemy_spam_reportReport an address to Alchemy as suspected spam.WriteReport Spam
Report an address to Alchemy as suspected spam. Returns a confirmation. Use Is Spam Contract to check the current classification.
- Idempotent
Inputs
addressstringrequired- String - any valid blockchain address for NFT collections, contracts, mints, etc. Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.
No tools match.