---
description: Realtime notifications of holder count change for a token
---

# Token Holders

<table><thead><tr><th width="119">Basic</th><th width="120">Premium</th><th width="120">Enterprise</th><th width="170">Credit Cost</th></tr></thead><tbody><tr><td>❌</td><td>✅</td><td>✅</td><td>0</td></tr></tbody></table>

***

### Subscribe / Unsubscribe

```json
// Subscribe 
{
  "type": "subscribe",
  "payload": {
    "stream": "token-holders",
    "parameters": {
      "token": "BuXsYHrq8L3V8taLtq7AE4xsmKT8MhCGSaLjdUoLpump"
    }
  }
}
// Unsubscribe
{
  "type": "unsubscribe",
  "payload": {
    "stream": "token-holders",
    // when no parameters are provided it will unsubscribe all token-holders 
    // that the client is subscribed to
    "parameters": {
      "token": "BuXsYHrq8L3V8taLtq7AE4xsmKT8MhCGSaLjdUoLpump"
    }
  }
}
```

***

### Incoming message structure

```json
{
    "type": "stream_data",
    "stream": "token-holders",
    "data": {
        "mint": "82cwn8QamJCNGkrP43CW3HVgK4qziBt2Bk8NugxZpump",
        "holders": 232
    },
    "timestamp": 1749860242493
}
```
