Address Labels

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

profiler/address/labels

post

Address and its labels

Authorizations

Body

Responses

200

Successful response

application/json

400

Bad request

application/json

401

Authentication error

application/json

403

Forbidden - Subscription tier required

application/json

500

Internal server error

application/json

post

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