From 74d7ce41217684cc176158810258244df5bb9590 Mon Sep 17 00:00:00 2001
From: Manan <manan@neynar.com>
Date: Wed, 1 Jul 2026 18:30:36 -0700
Subject: [PATCH] docs: remove deleted /api/tokens/{address}/holders endpoint

The holders endpoint is being deleted from clanker.world (dead route, zero
traffic, no SDK/client usage). Remove its section from the public API
reference so the docs no longer describe a route that doesn't exist.

Companion to clanker-devco/clanker.world#1686.
---
 api-reference/public/README.md |  1 -
 api-reference/public/tokens.md | 33 ---------------------------------
 2 files changed, 34 deletions(-)

diff --git a/api-reference/public/README.md b/api-reference/public/README.md
index a93fae6..eec9714 100644
--- a/api-reference/public/README.md
+++ b/api-reference/public/README.md
@@ -16,7 +16,6 @@ These endpoints are publicly accessible and require no authentication.
 - `POST /api/tokens/fetch-by-pool-addresses` — Returns token data for multiple pool addresses (max 100).
 - `GET /api/tokens/search` — Search tokens by query or FIDs. *(deprecated)*
 - `GET /api/tokens/estimate-rewards-by-pool-address` — Estimate uncollected rewards for a pool. *(deprecated)*
-- `GET /api/tokens/{address}/holders` — Returns holder count and top-10 concentration for a token.
 
 ### Users
 
diff --git a/api-reference/public/tokens.md b/api-reference/public/tokens.md
index b8cab9c..9da3642 100644
--- a/api-reference/public/tokens.md
+++ b/api-reference/public/tokens.md
@@ -203,36 +203,3 @@ Search tokens by query or FIDs.
 Estimate uncollected rewards for a pool.
 
 **Authentication:** Public
-
----
-
-### GET `/api/tokens/{address}/holders`
-
-Returns holder count and top-10 concentration for a token.
-
-**Authentication:** Public
-
-**Path Parameters**
-
-| Parameter | Type | Required | Default | Description |
-|-----------|------|----------|---------|-------------|
-| `address` | `address` | Yes | — | Token contract address. |
-
-**Query Parameters**
-
-| Parameter | Type | Required | Default | Description |
-|-----------|------|----------|---------|-------------|
-| `chain` | `number` | No | 8453 | Chain ID (defaults to Base). |
-
-**Response:** Holder statistics.
-
-```json
-{
-  "totalHolders": 4521,
-  "top10Sum": 45.2
-}
-```
-
-> Cached for 5 minutes.
-
----