🆕Entity Name Search

Use this endpoint to find correct entity name format to use in Supported Profiler Endpoints (Consumes 0 Credits)

Search for Entity Names

post

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:

1. Find entity names for profiler endpoints: Search "vitalik" to find "Vitalik Buterin" for use in address balance or transaction queries

2. Discover exchange entities: Search "binance" to find all Binance-related entities

3. 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.

Authorizations

ApiKeyAuth

apiKeystringRequired

API key for authentication

Body

application/json

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_querystring · min: 2Required

Search query for entity names (minimum 2 characters). Search is case-insensitive and matches anywhere in the entity name.

Example: vitalik

Responses

200

List of matching entity names

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Entity

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

post

/api/v1/search/entity-name

HTTPcURLJavaScriptPython

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"
    }
  ]
}