GET /v1/flow

Time-bucketed buy/sell pressure from the Binance spot aggregate trade stream only. Futures flow is not available here — use GET /v1/candles?source=binance_futures for futures OHLCV.

Credits: Per OpenAPI (base + per row where applicable)

Tier (history depth): Free 7d · Pro 6mo · Business full

Parameters

Parameter	Type	Required	Default	Description
`api-key`	string	Yes	—	`X-API-Key` header (recommended) or `api-key` query. Authentication.
`symbol`	string	Yes	—	`BTC`, `ETH`, `SOL`, `XRP`.
`interval`	string	Yes	—	`5m`, `15m`, `1h`, `4h`, `24h`.
`start`	string	No	—	ISO-8601 UTC start.
`end`	string	No	—	ISO-8601 UTC end.
`limit`	integer	No	`500`	Max rows (see OpenAPI for max).
`after`	string	No	—	Cursor from `meta.next_cursor`.

Each row includes buy_volume, sell_volume, num_buys, num_sells, vwap_buy, vwap_sell, net_volume, buy_ratio, etc. See OpenAPI → /v1/flow.

Example

import requests

resp = requests.get(
    "https://kwery-api.com/v1/flow",
    headers={"X-API-Key": "YOUR_KEY"},
    params={"symbol": "BTC", "interval": "1h", "limit": 10},
)
print(resp.json())

Query parameter alternative: api-key=YOUR_KEY on the URL.