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

# Money Flow

# Subscribing to Real-Time Token Money Flow (SUBSCRIBE\_MONEY\_FLOW)

`SUBSCRIBE_MONEY_FLOW` streams Solana token money-flow events grouped by wallet tags and event frames.

> [!WARNING]
>
> This subscription is supported only on Solana.

## WebSocket URL

```yaml theme={null}
wss://public-api.birdeye.so/socket/solana?x-api-key=YOUR-API-KEY
```

## Subscription

```json theme={null}
{
  "type": "SUBSCRIBE_MONEY_FLOW",
  "data": {
    "token_address": "h8E5CB7GAC5qx865EYPbaCNZShft9NHdAB4MJmcpump",
    "tags": ["whales", "kol"],
    "frames": ["1h", "24h"]
  }
}
```

* `token_address` is required and must be one valid Solana token address.
* `tags` is optional. Supported values are `smart_money`, `kol`, `whales`, and `all`.
* `frames` is optional. Supported values are `1m`, `5m`, `15m`, `30m`, `1h`, `2h`, `4h`, `6h`, `12h`, and `24h`.
* Values within each array use OR logic; `tags` and `frames` together use AND logic.
* Omit `tags` or `frames` to receive all tags or frames for the token.

The server sends events in this shape:

```json theme={null}
{
  "type": "MONEY_FLOW_DATA",
  "data": {
    "token_address": "h8E5CB7GAC5qx865EYPbaCNZShft9NHdAB4MJmcpump",
    "tag": "whales",
    "frame": "1h",
    "network": "solana"
  }
}
```

Each connection has one money-flow subscription. A valid re-subscribe replaces the previous filters. Unsubscribe with:

```json theme={null}
{"type":"UNSUBSCRIBE_MONEY_FLOW"}
```

Empty arrays, invalid values, or the old singular filter keys `tag` and `frame` return an `ERROR` message.


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