# Nansen Premium Labels

> Nansen Premium Labels is a free API for AI agents from Nansen at api.nansen.ai, Free, status unknown (last checked 2026-10-10).

Retrieves all labels for a wallet address including exclusive smart money, alpha trader, and public figure tags not available in the standard labels endpoint.

## Facts

- Endpoint: POST https://api.nansen.ai/api/v1/profiler/address/premium-labels?utm_source=zero.xyz
- Price: Free
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Provider: Nansen
- Docs: https://docs.nansen.ai
- Website: https://nansen.ai
- Tags: blockchain, smart-money, wallet, tokens, defi, analytics, profiler, dex, pnl, onchain, prediction-market, data
- Canonical page: https://www.zero.xyz/c/nansen-premium-labels-96950e7c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ENZUrq9K2ysEW7P0izxmP

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability nansen-premium-labels-96950e7c -d '<json body>'
```

Example prompt: Pull all Nansen premium labels for the Ethereum wallet 0x4a7c6899cdcb379e284fbfd045462e751da4c7ce — I want to see if it has any smart money, alpha trader, or public figure tags that don't show up in the standard labels.

## When to prefer this

Use this endpoint when you need the full set of Nansen intelligence labels for a wallet, especially premium classifications like smart money tiers, alpha trader tags, and public figure associations. Prefer this over the standard /labels endpoint when completeness of labeling is critical for wallet profiling, due diligence, or signal generation.

## Known failure modes

- Invalid or unsupported chain enum value returns validation error
- Malformed wallet address format returns error
- Address not found on specified chain returns empty data array
- Pagination page/per_page out of bounds returns validation error
- Missing required fields (address or chain) returns 422 unprocessable entity

## How this service works

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.

Successful empty responses cost 0 credits; nonempty responses cost 500 credits.
The upfront balance check still requires 500 credits. Empty first pages for
a specific EVM chain may include a generic hint to use chain="all". The hint does not report whether labels exist on other chains.
Empty later pages are also free.
Derived address names can appear without labels scoped to the requested chain;
these make the response nonempty and it costs 500 credits.

## Output

Returns a paginated list of label objects, each with a label name (e.g. 'Token Millionaire', '30D Smart Trader') and a category (e.g. 'smart_money', 'behavioral', 'social'). Includes premium labels such as smart money signals, alpha trader designations, and public figure identifications that are excluded from the basic /labels endpoint.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "ProfilerAddressLabelsRequest",
 "examples": [
  {
   "chain": "ethereum",
   "address": "0x4a7c6899cdcb379e284fbfd045462e751da4c7ce",
   "pagination": {
    "page": 1,
    "per_page": 100
   }
  },
  {
   "chain": "solana",
   "address": "HuB5nXrX3AY1eCw688hXGdDgNcfWmZL74kXs7VUxLZFw",
   "pagination": {
    "page": 1,
    "per_page": 100
   }
  }
 ],
 "required": [
  "address",
  "chain"
 ],
 "properties": {
  "chain": {
   "enum": [
    "all",
    "arbitrum",
    "arc",
    "avalanche",
    "base",
    "bnb",
    "ethereum",
    "hyperevm",
    "hyperliquid",
    "iotaevm",
    "linea",
    "mantle",
    "monad",
    "optimism",
    "plasma",
    "polygon",
    "robinhood",
    "sei",
    "solana",
    "sonic",
    "tron"
   ],
   "type": "string",
   "title": "ProfilerLabelsChain",
   "description": "Chains supported for Profiler Address Labels endpoint."
  },
  "address": {
   "type": "string",
   "title": "Address",
   "examples": [
    "0x4a7c6899cdcb379e284fbfd045462e751da4c7ce",
    "HuB5nXrX3AY1eCw688hXGdDgNcfWmZL74kXs7VUxLZFw"
   ],
   "description": "Wallet address to get labels for"
  },
  "pagination": {
   "type": "object",
   "title": "PaginationRequest",
   "properties": {
    "page": {
     "type": "integer",
     "title": "Page",
     "default": 1,
     "minimum": 1,
     "description": "Page number (1-based)"
    },
    "per_page": {
     "type": "integer",
     "title": "Per Page",
     "default": 10,
     "maximum": 1000,
     "minimum": 1,
     "description": "Number of records per page (max 1000)"
    }
   },
   "description": "Pagination parameters for API requests."
  }
 },
 "description": "Request model for Address Labels endpoint.",
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "ProfilerAddressLabelsResponse",
 "required": [
  "pagination",
  "data"
 ],
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "ProfilerAddressLabel",
    "required": [
     "label"
    ],
    "properties": {
     "kind": {
      "type": "array",
      "items": {
       "type": "string"
      },
      "title": "Kind",
      "examples": [
       [
        "entity",
        "name"
       ],
       [
        "entity-tag"
       ],
       []
      ],
      "description": "Label type/classifications, such as entity, name, or entity-tag"
     },
     "label": {
      "type": "string",
      "title": "Label",
      "examples": [
       "Token Millionaire",
       "nansen.eth",
       "30D Smart Trader"
      ],
      "description": "The label name"
     },
     "category": {
      "anyOf": [
       {
        "type": "string"
       }
      ],
      "title": "Category",
      "examples": [
       "behavioral",
       "social",
       "smart_money"
      ],
      "description": "Label category (smart_money, behavioral, defi, social, cefi, nft, others)"
     }
    },
    "description": "A single label for a wallet address."
   },
   "title": "Data",
   "description": "List of labels for the address"
  },
  "hint": {
   "anyOf": [
    {
     "type": "string"
    }
   ],
   "title": "Hint",
   "description": "Generic suggestion to use chain='all' on an empty first page for a specific EVM chain. It does not indicate whether labels exist elsewhere."
  },
  "pagination": {
   "type": "object",
   "title": "PaginationInfo",
   "properties": {
    "page": {
     "type": "integer",
     "title": "Page",
     "default": 1,
     "minimum": 1,
     "description": "Current page number"
    },
    "per_page": {
     "type": "integer",
     "title": "Per Page",
     "default": 10,
     "maximum": 1000,
     "minimum": 1,
     "description": "Number of records per page"
    },
    "is_last_page": {
     "type": "boolean",
     "title": "Is Last Page",
     "default": true,
     "description": "Whether this is the last page"
    }
   },
   "description": "Pagination information for API responses."
  }
 },
 "description": "Response model for Address Labels endpoint."
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nansen-premium-labels-96950e7c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.nansen.ai](https://www.zero.xyz/host/api.nansen.ai/llms.txt)