Address Labels

Retrieves all entity and behavioural labels associated with an address on a chain.

Get Address Labels (Beta)

post

Get labels associated with a wallet address. Returns behavioral labels, social labels, DeFi labels, and more.

Note: This is a beta endpoint with a different request/response format than v1 endpoints.

Authorizations

ApiKeyAuth

apiKeystringRequired

API key for authentication

Body

application/json

Responses

200

Successful response

application/json

400

Bad request - Invalid parameters or request body

application/json

401

Authentication error - No API key found or user does not have access

application/json

403

Forbidden - User does not have required subscription tier

application/json

500

Internal server error

application/json

post

/api/beta/profiler/address/labels

HTTPcURLJavaScriptPython

POST /api/beta/profiler/address/labels HTTP/1.1
Host: api.nansen.ai
apiKey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 128

{
  "parameters": {
    "chain": "ethereum",
    "address": "text",
    "entity": "text",
    "label": "text"
  },
  "pagination": {
    "page": 1,
    "recordsPerPage": 100
  }
}

[
  {
    "label": "Deployer",
    "category": "others",
    "definition": "Person or smart contract who deploys a smart contract.",
    "smEarnedDate": "01/01/20",
    "fullname": "Alex Svanevik"
  }
]

Required Parameters

Field	Type	Description
chain	string	Blockchain network. Select all to query all EVM chains
address	string	The blockchain address to query for labels

Response Structure

The API returns an array of label objects with the following fields:

Field	Type	Description
label	string	The specific label name assigned to the address
category	string	The category of the label (see categories below)
definition	string	Detailed description of what the label represents
smEarnedDate	string/null	Date when the address earned Smart Money status (ISO format)
fullname	string	Full descriptive name or entity name associated with the label

Label Categories

• behavioral - Labels based on trading patterns and on-chain behavior

• defi - DeFi protocol interactions and usage

• social - Social identifiers and public profiles

• smart_money - Smart money and profitable trader classifications

• others - Miscellaneous labels including airdrops, platform usage, etc.

Example Request

json

{
  "parameters": {
    "chain": "solana",
    "address": "H1gJR25VXi5Ape1gAU7fTWzZFWaCpuP3rzRtKun8Dwo2"
  },
  "pagination": {
    "page": 1,
    "recordsPerPage": 100
  }
}

Example Response

json

[
  {
    "label": "hornybeliever.sol",
    "category": "social",
    "definition": "Shows an address owns a particular Solana Name Service domain name (ex. user.sol).",
    "smEarnedDate": null,
    "fullname": "🤓 👤 pow"
  },
  {
    "label": "Top 100 on PENGU Leaderboard",
    "category": "behavioral",
    "definition": "Address is on the Top 100 Addresses by Realized PnL for the token.",
    "smEarnedDate": null,
    "fullname": "🤓 👤 pow"
  },
  {
    "label": "30D Smart Trader",
    "category": "smart_money",
    "definition": "Top addresses based on their realized and unrealized profit in the last 30 days.",
    "smEarnedDate": null,
    "fullname": "🤓 👤 pow"
  }
]