Alchemy
for LuumenAI
Read NFT and token data from Alchemy, and refresh stale contract metadata
Connect Alchemy and the agent can pull contract metadata, NFT attributes, sales history, floor prices, and historical token prices while you work in the terminal. When a collection's cached metadata goes stale after a reveal or a base URI change, the agent can invalidate the contract cache as an approved step. Luumen authenticates with an API key.
The Alchemy toolbox
35 tools: 34 read, 1 write. Reads answer instantly. Writes require approval by default. Everything is logged.
- ReadCompute NFT RarityCompute the rarity of each attribute for a specific NFT based on its collection.
- ReadGet NFT Collection MetadataGet metadata for an NFT collection using its marketplace slug (OpenSea, LooksRare, etc).
- ReadGet Collections for OwnerRetrieve all NFT collections held by a specified owner address.
- ReadGet Contract Metadata Batch V3Retrieve metadata for multiple NFT contracts in a single batch request.
- ReadGet Contract Metadata V3Get the metadata for an NFT contract including name, symbol, total supply, and token type (ERC721/ERC1155).
- ReadGet Contracts for Owner (NFT API v3)Get all NFT contracts owned by an address with contract metadata.
- ReadGet NFT Floor PriceGet the floor price for an NFT collection across multiple marketplaces (OpenSea, LooksRare, etc).
- ReadGet Historical Token PricesRetrieves historical price data for a token over a specified time range with configurable intervals.
- ReadGet NFT Contracts By AddressRetrieve NFT contracts associated with one or more wallet addresses across multiple blockchain networks.
- ReadGet NFT MetadataRetrieve comprehensive metadata for a specific NFT, including contract details, media URLs, attributes, ownership info, and OpenSea data.
- ReadGet NFT Metadata BatchRetrieve metadata for multiple NFTs in a single request (up to 100 NFTs), including contract details, media URLs, attributes, and collection data.
- ReadGet NFT Sales V3Retrieves NFT sales that have occurred through on-chain marketplaces using Alchemy's v3 API.
- ReadGet NFTs for Collection V3Retrieves all NFTs in a collection using OpenSea collection slug or contract address.
- ReadGet NFTs for ContractRetrieves all NFTs for a given NFT contract address.
- ReadGet NFTs for OwnerGet all NFTs currently owned by a given address.
- ReadGet Owners for CollectionRetrieve all owner addresses for a given NFT collection contract.
- ReadGet Owners for ContractGet all owners of NFTs in a contract with optional token balances.
- ReadGet NFT Owners (v3)Retrieve all owners for a specific NFT using Alchemy's v3 API.
- ReadGet Portfolio NFTs By AddressFetch NFTs owned by multiple wallet addresses across different blockchain networks.
- ReadGet Token Prices By SymbolGet current token prices by symbol (e.g., ETH, USDC, BTC) using aggregated CEX and DEX data.
- ReadGet Token BalancesThis tool retrieves ERC20 token balances for a specified Ethereum address.
- ReadGet Token Balances By AddressGet token balances for wallet addresses across multiple networks using Alchemy's Portfolio API.
- ReadGet Token MetadataRetrieves metadata for an ERC-20 token on Ethereum mainnet, including its name, symbol, decimals, and logo URL.
- ReadGet Token Prices By AddressRetrieves current token prices by contract address and network from decentralized exchanges (DEXes).
- ReadGet Tokens By AddressFetch fungible tokens (native, ERC-20, SPL) for multiple wallet addresses across networks.
- ReadGet Transaction CountThis tool retrieves the number of transactions sent from a specific address (also known as the nonce).
- ReadGet Transactions History By AddressGet transaction history for wallet addresses across multiple networks using Alchemy's Data API.
- ReadCheck If NFT Is AirdropCheck if a specific NFT token is marked as an airdrop.
- ReadCheck Collection OwnershipCheck if a wallet address owns any token from a specific NFT collection.
- ReadCheck NFT Holder StatusCheck if a wallet address holds any NFTs from a specific contract.
- ReadCheck if Contract is SpamCheck if an NFT contract is marked as spam by Alchemy.
- ReadCheck if Contract is Spam (V3)Determine if a specific NFT contract is marked as spam by Alchemy.
- ReadSearch NFT Contract MetadataSearch for keywords across metadata of all ERC-721 and ERC-1155 smart contracts.
- ReadSummarize NFT AttributesRetrieves a comprehensive summary of all attributes and traits for NFTs in a collection, including trait counts and distribution statistics.
- WriteInvalidate NFT Contract CacheInvalidate the cached metadata for an NFT contract. Approval by default
One prompt, start to finish
What a governed Alchemy run looks like inside Luumen.
Questions
Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.
Read actions answer immediately. Anything that writes — invalidate nft contract cache — is shown as a plan and requires approval by default. Administrators configure that per tool, so you decide exactly which actions can ever run unattended.
You decide. Actions are granted per agent, skill, and team, and per environment — production is not staging. Read access can be broad while writes stay narrow.
Every call to Alchemy — read or write, approved or declined — is recorded with the actor, the input, and the result, and can be linked to the ticket or change record.
Often connected alongside
All integrations
GitHubRepos, actions, and runbook code as context and as actions.
GitLabMerge requests and pipelines proposed, triggered, and rolled back.
BitbucketRead commits, diffs, and branches in Bitbucket, then open the fix as a held write.
Azure DevOpsAzure DevOps repos and pipelines as context — and as approved actions.Put Alchemy to work with Luumen
Connect in minutes. Every action scoped, approved, and audited from day one.