Search
Data Freshness & Historical Coverage
For data freshness and historical coverage, see Data Coverage by Chain; these endpoints follow it except where noted below.
Returns current results from the live search index — token, entity-name, and sector lookups have no date-range parameter or historical look-back; results always reflect the latest indexed tokens, entities, and sectors.
Any price, volume, or market-cap figures shown alongside search results are indicative and may lag live markets — use the dedicated price or OHLCV endpoints when you need up-to-the-moment values.
Search for tokens and entities by name, symbol, or contract address. This endpoint provides a unified search experience across all Nansen data.
Use Cases:
Find token addresses: Search by name or symbol to get contract addresses (e.g., "AAVE", "Uniswap")
Discover entities: Find known entities like exchanges, funds, and public figures (e.g., "vitalik", "Binance")
Resolve addresses: Search by contract address to identify tokens
Filter by chain: Narrow down results to specific blockchains
Search Parameters:
search_query: Token name, symbol, contract address, or entity nameresult_type: Filter by "token", "entity", or "any" (default: "any")chain: Optional blockchain filter (e.g., "ethereum", "solana", "base")limit: Maximum results (1-50, default: 25)
Example Request:
{
"search_query": "AAVE",
"result_type": "token",
"chain": "ethereum"
}Example Response:
Important Notes:
Prices may be delayed; use token OHLCV endpoints for real-time prices
Results are sorted by relevance/popularity rank
Use the
chainparameter (not the query string) to filter by blockchain
API key for authentication
Request model for general search endpoint.
This endpoint searches for tokens and entities by name, symbol, or address.
Search query - token name, symbol, contract address, or entity name.
AAVEType filter - 'token' for tokens only, 'entity' for entities only, 'any' for both.
anyPossible values: Optional chain filter to narrow down token results (e.g., 'ethereum', 'solana', 'base').
ethereumMaximum number of results to return (default: 25, max: 50).
25Search results with tokens and entities
Bad Request
Unauthorized
Forbidden
Not Found
Unprocessable Content
Too Many Requests
Internal Server Error
Bad Gateway
Service Unavailable
Gateway Timeout
POST /api/v1/search/general HTTP/1.1
Host: api.nansen.ai
apikey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 73
{
"search_query": "AAVE",
"result_type": "any",
"chain": "ethereum",
"limit": 25
}{
"tokens": [
{
"name": "text",
"symbol": "text",
"chain": "text",
"address": "text",
"price": 1,
"volume_24h": 1,
"market_cap": 1,
"rank": 1
}
],
"entities": [
{
"name": "text",
"tags": [
"text"
],
"rank": 1
}
],
"total_results": 1
}Search for entity names to use in other v1 endpoints that support entity_name parameters.
This endpoint helps users find the correct entity name format when they want to query by entity instead of address. Many endpoints accept either address or entity_name as parameters, but entity names must match exactly. This search endpoint makes it easy to find the right entity name.
Key Features:
Case-insensitive search that matches anywhere in the entity name
Returns up to 100 results ordered alphabetically
Minimum 2 character search query required
Free endpoint (0 credits)
Use Cases:
Find entity names for profiler endpoints: Search "vitalik" to find "Vitalik Buterin" for use in address balance or transaction queries
Discover exchange entities: Search "binance" to find all Binance-related entities
Locate fund entities: Search "jump" to find "Jump Trading" and related entities
Example Usage:
{
"search_query": "vitalik"
}Response:
{
"data": [
{"entity_name": "Vitalik Buterin"},
{"entity_name": "Vitalik Buterin: Charity"}
]
}Note: This endpoint does not support pagination as results are capped at 100 items.
API key for authentication
Request model for entity name search endpoint.
This endpoint helps users find the correct entity_name to use in other v1 endpoints that accept entity_name as a parameter.
Search query for entity names (minimum 2 characters). Search is case-insensitive and matches anywhere in the entity name.
vitalikList of matching entity names
Bad Request
Unauthorized
Forbidden
Not Found
Unprocessable Content
Too Many Requests
Internal Server Error
Bad Gateway
Service Unavailable
Gateway Timeout
POST /api/v1/search/entity-name HTTP/1.1
Host: api.nansen.ai
apikey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 26
{
"search_query": "vitalik"
}{
"data": [
{
"entity_name": "text"
}
]
}Get all available token sectors that can be used to filter tokens in the token-screener and other endpoints.
This endpoint returns the list of valid sector values that can be used in the token_sector filter parameter. Sectors are categories that describe a token's primary use case or market segment (e.g., "Artificial Intelligence", "DeFi Lending", "Memecoin").
Key Features:
Returns all sectors with 50+ tokens (filters out niche/one-off AI-generated sectors)
Results are ordered alphabetically
No parameters required
Free endpoint (0 credits)
Example Response:
{
"data": [
{"sector": "AI Agents"},
{"sector": "Artificial Intelligence"},
{"sector": "DeFi Lending (Money Markets)"},
{"sector": "GameFi"},
{"sector": "Memecoin"}
]
}Use Cases:
Discover filter options: Get valid sector values before calling token-screener
Build UI filters: Populate dropdown menus with available sectors
Validate input: Check if a sector value is valid before making API calls
API key for authentication
List of available token sectors
Bad Request
Unauthorized
Forbidden
Not Found
Unprocessable Content
Too Many Requests
Internal Server Error
Bad Gateway
Service Unavailable
Gateway Timeout
GET /api/v1/search/token-sectors HTTP/1.1
Host: api.nansen.ai
apikey: YOUR_API_KEY
Accept: */*
{
"data": [
{
"sector": "text"
}
]
}Last updated
Was this helpful?