---
title: "Get Token Holders (Top 100)"
method: GET
path: "/tokens/{tokenAddress}/holders"
tags: ["Tokens"]
---

# Get Token Holders (Top 100)

`GET /tokens/{tokenAddress}/holders`

Gets the top 100 holders for a specific token and the total holder count. Optional enrichment adds wallet identity (`?enrich=identity`) and/or PnL (`?enrich=walletPnl`). Use `?enrich=identity,walletPnl`, `?enrich=all`, or `?enrich=*` for both. When enrichment is requested, the response includes an `enrich` array listing applied modules. `pnl.token` uses the same flat field set as PnL V2 (`invested`, `proceeds`, trade counts, volume, timing, `avgCost`, `holdTimeSecs`). `pnl.wallet` is lifetime wallet PnL. Enrichment fields are omitted per account when not applicable — for example, pool accounts may have `identity` only, and wallets with no trade history for the token omit `pnl`.

## Path parameters

- `tokenAddress` string, required

## Query parameters

- `enrich` string

## Response `200`

Successful response

- HoldersResponse
  - `total` integer
  - `enrich` string[] — List of enrichment modules applied to this response. Omitted when enrichment is not requested.
  - `accounts` HolderAccount[]
    - `wallet` string
    - `amount` number
    - `value` object
      - `quote` number
      - `usd` number
    - `percentage` number
    - `pnl` object — Optional enrichment when `walletPnl` is requested and the wallet has traded this token. `wallet` is lifetime wallet PnL; `token` is flat per-token position PnL aligned with PnL V2.
      - `wallet` EnrichedWalletPnl
        - `realized` number
        - `unrealized` number
        - `total` number
        - `invested` number
        - `proceeds` number
        - `totalTrades` integer
        - `tokensTraded` integer
      - `token` EnrichedTokenPnl — Per-token PnL for the holder on this mint. Present when `walletPnl` enrichment is requested.
        - `realized` number — Profit/loss from closed trades on this token (USD).
        - `unrealized` number — Paper profit/loss on tokens still held (USD).
        - `total` number — Sum of realized + unrealized PnL (USD).
        - `invested` number — Total cost basis — USD spent buying this token.
        - `proceeds` number — Total USD received from sales of this token.
        - `buys` integer — Number of buy transactions.
        - `sells` integer — Number of sell transactions.
        - `totalTrades` integer — Total transactions (buys + sells).
        - `roi` number — Return on investment percentage.
        - `balance` number — Current token balance (native units).
        - `costBasis` number — Cost basis of remaining held tokens (USD).
        - `value` number — Current USD value of held tokens.
        - `price` number — Current token price in USD.
        - `totalBought` number — Total tokens purchased (native units).
        - `totalSold` number — Total tokens sold (native units).
        - `avgBuy` number — Average buy size in USD.
        - `avgSell` number — Average sell size in USD.
        - `firstBuy` integer, nullable — Unix ms timestamp of the first buy.
        - `lastBuy` integer, nullable — Unix ms timestamp of the most recent buy.
        - `firstSell` integer, nullable — Unix ms timestamp of the first sell.
        - `lastSell` integer, nullable — Unix ms timestamp of the most recent sell.
        - `firstTrade` integer, nullable — Unix ms timestamp of the first trade.
        - `lastTrade` integer, nullable — Unix ms timestamp of the most recent trade.
        - `avgCost` number, nullable — Average cost per token in USD.
        - `holdTimeSecs` integer, nullable — How long the position has been (or was) held, in seconds (first buy to last sell for closed bags, live duration for open bags).
    - `identity` EnrichedIdentity — Optional token-context identity enrichment for a holder wallet. Only known fields are returned. Common `type` values include `pool`, `bot`, `kol`, `developer`, and platform tags.
      - `name` string
      - `twitter` string
      - `avatar` string
      - `type` string — Primary label for single-badge UIs, such as `pool`, `bot`, `kol`, `developer`, or a platform tag.
      - `tags` string[]
      - `platforms` string[]
      - `pool` object
        - `program` string
        - `poolAddress` string
      - `developer` object
        - `token` string
        - `via` string[]
        - `pools` string[]
        - `creationTx` string
        - `createdAt` integer
      - `bot` object
        - `name` string, nullable
        - `avatar` string, uri, nullable

---

[API](https://skmtc.net/solanatracker/apis/solana-tracker-data-api.md) · [All operations](https://skmtc.net/solanatracker/apis/solana-tracker-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solanatracker/solana-tracker-data-api/versions/c07c6f82d0c4/schema)