{"uid":"cap_kE-a0I-9WSVntsMe4mJTe","slug":"nansen-entity-name-dc379852","name":"Nansen Entity Name Search","description":"Search for entity names to use in other v1 endpoints that support `entity_name` parameters.\n\nThis 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.\n\n**Key Features:**\n- Case-insensitive search that matches anywhere in the entity name\n- Returns up to 100 results ordered alphabetically\n- Minimum 2 character search query required\n- Free endpoint (0 credits)\n\n**Use Cases:**\n1. **Find entity names for profiler endpoints**: Search \"vitalik\" to find \"Vitalik Buterin\" for use in address balance or transaction queries\n2. **Discover exchange entities**: Search \"binance\" to find all Binance-related entities\n3. **Locate fund entities**: Search \"jump\" to find \"Jump Trading\" and related entities\n\n**Example Usage:**\n```json\n{\n  \"search_query\": \"vitalik\"\n}\n```\n\n**Response:**\n```json\n{\n  \"data\": [\n    {\"entity_name\": \"Vitalik Buterin\"},\n    {\"entity_name\": \"Vitalik Buterin: Charity\"}\n  ]\n}\n```\n\n**Note:** This endpoint does not support pagination as results are capped at 100 items.","url":"https://api.nansen.ai/api/v1/search/entity-name?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","title":"EntityNameSearchRequest","required":["search_query"],"properties":{"search_query":{"type":"string","title":"Search Query","examples":["vitalik","binance","jump"],"maxLength":100,"minLength":2,"description":"Search query for entity names (minimum 2 characters). Search is case-insensitive and matches anywhere in the entity name."}},"description":"Request model for entity name search endpoint.\n\nThis endpoint helps users find the correct entity_name to use in other\nv1 endpoints that accept entity_name as a parameter.","additionalProperties":false},"responseSchema":{"type":"object","title":"EntityNameSearchResponse","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","title":"EntityNameSearchItem","required":["entity_name"],"properties":{"entity_name":{"type":"string","title":"Entity Name","description":"Entity name that can be used in other v1 endpoints"}},"description":"Single entity name result."},"title":"Data","description":"List of matching entity names (max 100 results, ordered alphabetically)"}},"description":"Response model for entity name search endpoint.\n\nReturns up to 100 entity names ordered alphabetically.\nNo pagination is provided as results are limited to 100 items."},"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 blockchain entity names (e.g. wallets, exchanges, funds) to use as exact parameters in other Nansen v1 endpoints.","exampleAgentPrompt":"Search Nansen's entity name index for 'binance' so I can get the exact entity name strings to use when querying wallet balances and transactions.","exampleUseCases":null,"resultDescription":"A JSON array of up to 100 entity name objects, each containing an `entity_name` string (e.g. 'Vitalik Buterin', 'Vitalik Buterin: Charity'), ordered alphabetically. No pagination — results are capped at 100 items.","failureModes":["Search query shorter than 2 characters returns a validation error","No matching entities found returns an empty data array","Query exceeding 100 characters returns a validation error","Network or API authentication errors return HTTP 4xx/5xx responses"],"whenToPreferThis":"Use this endpoint before calling any other Nansen v1 endpoint that accepts an `entity_name` parameter, when you only have a partial or informal name and need the exact canonical entity name string. It is free (0 credits) and should always be used to resolve entity names rather than guessing the exact format.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:35:47.846Z","isFirstParty":false,"canonicalSlug":"nansen-entity-name-dc379852"}