Alchemy Web3 Developer API

eth-mainnet.g.alchemy.com

Community

Alchemy is a Web3 developer platform providing blockchain APIs for 50+ networks including Ethereum, Polygon, Arbitrum, Optimism, Base, and Solana. Use this API to query NFT data, token balances, transfers, prices, wallet portfolios, and interact with smart contracts across multiple blockchains.

[catalog]Catalog only — enable via gateway with your own API key

Enable this service

This service is in the catalog but not part of v1 launch billing. To use it, run the command below and provide your own API key in the local config page — the gateway will call it under your account.

Auth

api_key

Pricing

free

Spec version

1.0

Base URL

https://eth-mainnet.g.alchemy.com

Last crawled

May 4, 2026

Health

This is a community-maintained manifest. Health monitoring is not available because this service doesn't host its own /.well-known/agent endpoint yet. Learn more about trust levels →

Top Capabilities

Most commonly used operations — ready to call without drill-down.

nft_contract_metadata_get

GET

Retrieve metadata for an NFT contract including name, symbol, total supply, and token type.

GET https://eth-mainnet.g.alchemy.com/nft/v3/{apiKey}/getContractMetadata

apiKey (string, required) — Your Alchemy API key (path parameter).

contractAddress (string, required) — NFT contract address.

nft_floor_price_get

GET

Retrieve the floor price of an NFT collection from supported marketplaces.

GET https://eth-mainnet.g.alchemy.com/nft/v3/{apiKey}/getFloorPrice

apiKey (string, required) — Your Alchemy API key (path parameter).

contractAddress (string, required) — NFT contract address.

nft_metadata_batch_get

POST

Retrieve metadata for multiple NFTs across different contracts in a single batch request.

POST https://eth-mainnet.g.alchemy.com/nft/v3/{apiKey}/getNFTMetadataBatch

apiKey (string, required) — Your Alchemy API key (path parameter).

tokens (array, required) — Array of objects with 'contractAddress' and 'tokenId' fields.

refreshCache (boolean) — Force refresh of cached metadata for all tokens.

All Capabilities (22)

nft (16)

GETnft_contract_metadata_get

Retrieve metadata for an NFT contract including name, symbol, total supply, and token type.

GETnft_contract_metadata_search

Search for NFT contracts by keyword across contract names and metadata.

GETnft_contracts_get_by_owner

Return a list of all NFT contracts (collections) owned by a specific wallet address.

GETnft_floor_price_get

Retrieve the floor price of an NFT collection from supported marketplaces.

GETnft_holder_check

Check whether a wallet address holds any NFT from a specific collection.

POSTnft_metadata_batch_get

Retrieve metadata for multiple NFTs across different contracts in a single batch request.

GETnft_metadata_get

Fetch detailed metadata for a specific NFT by contract address and token ID including name, description, image, and attributes.

GETnft_metadata_refresh

Trigger a metadata refresh for a specific NFT to update cached data.

GETnft_owners_get

Get the owner(s) of a specific NFT by contract address and token ID.

GETnft_owners_get_by_contract

Retrieve all owners of NFTs within a specific contract with a snapshot at a given block number.

GETnft_rarity_compute

Compute the rarity score of each attribute for a specific NFT within its collection.

GETnft_sales_get

Retrieve historical NFT sales data across marketplaces with filtering by contract, token, and date range.

GETnft_spam_check

Check whether a specific NFT contract is classified as spam.

GETnft_spam_contracts_get

Retrieve a list of NFT contracts that have been classified as spam.

GETnfts_get_by_contract

Retrieve all NFTs belonging to a specific contract or collection with pagination support.

GETnfts_get_by_owner

Retrieve all NFTs owned by a specific wallet address across collections with metadata, images, and attributes.

portfolio (1)

GETportfolio_tokens_get

Get fungible token holdings (native, ERC-20) for one or more wallet addresses with balances, prices, and metadata.

