Address Labels

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

Get Address Labels

post

Get labels for a wallet address. Returns non-premium labels only.

Labels include ENS domains, behavioral labels, DeFi labels, CEX labels, and more. Premium labels (smart money, alpha trader) are excluded from this endpoint.

Use /api/v1/profiler/address/premium-labels to get all labels including premium ones.

Authorizations

ApiKeyAuth

apiKeystringRequired

API key for authentication

Body

application/json

Request model for Address Labels endpoint.

addressstringRequired

Wallet address to get labels for

Example: 0x4a7c6899cdcb379e284fbfd045462e751da4c7ce

chainstring · enumRequired

Blockchain chain. Use 'all' to search all chains compatible with the address format.

Example: ethereumPossible values:

Responses

200

Address labels data

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

402

Payment Required

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Content

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

post

/api/v1/profiler/address/labels

HTTPcURLJavaScriptPython

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

{
  "address": "0x4a7c6899cdcb379e284fbfd045462e751da4c7ce",
  "chain": "ethereum",
  "pagination": {
    "page": 1,
    "per_page": 100
  }
}

{
  "pagination": {
    "page": 1,
    "per_page": 10,
    "is_last_page": true
  },
  "data": [
    {
      "label": "Token Millionaire",
      "category": "behavioral"
    }
  ]
}

Get Address Premium Labels

post

Get all labels for a wallet address, including premium labels.

Returns all labels including smart money labels, alpha trader labels, and public figure tags that are excluded from the standard /labels endpoint.

Authorizations

ApiKeyAuth

apiKeystringRequired

API key for authentication

Body

application/json

Request model for Address Labels endpoint.

addressstringRequired

Wallet address to get labels for

Example: 0x4a7c6899cdcb379e284fbfd045462e751da4c7ce

chainstring · enumRequired

Blockchain chain. Use 'all' to search all chains compatible with the address format.

Example: ethereumPossible values:

Responses

200

Address labels data (including premium)

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

402

Payment Required

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Content

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

post

/api/v1/profiler/address/premium-labels

HTTPcURLJavaScriptPython

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

{
  "address": "0x4a7c6899cdcb379e284fbfd045462e751da4c7ce",
  "chain": "ethereum",
  "pagination": {
    "page": 1,
    "per_page": 100
  }
}

{
  "pagination": {
    "page": 1,
    "per_page": 10,
    "is_last_page": true
  },
  "data": [
    {
      "label": "Token Millionaire",
      "category": "behavioral"
    }
  ]
}