> ## Documentation Index
> Fetch the complete documentation index at: https://docs.serialized.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Wallet Labels

> Who a wallet is, in one call, with no chain to name: its labels (`proTrader`, `smartTrader`, `kol`, `freshTrader`, `dev`, and on Solana `sniper`, `bundler`, `whale`, `insider`), the entity behind it when it is a known exchange, bridge, market maker, protocol or fund, the trading platform it trades through, its first funding across every chain with the funder's name, logo and entity, and its profile with its linked wallets.

`GET /v1/wallet/labels` · **2 credits**

Who a wallet is, in one call, with no chain to name: its labels (`proTrader`, `smartTrader`, `kol`, `freshTrader`, `dev`, and on Solana `sniper`, `bundler`, `whale`, `insider`), the entity behind it when it is a known exchange, bridge, market maker, protocol or fund, the trading platform it trades through, its first funding across every chain with the funder's name, logo and entity, and its profile with its linked wallets.

> [!NOTE]
>
> A valid address always gets a full answer, never `null`: `labels` is `[]` when the wallet carries none, `labelTokens`, `entity`, `platform`, `funding` and `profile` are `null` when unknown. An address that is neither an EVM address nor a Solana address is refused (`400`, `INVALID_PARAM`).

> [!NOTE]
>
> `labels` lists the labels the wallet carries, in a fixed order: `dev`, `sniper`, `bundler`, `whale`, `proTrader`, `smartTrader`, `freshTrader`, `kol`, `insider`. A label we could not establish is left out, never asserted false. `proTrader` and `smartTrader` are the badges of `profile`; `kol` marks a known influencer wallet; `dev` a wallet that launched at least one token. On this endpoint `freshTrader` describes the wallet as a whole: its first funding, the oldest across every chain, is at most 7 days old.

> [!NOTE]
>
> `sniper`, `bundler`, `whale` and `insider` are judged on the wallet's 50 most recently traded tokens, on Solana: the wallet carries `sniper` or `bundler` when it has that label on at least 3 of them, `insider` on at least 2, `whale` on at least 1. `labelTokens` gives the counts behind them: `checked`, the number of those tokens whose labels are known, then one count per label. The counts cover `whale` on tokens launched since June 3, 2026, `bundler` on tokens launched since October 29, 2026 and `insider` on tokens launched since October 2, 2026. On EVM addresses `labelTokens` is `null` and these four labels are not served.

> [!NOTE]
>
> `entity` is set when the wallet itself is a known entity: its `name`, its `type` (`cex`, `bridge`, `mm`, `protocol` or `fund`; `null` when unknown), its `labels` (such as `hotWallet`, `coldWallet`, `depositWallet`, `custody`; `[]` when none) and its `logo` (an `https` URL, `null` when unknown). The vocabulary of `labels` is open and is not the same on Solana and on EVM addresses: display them, filter on `type`.

