# get_money_flow

> money flow: coins ranked by dollars bought or sold

where tracked traders' dollars go: coins ranked by dollars bought (side buy) or sold (side sell) over 1h, 6h, 24h or 7d, with the number of traders.

- open without a key.
- REST: GET /v1/coins/flow
- about 20 calls a minute without a key, 60 with a key.
- read-only.

## parameters

| name | type | required | what it does |
| --- | --- | --- | --- |
| side | buy \| sell | yes | - |
| window | 1h \| 6h \| 24h \| 7d | yes | - |
| limit | integer | no | rows to return, default 10. ask for fewer to get a shorter answer. from 1 to 10 |

## call it over MCP

```
curl -s https://copy.top/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_money_flow","arguments":{"side":"buy","window":"24h","limit":10}}}'
```

the answer is in result.content[0].text, as a JSON string. an MCP client (Claude, Cursor, an agent framework) does this for you: ask in plain words and it picks the tool.

## call it over REST

```
curl -s 'https://copy.top/v1/coins/flow?side=buy&window=24h&limit=10'
```

## example answer

a real answer from 2026-11-22, shortened: lists cut to two items.

```
{
  "side": "buy",
  "window": "24h",
  "at": "2026-11-22T21:45:30.011Z",
  "coins": [
    {
      "chain": "robinhood",
      "token": "0x2e8c31162b855a2ffa90f6f8634643ad6f111e18",
      "symbol": "AI",
      "usd": 293713,
      "traders": 7
    },
    {
      "chain": "solana",
      "token": "BzPyyYCTmQNq2BcfQ4ANAvCYk54rnmQEXMFvFT8RhWMi",
      "symbol": "MCAT",
      "usd": 138138,
      "traders": 102
    }
  ]
}
```

## related

- [search](https://copy.top/docs/tools/search.md)
- [get_trader](https://copy.top/docs/tools/get-trader.md)
- [get_leaderboard](https://copy.top/docs/tools/get-leaderboard.md)
- [get_token](https://copy.top/docs/tools/get-token.md)
- [get_theses](https://copy.top/docs/tools/get-theses.md)
- [get_hot_coins](https://copy.top/docs/tools/get-hot-coins.md)
- [all docs](https://copy.top/docs.md)

---
html: https://copy.top/docs/tools/get-money-flow · all docs: https://copy.top/docs.md · copy.top is independent: not affiliated with fomo, pump.fun or Hyperliquid. the API is read-only: nothing here places an order. figures are data, not advice. trading crypto is risky and past performance does not predict results.
