{"openapi":"3.1.0","info":{"title":"Crypto Trade Size Distribution API","version":"1.0.0","description":"Who is actually trading a pair — retail or whales — read from the composition of Binance's aggregated trade tape by trade size, no key, nothing stored. Order flow tells you the net direction; this tells you the size profile behind it: whether a move is driven by a swarm of small retail prints or a handful of large institutional ones, often the more important signal. The distribution endpoint scans the recent aggregated trades for a pair and buckets them into size cohorts (micro under $1k, retail $1k-$10k, mid $10k-$100k, whale over $100k), returning each cohort's trade count, volume in base and quote and its share of total volume, plus the whale-volume share — the single read on how institutional the flow is. The percentiles endpoint returns the trade-size percentiles (p50, p90, p99) and the average, median and largest trade. The symbols endpoint lists tradable pairs. This is the trade-size composition / participant-mix analytics cut for crypto — distinct from the order-flow / CVD API (which measures buy-versus-sell direction), the order-book depth, the slippage and the price APIs in the catalogue. Pairs are Binance symbols (BTCUSDT) or a coin=BTC&quote=USDT form.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/tradesize-api","description":"oanor gateway"}],"tags":[{"name":"Trade Size"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/distribution":{"get":{"operationId":"get_v1_distribution","tags":["Trade Size"],"summary":"Trade volume by size cohort + whale share","description":"","parameters":[{"name":"symbol","in":"query","required":true,"description":"Binance pair","schema":{"type":"string"},"example":"BTCUSDT"},{"name":"trades","in":"query","required":false,"description":"Recent trades to scan (200-5000, default 2000)","schema":{"type":"string"},"example":"3000"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/percentiles":{"get":{"operationId":"get_v1_percentiles","tags":["Trade Size"],"summary":"Trade-size percentiles & averages","description":"","parameters":[{"name":"symbol","in":"query","required":true,"description":"Binance pair","schema":{"type":"string"},"example":"BTCUSDT"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"trade-size percentiles over the recent tape: pN is the size below which N% of trades fall (quote = USD notional, base = coin amount).","source":"Binance","symbol":"BTCUSDT","trades_scanned":2000,"avg_trade_quote":2427.69,"base_percentiles":{"p25":0.00016,"p50":0.00045,"p75":0.003072,"p90":0.020519,"p99":1},"quote_percentiles":{"p25":10.13,"p50":28.5,"p75":194.55,"p90":1299.82,"p99":63352.45},"median_trade_quote":28.5,"largest_trade_quote":189038.6},"meta":{"timestamp":"2026-06-12T01:41:08.726Z","request_id":"2fbfaa9d-e9c7-47da-8135-a87006e37754"},"status":"ok","message":"Percentiles retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/symbols":{"get":{"operationId":"get_v1_symbols","tags":["Trade Size"],"summary":"Tradable Binance pairs","description":"","parameters":[{"name":"quote","in":"query","required":false,"description":"Filter by quote asset","schema":{"type":"string"},"example":"USDT"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":435,"quote":"USDT","source":"Binance","symbols":["0GUSDT","1000CATUSDT","1000CHEEMSUSDT","1000SATSUSDT","1INCHUSDT","1MBABYDOGEUSDT","2ZUSDT","AAVEUSDT","ACEUSDT","ACHUSDT","ACMUSDT","ACTUSDT","ACXUSDT","ADAUSDT","ADXUSDT","AEURUSDT","AEVOUSDT","AGLDUSDT","AIGENSYNUSDT","AIUSDT","AIXBTUSDT","ALCXUSDT","ALGOUSDT","ALICEUSDT","ALLOUSDT","ALPINEUSDT","ALTUSDT","AMPUSDT","ANIMEUSDT","ANKRUSDT","APEUSDT","API3USDT","APTUSDT","ARBUSDT","ARDRUSDT","ARKMUSDT","ARKUSDT","ARPAUSDT","ARUSDT","ASRUSDT","ASTERUSDT","ASTRUSDT","ATMUSDT","ATOMUSDT","ATUSDT","AUCTIONUSDT","AUDIOUSDT","AUSDT","AVAUSDT","AVAXUSDT","AVNTUSDT","AWEUSDT","AXLUSDT","AXSUSDT","BABYUSDT","BANANAS31USDT","BANANAUSDT","BANDUSDT","BANKUSDT","BARDUSDT","BARUSDT","BATUSDT","BBUSDT","BCHUSDT","BEAMXUSDT","BELUSDT","BERAUSDT","BFUSDUSDT","BICOUSDT","BIGTIMEUSDT","BIOUSDT","BLURUSDT","BMTUSDT","BNBUSDT","BNSOLUSDT","BNTUSDT","BOMEUSDT","BONKUSDT","BREVUSDT","BROCCOLI714USDT","BTCUSDT","BTTCUSDT","C98USDT","CAKEUSDT","CATIUSDT","CELOUSDT","CELRUSDT","CETUSUSDT","CFGUSDT","CFXUSDT","CGPTUSDT","CHIPUSDT","CHRUSDT","CHZUSDT","CITYUSDT","CKBUSDT","COMPUSDT","COOKIEUSDT","COSUSDT","COTIUSDT","COWUSDT","CRCLBUSDT","CRVUSDT","CTKUSDT","CTSIUSDT","CUSDT","CVCUSDT","CVXUSDT","CYBERUSDT","DASHUSDT","DCRUSDT","DEXEUSDT","DGBUSDT","DIAUSDT","DODOUSDT","DOGEUSDT","DOGSUSDT","DOLOUSDT","DOTUSDT","DUSDT","DUSKUSDT","DYDXUSDT","DYMUSDT","EDENUSDT","EDUUSDT","EGLDUSDT","EIGENUSDT","ENAUSDT","ENJUSDT","ENSOUSDT","ENSUSDT","EPICUSDT","ERAUSDT","ESPUSDT","ETCUSDT","ETHFIUSDT","ETHUSDT","EULUSDT","EURIUSDT","EURUSDT","FDUSDUSDT","FETUSDT","FFUSDT","FIDAUSDT","FILUSDT","FLOKIUSDT","FLOWUSDT","FLUXUSDT","FOGOUSDT","FORMUSDT","FRAXUSDT","FTTUSDT","FUSDT","GALAUSDT","GASUSDT","GENIUSUSDT","GIGGLEUSDT","GLMRUSDT","GLMUSDT","GMTUSDT","GMXUSDT","GNOUSDT","GNSUSDT","GPSUSDT","GRTUSDT","GTCUSDT","GUNUSDT","GUSDT","HAEDALUSDT","HBARUSDT","HEIUSDT","HEMIUSDT","HFTUSDT","HIGHUSDT","HIVEUSDT","HMSTRUSDT","HOLOUSDT","HOMEUSDT","HOTUSDT","HUMAUSDT","HYPERUSDT","ICPUSDT","ICXUSDT","IDUSDT","ILVUSDT","IMXUSDT","INITUSDT","INJUSDT","IOSTUSDT","IOTAUSDT","IOTXUSDT","IOUSDT","IQUSDT","JASMYUSDT","JOEUSDT","JSTUSDT","JTOUSDT","JUPUSDT","JUVUSDT","KAIAUSDT","KAITOUSDT","KATUSDT","KAVAUSDT","KERNELUSDT","KGSTUSDT","KITEUSDT","KMNOUSDT","KNCUSDT","KSMUSDT","LAUSDT","LAYERUSDT","LAZIOUSDT","LDOUSDT","LINEAUSDT","LINKUSDT","LISTAUSDT","LPTUSDT","LQTYUSDT","LSKUSDT","LTCUSDT","LUMIAUSDT","LUNAUSDT","LUNCUSDT","MAGICUSDT","MANAUSDT","MANTAUSDT","MANTRAUSDT","MASKUSDT","MAVUSDT","MBLUSDT","MBOXUSDT","MEGAUSDT","MEMEUSDT","METISUSDT","METUSDT","MEUSDT","MINAUSDT","MIRAUSDT","MITOUSDT","MMTUSDT","MORPHOUSDT","MOVEUSDT","MOVRUSDT","MTLUSDT","MUBARAKUSDT","MUBUSDT","NEARUSDT","NEIROUSDT","NEOUSDT","NEWTUSDT","NEXOUSDT","NFPUSDT","NIGHTUSDT","NILUSDT","NMRUSDT","NOMUSDT","NOTUSDT","NVDABUSDT","NXPCUSDT","OGNUSDT","OGUSDT","ONDOUSDT","ONEUSDT","ONGUSDT","ONTUSDT","OPENUSDT","OPGUSDT","OPNUSDT","OPUSDT","ORCAUSDT","ORDIUSDT","OSMOUSDT","PARTIUSDT","PAXGUSDT","PENDLEUSDT","PENGUUSDT","PEOPLEUSDT","PEPEUSDT","PHAUSDT","PIVXUSDT","PIXELUSDT","PLUMEUSDT","PNUTUSDT","POLUSDT","POLYXUSDT","PONDUSDT","PORTALUSDT","PORTOUSDT","POWRUSDT","PROMUSDT","PROVEUSDT","PSGUSDT","PUMPUSDT","PUNDIXUSDT","PYRUSDT","PYTHUSDT","QIUSDT","QKCUSDT","QNTUSDT","QTUMUSDT","QUICKUSDT","RADUSDT","RAREUSDT","RAYUSDT","REDUSDT","RENDERUSDT","REQUSDT","RESOLVUSDT","REZUSDT","RIFUSDT","RLCUSDT","RLUSDUSDT","ROBOUSDT","RONINUSDT","ROSEUSDT","RPLUSDT","RSRUSDT","RUNEUSDT","RVNUSDT","SAGAUSDT","SAHARAUSDT","SANDUSDT","SANTOSUSDT","SAPIENUSDT","SCRTUSDT","SCRUSDT","SCUSDT","SEIUSDT","SENTUSDT","SFPUSDT","SHELLUSDT","SHIBUSDT","SIGNUSDT","SKLUSDT","SKYUSDT","SLPUSDT","SNDKBUSDT","SNXUSDT","SOLUSDT","SOLVUSDT","SOMIUSDT","SOPHUSDT","SPELLUSDT","SPKUSDT","SSVUSDT","STEEMUSDT","STGUSDT","STORJUSDT","STOUSDT","STRAXUSDT","STRKUSDT","STXUSDT","SUIUSDT","SUNUSDT","SUPERUSDT","SUSDT","SUSHIUSDT","SXTUSDT","SYNUSDT","SYRUPUSDT","TAOUSDT","TFUELUSDT","THETAUSDT","THEUSDT","TIAUSDT","TKOUSDT","TLMUSDT","TNSRUSDT","TONUSDT","TOWNSUSDT","TRBUSDT","TREEUSDT","TRUMPUSDT","TRXUSDT","TSLABUSDT","TSTUSDT","TURBOUSDT","TURTLEUSDT","TUSDT","TUSDUSDT","TUTUSDT","TWTUSDT","UMAUSDT","UNIUSDT","USD1USDT","USDCUSDT","USDEUSDT","USDPUSDT","USDSUSDT","USTCUSDT","USUALUSDT","UUSDT","VANAUSDT","VANRYUSDT","VELODROMEUSDT","VETUSDT","VICUSDT","VIRTUALUSDT","VTHOUSDT","WALUSDT","WAXPUSDT","WBETHUSDT","WBTCUSDT","WCTUSDT","WIFUSDT","WINUSDT","WLDUSDT","WLFIUSDT","WOOUSDT","WUSDT","XAIUSDT","XAUTUSDT","XECUSDT","XLMUSDT","XNOUSDT","XPLUSDT","XRPUSDT","XTZUSDT","XUSDUSDT","XVGUSDT","XVSUSDT","YBUSDT","YFIUSDT","YGGUSDT","ZAMAUSDT","ZBTUSDT","ZECUSDT","ZENUSDT","ZILUSDT","ZKCUSDT","ZKPUSDT","ZKUSDT","ZROUSDT","ZRXUSDT","币安人生USDT"]},"meta":{"timestamp":"2026-06-12T01:41:08.826Z","request_id":"e877830d-c25b-40a0-aaad-eb102bdc1b1f"},"status":"ok","message":"Symbols retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":400,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1166,"monthly_call_quota":11800,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3588,"monthly_call_quota":66000,"rps_limit":18,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":8140,"monthly_call_quota":350000,"rps_limit":45,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/tradesize-api"}