---
title: "Changes to Top Token Holders by Token Address"
method: GET
path: "/onchain/networks/{network}/tokens/{address}/top_holders"
---

# Changes to Top Token Holders by Token Address

`GET /onchain/networks/{network}/tokens/{address}/top_holders`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 4 of 19 revisions.

- **2026-05-28** `11cc9e00fd86` — 2 breaking, 13 info
- **2026-04-30** `fb6b6a203ce6` — 8 breaking
- **2026-02-25** `e88de4e81cdb` — 9 info
- **2025-09-22** `91c83447321b` — 1 breaking

## Changes

- **2026-05-28** `11cc9e00fd86` — 2 breaking, 13 info
  - for the `query` request parameter `holders`, default value `1` was removed
  - for the `query` request parameter `include_pnl_details`, default value `false` was removed
  - api tag `Tokens` removed
  - the response property `data` became required for the status `200`
  - the response property `data/attributes` became required for the status `200`
  - the response property `data/attributes/holders` became required for the status `200`
  - the response property `data/attributes/holders/items/address` became required for the status `200`
  - the response property `data/attributes/holders/items/amount` became required for the status `200`
  - the response property `data/attributes/holders/items/label` became required for the status `200`
  - the response property `data/attributes/holders/items/percentage` became required for the status `200`
  - the response property `data/attributes/holders/items/rank` became required for the status `200`
  - the response property `data/attributes/holders/items/value` became required for the status `200`
  - the response property `data/attributes/last_updated_at` became required for the status `200`
  - the response property `data/id` became required for the status `200`
  - the response property `data/type` became required for the status `200`
- **2026-04-30** `fb6b6a203ce6` — 8 breaking
  - the response property `data/attributes/holders/items/average_buy_price_usd` became nullable for the status `200`
  - the response property `data/attributes/holders/items/label` became nullable for the status `200`
  - the response property `data/attributes/holders/items/realized_pnl_percentage` became nullable for the status `200`
  - the response property `data/attributes/holders/items/realized_pnl_usd` became nullable for the status `200`
  - the response property `data/attributes/holders/items/total_buy_count` became nullable for the status `200`
  - the response property `data/attributes/holders/items/total_sell_count` became nullable for the status `200`
  - the response property `data/attributes/holders/items/unrealized_pnl_percentage` became nullable for the status `200`
  - the response property `data/attributes/holders/items/unrealized_pnl_usd` became nullable for the status `200`
- **2026-02-25** `e88de4e81cdb` — 9 info
  - added the new optional `query` request parameter `include_pnl_details`
  - added the optional property `data/attributes/holders/items/average_buy_price_usd` to the response with the `200` status
  - added the optional property `data/attributes/holders/items/explorer_url` to the response with the `200` status
  - added the optional property `data/attributes/holders/items/realized_pnl_percentage` to the response with the `200` status
  - added the optional property `data/attributes/holders/items/realized_pnl_usd` to the response with the `200` status
  - added the optional property `data/attributes/holders/items/total_buy_count` to the response with the `200` status
  - added the optional property `data/attributes/holders/items/total_sell_count` to the response with the `200` status
  - added the optional property `data/attributes/holders/items/unrealized_pnl_percentage` to the response with the `200` status
  - added the optional property `data/attributes/holders/items/unrealized_pnl_usd` to the response with the `200` status
- **2025-09-22** `91c83447321b` — 1 breaking
  - for the `query` request parameter `holders`, default value `1` was added

---

[Operation](https://skmtc.dev/coingecko/apis/coingecko-api/docs/onchain/networks/:network/tokens/:address/top_holders/get.md) · [API](https://skmtc.dev/coingecko/apis/coingecko-api.md) · [Page](https://skmtc.dev/coingecko/apis/coingecko-api/changes/onchain/networks/:network/tokens/:address/top_holders/get)