token (3)

POSTtoken_allowance_get

Check the amount a spender is approved to withdraw from an owner's token balance.

POSTtoken_balances_get

Get ERC-20 token balances for a wallet address, including all tokens the address has ever transacted with.

POSTtoken_metadata_get

Retrieve metadata (name, symbol, decimals, logo) for a specific ERC-20 token contract.

prices (1)

POSTtoken_prices_get

Get current USD prices for tokens by their contract addresses across supported networks.

transfers (1)

POSTtransfers_get

Fetch historical asset transfers (ETH, ERC-20, ERC-721, ERC-1155) for any address with filtering by block range, category, and contract.

Agent Preview

This is what an AI agent sees when it discovers this service via the Gateway:

Service: Alchemy Web3 Developer API
Description: Alchemy is a Web3 developer platform providing blockchain APIs for 50+ networks including Ethereum, Polygon, Arbitrum, Optimism, Base, and Solana. Use this API to query NFT data, token balances, transfers, prices, wallet portfolios, and interact with smart contracts across multiple blockchains.
Auth: api_key
Capabilities (22 total):
  nft (16):
    - nft_contract_metadata_get: Retrieve metadata for an NFT contract including name, symbol, total supply, and token type.
    - nft_contract_metadata_search: Search for NFT contracts by keyword across contract names and metadata.
    - nft_contracts_get_by_owner: Return a list of all NFT contracts (collections) owned by a specific wallet address.
    - nft_floor_price_get: Retrieve the floor price of an NFT collection from supported marketplaces.
    - nft_holder_check: Check whether a wallet address holds any NFT from a specific collection.
    - nft_metadata_batch_get: Retrieve metadata for multiple NFTs across different contracts in a single batch request.
    - nft_metadata_get: Fetch detailed metadata for a specific NFT by contract address and token ID including name, description, image, and attributes.
    - nft_metadata_refresh: Trigger a metadata refresh for a specific NFT to update cached data.
    - nft_owners_get: Get the owner(s) of a specific NFT by contract address and token ID.
    - nft_owners_get_by_contract: Retrieve all owners of NFTs within a specific contract with a snapshot at a given block number.
    - nft_rarity_compute: Compute the rarity score of each attribute for a specific NFT within its collection.
    - nft_sales_get: Retrieve historical NFT sales data across marketplaces with filtering by contract, token, and date range.
    - nft_spam_check: Check whether a specific NFT contract is classified as spam.
    - nft_spam_contracts_get: Retrieve a list of NFT contracts that have been classified as spam.
    - nfts_get_by_contract: Retrieve all NFTs belonging to a specific contract or collection with pagination support.
    - nfts_get_by_owner: Retrieve all NFTs owned by a specific wallet address across collections with metadata, images, and attributes.
  portfolio (1):
    - portfolio_tokens_get: Get fungible token holdings (native, ERC-20) for one or more wallet addresses with balances, prices, and metadata.
  token (3):
    - token_allowance_get: Check the amount a spender is approved to withdraw from an owner's token balance.
    - token_balances_get: Get ERC-20 token balances for a wallet address, including all tokens the address has ever transacted with.
    - token_metadata_get: Retrieve metadata (name, symbol, decimals, logo) for a specific ERC-20 token contract.
  prices (1):
    - token_prices_get: Get current USD prices for tokens by their contract addresses across supported networks.
  transfers (1):
    - transfers_get: Fetch historical asset transfers (ETH, ERC-20, ERC-721, ERC-1155) for any address with filtering by block range, category, and contract.

Top capabilities (ready to call):
  - nft_contract_metadata_get: GET /nft/v3/{apiKey}/getContractMetadata
  - nft_floor_price_get: GET /nft/v3/{apiKey}/getFloorPrice
  - nft_metadata_batch_get: POST /nft/v3/{apiKey}/getNFTMetadataBatch