Overview

The Labels API resolves raw wallet and contract addresses into human-readable names and categories. Instead of seeing 0x1111111254fb6c44bac0bed2854e76f90643097d, you see "1inch: Router" with a dex tag.

What It Does

Given one or more addresses on a network, the Labels API returns:

Label -- a human-readable name (e.g. "Binance: Hot Wallet 1", "Uniswap V3: Router", "Wintermute")
Tags -- categories that describe what the address does (e.g. cex, dex, market-maker, bridge)
Smart contract flag -- whether the address is a smart contract or an externally-owned wallet

This is useful for:

Enriching holder lists -- turn top holder addresses into recognizable entities
Transaction labelling -- identify counterparties in transfer histories
Risk assessment -- know if top holders are exchanges, market makers, or unknown wallets
Cluster context -- combine with cluster data to understand who controls related wallet groups

Endpoint

GET /labels/v1/{network}/{addresses}

Parameter	Type	Description
`network`	path	Network ID: `sol`, `eth`, `base`, `bsc`, `monad`, `xlayer`, `abs`
`addresses`	path	Comma-separated list of wallet or contract addresses (max 100)

Example Request

GET /labels/v1/sol/9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM,42brAgAVNzMBP7aaktPvAmBSPEkehnFQejiZc53EpJFd

Response

[
  {
    "address": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
    "label": "Wintermute",
    "tags": ["market-maker"],
    "smart_contract": false
  },
  {
    "address": "42brAgAVNzMBP7aaktPvAmBSPEkehnFQejiZc53EpJFd",
    "label": "Raydium: Authority V4",
    "tags": ["dex"],
    "smart_contract": true
  }
]

Response Fields

Field	Type	Description
`address`	string	The queried address
`label`	string	Human-readable name for the address
`tags`	array	Categories describing the address
`smart_contract`	boolean	`true` if the address is a smart contract on this network

Tag Categories

Labels are tagged with one or more of the following categories:

Tag	Description
`cex`	Centralized exchange (Binance, Coinbase, Kraken, etc.)
`dex`	Decentralized exchange or AMM (Uniswap, Raydium, Orca, etc.)
`market-maker`	Known market maker (Wintermute, Jump, Alameda, etc.)
`bridge`	Cross-chain bridge contract
`lending`	Lending/borrowing protocol
`staking`	Staking contract or validator
`nft`	NFT marketplace or minting contract
`governance`	DAO or governance contract
`token`	Token contract or treasury

The tag vocabulary may expand over time as new address categories are identified.

Limits

Maximum 100 addresses per request.
Addresses that are not found in the label database are still returned with an empty label and tags.