> [!NOTE]
>
> `platform` is the trading platform the wallet trades with (a terminal, bot, wallet app, aggregator, DEX router or launchpad app), on Solana and across every EVM chain, the same value as on the rows of [token holders](https://docs.serialized.xyz/endpoints/token-holders.md) and [top traders](https://docs.serialized.xyz/endpoints/token-top-traders.md). `id` is a stable lowercase identifier (such as `axiom`, `gmgn`, `trojan`, `pumpfun`, `uniswap`, `okx`), `name` the display name, `logo` an `https` URL (`null` when we host no logo for that platform). `platform` is `null` when not known.

> [!NOTE]
>
> `funding` is the wallet's first funding in a native coin, the oldest across every chain of its address family; `chain` says which one, and `funding` is `null` when none is known. `amountNative` is the raw amount (wei, lamports) as a string, exact; `amount` is the same amount in coin units, a number meant for display; `currency` is the native coin of that chain, under the address `/v1/token` serves it with. Dust fundings are not counted.

> [!NOTE]
>
> `funding.funder` is an object here (on `/v1/wallet/funding` it is the address): `name` is the funder's entity name when it is a known entity, else its display name, `null` when unknown; `logo` its picture; `entity` has the shape of `entity` above and is `null` when the funder is not a known entity. The entity tag of `/v1/wallet/funding` (`funderTag`) is `funding.funder.entity.name`.

> [!NOTE]
>
> `profile` and `linkedWallets` are exactly those of `GET /v1/wallet/profile`.

```bash cURL theme={null}
curl 'https://api.serialized.xyz/v1/wallet/labels?address=3b3zfYBQ61sEicY4bhQMKUvRo9bAxPYAz32uyAP9Cj9u' \
  -H 'Authorization: YOUR_API_KEY'
```

```json Response theme={null}
{
  "data": {
    "address": "3b3zfYBQ61sEicY4bhQMKUvRo9bAxPYAz32uyAP9Cj9u",
    "labels": [
      "whale"
    ],
    "labelTokens": {
      "checked": 50,
      "sniper": 0,
      "bundler": 0,
      "whale": 8,
      "insider": 0
    },
    "entity": null,
    "platform": null,
    "funding": {
      "chain": "solana",
      "funder": {
        "address": "5VCwKtCXgCJ6kit5FybXjvriW3xELsFDhYrPSqtJNmcD",
        "name": "OKX",
        "logo": "https://pbs.twimg.com/profile_images/1968722816154345472/vEj4j3o9_normal.jpg",
        "entity": {
          "name": "OKX",
          "type": "cex",
          "labels": [
            "custody"
          ],
          "logo": "https://pbs.twimg.com/profile_images/1968722816154345472/vEj4j3o9_normal.jpg"
        }
      },
      "fundedAt": 1634019095000,
      "txHash": "3TN6yZK7z9gUhKU8XXxhJdN3uDY5FRqGZeMY2rSZMKxUGENMtnwiF8KxhrgcNZfvey8da9BRRNcFgtSVKQNxDmCe",
      "amountNative": "3000000000",
      "amount": 3,
      "currency": {
        "symbol": "SOL",
        "name": "Solana",
        "decimals": 9,
        "logo": "https://cdn.serialized.xyz/dex/coin-sol.c107b7bd.png",
        "address": "So11111111111111111111111111111111111111112"
      }
    },
    "profile": null,
    "linkedWallets": []
  },
  "meta": {
    "asOf": 1794357470136
  }
}
```


## OpenAPI

````yaml openapi.json GET /v1/wallet/labels
openapi: 3.1.0
info:
  title: Serialized Data API
  description: >-
    On-chain data for trading apps - tokens, candles, token filters. Built on
    our own indexers. 19 EVM chains + Solana, live.
  version: 0.1.0
servers:
  - url: https://demo.serialized.xyz
    description: 'Demo: no key needed, read endpoints, rate-limited per IP'
  - url: https://api.serialized.xyz
    description: 'Production: your API key in the Authorization header'
security:
  - apiKey: []
  - {}
paths:
  /v1/wallet/labels:
    get:
      summary: Wallet Labels
      description: >-
        Who a wallet is, in one call, with no chain to name: its labels
        (`proTrader`, `smartTrader`, `kol`, `freshTrader`, `dev`, and on Solana
        `sniper`, `bundler`, `whale`, `insider`), the entity behind it when it
        is a known exchange, bridge, market maker, protocol or fund, the trading
        platform it trades through, its first funding across every chain with
        the funder's name, logo and entity, and its profile with its linked
        wallets.
      operationId: wallet-labels
      parameters:
        - schema:
            type: string
            x-default: 3b3zfYBQ61sEicY4bhQMKUvRo9bAxPYAz32uyAP9Cj9u
          in: query
          name: address
          required: true
          description: Wallet address (EVM hex, case-insensitive; Solana base58).
          example: 3b3zfYBQ61sEicY4bhQMKUvRo9bAxPYAz32uyAP9Cj9u
      responses:
        '200':
          description: Standard `{ data, meta }` envelope.
components:
  securitySchemes:
    apiKey:
      type: apiKey
      name: Authorization
      in: header
      description: Your raw API key (not needed on the demo server).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.