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-flowPlan: 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.
Errors
Standard errors apply: see Rate limits and errors.