---
description: Realtime notifications of updates for a specific token
---

# Token Changes

<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-changes",
    "parameters": {
      "token": "J8oHzv1HgmEAM5EViYgQVwnsPYJgoJFQECbhyhHpump"
    }
  }
}
// Unsubscribe
{
  "type": "unsubscribe",
  "payload": {
    "stream": "token-changes",
    // when no parameters are provided it will unsubscribe all token-changes 
    // that the client is subscribed to
    "parameters": {
      "token": "J8oHzv1HgmEAM5EViYgQVwnsPYJgoJFQECbhyhHpump"
    }
  }
}
```

***

### Incoming message structure

```json
{
    "type": "stream_data",
    "stream": "token-changes",
    "data": {
        "pool_id": "J8oHzv1HgmEAM5EViYgQVwnsPYJgoJFQECbhyhHpump",
        "mint": "J8oHzv1HgmEAM5EViYgQVwnsPYJgoJFQECbhyhHpump",
        "market_cap": {
            "quote": 28.905401742034773,
            "usd": 4253.936756318978
        },
        "liquidity": {
            "quote": 61.007045034,
            "usd": 8978.256506538735
        },
        "price": {
            "quote": 2.890540174203477e-8,
            "usd": 0.000004253936756318978
        },
        "decimals": 6,
        "token_supply": 1000000000,
        "liquidity_pool_burned": 100,
        "market": "pumpfun",
        "quote_token": "So11111111111111111111111111111111111111112",
        "bonding_curve": "GE4fHajgt2itC5epxqnd6X146h2UkSkcGGibwX9XiA8n",
        "curve_percentage": 2.233266579731179,
        "freeze_authority": null,
        "mint_authority": null,
        "deployer": "4876ndFv8RdxVHgt5Y9R7y7oVBQfhxEKzb2SnwTraTpf",
        "created_at": 1749875219258
    },
    "timestamp": 1749875605163
}
```
