{"uid":"cap_vsdkWD_1JwcLZjSuSOy_R","slug":"nansen-general-107285db","name":"Nansen General Search","description":"Search for tokens and entities by name, symbol, or contract address. This endpoint provides a unified search experience across all Nansen data.\n\n**Use Cases:**\n1. **Find token addresses**: Search by name or symbol to get contract addresses (e.g., \"AAVE\", \"Uniswap\")\n2. **Discover entities**: Find known entities like exchanges, funds, and public figures (e.g., \"vitalik\", \"Binance\")\n3. **Resolve addresses**: Search by contract address to identify tokens\n4. **Filter by chain**: Narrow down results to specific blockchains\n\n**Search Parameters:**\n- `search_query`: Token name, symbol, contract address, or entity name\n- `result_type`: Filter by \"token\", \"entity\", or \"any\" (default: \"any\")\n- `chain`: Optional blockchain filter (e.g., \"ethereum\", \"solana\", \"base\")\n- `limit`: Maximum results (1-50, default: 25)\n\n**Example Request:**\n```json\n{\n  \"search_query\": \"AAVE\",\n  \"result_type\": \"token\",\n  \"chain\": \"ethereum\"\n}\n```\n\n**Example Response:**\n```json\n{\n  \"tokens\": [\n    {\n      \"name\": \"Aave\",\n      \"symbol\": \"AAVE\",\n      \"chain\": \"ethereum\",\n      \"address\": \"0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9\",\n      \"price\": 123.45,\n      \"volume_24h\": 50000000,\n      \"market_cap\": 1500000000,\n      \"rank\": 25\n    }\n  ],\n  \"entities\": [],\n  \"total_results\": 1\n}\n```\n\n**Important Notes:**\n- Prices may be delayed; use token OHLCV endpoints for real-time prices\n- Results are sorted by relevance/popularity rank\n- Use the `chain` parameter (not the query string) to filter by blockchain","url":"https://api.nansen.ai/api/v1/search/general?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","title":"GeneralSearchRequest","required":["search_query"],"properties":{"chain":{"anyOf":[{"type":"string"}],"title":"Chain","examples":["ethereum","solana","base","bnb","polygon"],"description":"Optional chain filter to narrow down token results (e.g., 'ethereum', 'solana', 'base')."},"limit":{"type":"integer","title":"Limit","default":25,"maximum":50,"minimum":1,"description":"Maximum number of results to return (default: 25, max: 50)."},"result_type":{"enum":["token","entity","any"],"type":"string","title":"Result Type","default":"any","description":"Type filter - 'token' for tokens only, 'entity' for entities only, 'any' for both."},"search_query":{"type":"string","title":"Search Query","examples":["AAVE","vitalik","0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9"],"maxLength":200,"minLength":1,"description":"Search query - token name, symbol, contract address, or entity name."}},"description":"Request model for general search endpoint.\n\nThis endpoint searches for tokens and entities by name, symbol, or address.","additionalProperties":false},"responseSchema":{"type":"object","title":"GeneralSearchResponse","required":["total_results"],"properties":{"tokens":{"type":"array","items":{"type":"object","title":"TokenSearchResult","required":["name","symbol","chain","address"],"properties":{"name":{"type":"string","title":"Name","description":"Token name"},"rank":{"anyOf":[{"type":"integer"}],"title":"Rank","description":"Popularity/relevance rank (lower is better)"},"chain":{"type":"string","title":"Chain","description":"Blockchain the token is deployed on"},"price":{"anyOf":[{"type":"number"}],"title":"Price","description":"Current price in USD (may be delayed)"},"symbol":{"type":"string","title":"Symbol","description":"Token symbol (ticker)"},"address":{"type":"string","title":"Address","description":"Contract address of the token"},"market_cap":{"anyOf":[{"type":"number"}],"title":"Market Cap","description":"Market capitalization in USD"},"volume_24h":{"anyOf":[{"type":"number"}],"title":"Volume 24H","description":"24-hour trading volume in USD"}},"description":"A token result from general search."},"title":"Tokens","default":[],"description":"List of matching tokens"},"entities":{"type":"array","items":{"type":"object","title":"EntitySearchResult","required":["name"],"properties":{"name":{"type":"string","title":"Name","description":"Entity name"},"rank":{"anyOf":[{"type":"integer"}],"title":"Rank","description":"Popularity/relevance rank (lower is better)"},"tags":{"type":"array","items":{"type":"string"},"title":"Tags","default":[],"description":"Category tags for the entity"}},"description":"An entity result from general search."},"title":"Entities","default":[],"description":"List of matching entities"},"total_results":{"type":"integer","title":"Total Results","description":"Total number of results returned"}},"description":"Response model for general search endpoint.\n\nReturns separate lists for tokens and entities, allowing clients to handle\neach type appropriately."},"example":null,"exampleRequest":null,"tags":["blockchain","smart-money","wallet","tokens","defi","analytics","profiler","dex","pnl","onchain","prediction-market","data"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"free","summary":"Free","primary":null,"accepted":[]},"paymentMethods":[],"brandName":"Nansen","brandSlug":"nansen","brandBaseUrl":"https://nansen.ai","brandDocsUrl":"https://docs.nansen.ai","whatItDoes":"Search for crypto tokens and on-chain entities by name, symbol, contract address, or entity name across all Nansen data","exampleAgentPrompt":"Can you look up the contract address and price for AAVE on Ethereum using Nansen's search? Search for token type only.","exampleUseCases":null,"resultDescription":"Returns two lists — matched tokens (with name, symbol, chain, contract address, price, 24h volume, market cap, and rank) and matched entities (with name, rank, and category tags) — plus a total result count. Results are ordered by relevance and popularity rank.","failureModes":["Empty results if the search query matches no known tokens or entities","Chain filter mismatch returns no tokens if the token doesn't exist on the specified chain","Overly broad queries may return up to 50 results requiring further filtering","Contract address typos result in zero matches","Prices may be delayed or missing for low-liquidity tokens","Request fails with validation error if search_query is empty or exceeds 200 characters","Limit parameter out of range (below 1 or above 50) returns validation error"],"whenToPreferThis":"Use this endpoint when you need to resolve a token name or symbol to its contract address, identify an entity by name, or discover metadata about tokens before calling more specific Nansen endpoints like DEX trades or wallet profiling. Prefer this over chain-specific lookups when you don't know which chain a token is on. It's the right starting point for any workflow that needs to map human-readable names to on-chain identifiers.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:30:45.044Z","isFirstParty":false,"canonicalSlug":"nansen-general-107285db"}