---
title: "Retrieve address label data"
method: POST
path: "/api/v1/profiler/address/labels"
tags: ["Profiler"]
---

# Retrieve address label data

`POST /api/v1/profiler/address/labels`

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.

## Request body

- ProfilerAddressLabelsRequest — Request model for Address Labels endpoint.
  - `address` string, required — Wallet address to get labels for
  - `chain` 'all' | 'arbitrum' | 'avalanche' | 'base' | 'bnb' | 'ethereum' | 'hyperevm' | 'hyperliquid' | 'iotaevm' | 'linea' | 'mantle' | 'monad' | 'optimism' | 'plasma' | 'polygon' | 'robinhood' | 'sei' | 'solana' | 'sonic' | 'tron', required — Chains supported for Profiler Address Labels endpoint.
  - `pagination` PaginationRequest — Pagination parameters for API requests.
    - `page` integer — Page number (1-based)
    - `per_page` integer — Number of records per page (max 1000)

## Response `200`

Address labels data

- ProfilerAddressLabelsResponse — Response model for Address Labels endpoint.
  - `pagination` PaginationInfo, required — Pagination information for API responses.
    - `page` integer — Current page number
    - `per_page` integer — Number of records per page
    - `is_last_page` boolean — Whether this is the last page
  - `data` ProfilerAddressLabel[], required — List of labels for the address
    - `label` string, required — The label name
    - `category` string — Label category (smart_money, behavioral, defi, social, cefi, nft, others)

## Other responses

- `400` — Bad Request - Invalid request parameters or malformed request
- `401` — Authentication error - No API key found in request
- `403` — Forbidden - User does not have required subscription tier or has exceeded credit limit
- `404` — Not Found - The requested resource was not found
- `422` — Validation error - Invalid request parameters
- `429` — Too Many Requests - Rate limit exceeded
- `500` — Internal Server Error - An unexpected error occurred

---

[API](https://skmtc.net/nansen/apis/nansen-api.md) · [All operations](https://skmtc.net/nansen/apis/nansen-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nansen/nansen-api/revisions/02a4d2e7d827/schema)