Skip to content
oanor
Sign up free
Marketplace Pricing Features Sign in
GET /v1/distribution

Trade volume by size cohort + whale share

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/tradesize-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/tradesize-api/v1/distribution" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/tradesize-api/v1/distribution", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/tradesize-api/v1/distribution");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/tradesize-api/v1/distribution",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "note": "trades bucketed by USD notional: micro <$1k, retail $1k-$10k, mid $10k-$100k, whale >$100k. volume_share_pct is each cohort's share of total quote volume. A high whale share means the flow is institution-driven.",
        "source": "Binance",
        "symbol": "BTCUSDT",
        "cohorts": [
            {
                "label": "under $1k",
                "cohort": "micro",
                "trades": 2665,
                "base_volume": 4.05765,
                "quote_volume": 257055.77,
                "volume_share_pct": 4.66
            },
            {
                "label": "$1k-$10k",
                "cohort": "retail",
                "trades": 249,
                "base_volume": 10.28481,
                "quote_volume": 651526.46,
                "volume_share_pct": 11.8
            },
            {
                "label": "$10k-$100k",
                "cohort": "mid",
                "trades": 77,
                "base_volume": 49.68285,
                "quote_volume": 3147735.64,
                "volume_share_pct": 57.02
            },
            {
                "label": "over $100k",
                "cohort": "whale",
                "trades": 9,
                "base_volume": 23.10244,
                "quote_volume": 1463843.18,
                "volume_share_pct": 26.52
            }
        ],
        "trades_scanned": 3000,
        "window_seconds": 478.8,
        "total_quote_volume": 5520161.06,
        "whale_volume_share_pct": 26.52
    },
    "meta": {
        "timestamp": "2026-06-12T01:41:08.115Z",
        "request_id": "87865231-3930-4b8d-910c-a3072aee5726"
    },
    "status": "ok",
    "message": "Distribution retrieved successfully",
    "success": true
}