# Block-trade flow (market)

> Net buying and selling in large trades (₦10 million and up) by stock over the last N days: where the big money is going.

```http
GET https://koboterminal.com/api/whale-flow
```

**Plan:** Free and above (free key, no card).

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `days` | query | integer | no | Window in days, 1 to 90 (default 30) (e.g. `30`) |

## Request

```bash
curl "https://koboterminal.com/api/whale-flow?days=30" \
  -H "X-API-Key: $KOBO_API_KEY"
```

```python
import os, requests

r = requests.get(
    "https://koboterminal.com/api/whale-flow",
    params={"days": "30"},
    headers={"X-API-Key": os.environ["KOBO_API_KEY"]},
    timeout=30,
)
r.raise_for_status()
data = r.json()
```

```javascript
const res = await fetch("https://koboterminal.com/api/whale-flow?days=30", {
  headers: { "X-API-Key": process.env.KOBO_API_KEY },
});
if (!res.ok) throw new Error(`Kobo API ${res.status}`);
const data = await res.json();
```

## Response

Real response from the live API on 18 November 2026, trimmed to the first item of each list:

```json
{
  "success": true,
  "days": 30,
  "as_of": "2026-11-18T22:39:34.975Z",
  "count": 77,
  "inflow": [
    {
      "symbol": "SEPLAT",
      "name": "SEPLAT ENERGY PLC",
      "buy_value": 11542002195.1,
      "sell_value": 5914461576.1,
      "unknown_value": 262753642.2,
      "net_value": 5627540619,
      "trade_count": 222,
      "last_trade": "2026-11-18T15:00:00.002+00:00"
    }
  ],
  "outflow": [
    {
      "symbol": "ARADEL",
      "name": "ARADEL HOLDINGS PLC",
      "buy_value": 235569084.7,
      "sell_value": 13743966685.9,
      "unknown_value": 28100000,
      "net_value": -13508397601.2,
      "trade_count": 402,
      "last_trade": "2026-11-18T13:58:12.394+00:00"
    }
  ]
}
```

## Use it from an AI assistant

This endpoint is available as the `get_block_trade_flow` tool on the Kobo Terminal MCP server (`https://koboterminal.com/mcp`). See [MCP server](https://koboterminal.com/docs/mcp).

## Errors

Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors).
