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

# Holder Concentration

> Whale holder concentration, Gini distribution coefficient, and LP lock telemetry

# Holder & Whale Concentration

Computes on-chain token distribution analytics to identify insider syndicates, cabal wallet clusters, and liquidity pool lock percentages.

***

### Parameters

**address** `string` *required*

The token contract address.

**chain** `string` (default: ethereum)

Target blockchain network (`ethereum`, `bsc`, `polygon`, `arbitrum`, `base`, `solana`).

***

### Metric Highlights

* **Top 10 Concentration (%)**: Percentage of circulating supply controlled by the 10 largest non-pool wallets.
* **Creator Balance (%)**: Percentage still retained by the deploying wallet.
* **LP Pool Lock (%)**: Proportion of decentralized liquidity locked in verifiable time-lock contracts (Unicrypt, PinkSale, Team Finance).
* **Cluster Sybil Detection**: Identifies whether top holders were funded by a single root wallet prior to launch.

***

### Code Examples

```bash cURL theme={null}
curl -X GET "https://api.cryptechtoday.com/api/v1/token/0x514910771AF9Ca656af840dff83E8264EcF986CA/holders?chain=ethereum" \
  -H "X-API-Key: YOUR_API_KEY"
```

```python Python theme={null}
import requests

address = "0x514910771AF9Ca656af840dff83E8264EcF986CA"
res = requests.get(
    f"https://api.cryptechtoday.com/api/v1/token/{address}/holders",
    headers={"X-API-Key": "YOUR_API_KEY"}
)
holders = res.json()

print(f"Top 10 Concentration: {holders.get('top_10_percent')}%")
print(f"LP Locked: {holders.get('lp_locked_percent')}%")
```

```typescript TypeScript theme={null}
import axios from 'axios';

const address = '0x514910771AF9Ca656af840dff83E8264EcF986CA';
const { data } = await axios.get(
  `https://api.cryptechtoday.com/api/v1/token/${address}/holders`,
  { headers: { 'X-API-Key': process.env.CRYPTECH_API_KEY } }
);

console.log(`Creator Retains: ${data.creator_balance_percent}% of supply`);
```


## Related topics

- [Quickstart](https://docs.cryptechtoday.com/quickstart.md)
- [Analyze Token](https://docs.cryptechtoday.com/api-reference/analyze-token.md)
- [Introduction](https://docs.cryptechtoday.com/index.md)


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