General search tool. This is your FIRST entry point to look up for possible tokens, entities, and addresses related to a query.
Do NOT use this tool for prediction markets. For Polymarket names, topics,
event slugs, or URLs, use `prediction_market_lookup` instead.
Nansen MCP does not support NFTs, however check using this tool if the query relates to a token. Regular tokens and NFTs can have the same name.
This tool allows you to:
- Check if a (fungible) token exists by name, symbol, or contract address
- Search information about a token
- Current price in USD
- Trading volume
- Contract address and chain information
- Market cap and supply data when available
- Search information about an entity
- Find Nansen labels of an address (EOA) or resolve a domain (.eth, .sol)
Args:
query: The search term - token symbol, name, or address. DO NOT include chain name here!
result_type: Type filter - "token", "entity", "eoa", or "any"
max_results: Maximum number of results (default: 25, max: 25)
chain: Optional chain filter to narrow down token results to specific blockchain. If not further specified, leave it as None. If a chain is specified, ALWAYS use this parameter instead of adding chain name to the query string.
Valid values: "ethereum", "solana", "base", "bnb", "polygon", "arbitrum",
"avalanche", "optimism", etc.
How to choose result_type:
- token: Use when searching for a token by name, symbol, or contract address.
**CRITICAL**: Use the `chain` parameter to filter by blockchain, NOT the query string!
✅ CORRECT: query="AAVE", chain="base"
❌ WRONG: query="AAVE base", chain=None
- entity: Use when you want entity info by name/label (exchanges, funds, etc.)
- eoa: Use when you have an address and need its labels or you have an ENS/SNS domain and need the resolved address
- any: Mixed results (tokens/entities). Also auto-resolves ENS/SNS domains and, if token/entity results are empty and the query looks like an address, falls back to EOA labels.
Important:
- This is the only tool that can resolve domains. If you start from a domain, pass the Resolved Address to other tools.
- **DOMAINS**: Strings ending in `.eth` (ENS) or `.sol` (SNS) are DOMAIN NAMES, not tokens. Use result_type="eoa" or "any" to resolve them.
Examples: "vitalik.eth", "abracadabra.sol", "y22.eth" are domains that resolve to addresses.
- **DO NOT** ASSUME that token is a NFT, always verify the name by using this tool first.
- **DO NOT** add keyword `token` or chain names to the query string, unless this is explicitly in the token name or symbol!
- **Focus** on **popular chains** like ethereum, solana, base and bnb when no chain is specified and the same token is deployed on multiple chains.
- **If a chain is specified**, use the `chain` parameter to filter tokens by blockchain instead of including chain in query.
- **DO NOT** rely on this endpoint for LATEST prices as this is delayed. Use `token_ohlcv` for latest prices.