Spec

Code snippets

curl "https://api.oanor.com/tradesize-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/tradesize-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/tradesize-api/v1/meta");
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/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

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

{
    "data": {
        "note": "symbol is a Binance pair (BTCUSDT) or coin=BTC&quote=USDT. Up to 5000 recent trades scanned (trades=N, default 2000). Cohorts are by USD notional. Read fresh per call; only the tradable-symbol list is cached hourly.",
        "source": "Binance public REST (api.binance.com/api/v3/aggTrades, live)",
        "service": "tradesize-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/symbols": "Tradable Binance pairs, optionally filtered by quote (quote=USDT).",
            "GET /v1/percentiles": "Trade-size percentiles, average, median and largest trade (symbol=BTCUSDT).",
            "GET /v1/distribution": "Trade volume by size cohort + whale share (symbol=BTCUSDT, trades=2000)."
        },
        "description": "Crypto trade-size distribution — the participant mix (retail vs whales) behind a pair's volume, from Binance's aggregated trade tape (no key, nothing stored). distribution buckets recent trades into size cohorts (micro <$1k, retail $1k-$10k, mid $10k-$100k, whale >$100k) with each cohort's count, volume and share, plus the whale-volume share. percentiles returns the trade-size percentiles (p50/p90/p99), the average, median and largest trade. symbols lists tradable pairs. The trade-size composition / participant-mix cut — distinct from the order-flow/CVD API (buy-vs-sell direction), order-book depth and price APIs.",
        "trading_symbols": 1370,
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-12T01:41:08.901Z",
        "request_id": "b5295d6e-84e7-421a-b235-de5d6ec61a2f"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}