{"openapi":"3.1.0","info":{"title":"Crypto Slippage & Market Impact API","version":"1.0.0","description":"What a crypto trade actually costs once it eats into the order book — computed live from Binance's full depth feed (up to 5000 levels per side), no key, nothing stored. Top-of-book price is a fiction for anything but the smallest order: a real market order walks down the book, filling progressively worse levels, and the gap between the quoted price and the realised average fill is slippage. The estimate endpoint takes a pair, a side (buy or sell) and a size — in quote currency (notional, e.g. $250,000) or in base coin (quantity) — walks the live book level by level and returns the average fill price, the slippage versus the mid and versus top-of-book, the price impact (how far the last filled level sits from mid), the number of levels consumed and whether the book even holds enough liquidity to fill. The depth endpoint returns a liquidity profile: top bid/ask, mid, spread and the cumulative bid- and ask-side liquidity sitting within ±0.1%, ±0.25%, ±0.5%, ±1% and ±2% of mid, plus the book imbalance — a one-glance read on how deep and how lopsided a market is. The symbols endpoint lists tradable pairs. This is the execution-cost / market-impact analytics cut for crypto — distinct from the raw exchange order-book feed, from VWAP-on-candles, and from the price, ticker and quote 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/slippage-api","description":"oanor gateway"}],"tags":[{"name":"Slippage"},{"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/depth":{"get":{"operationId":"get_v1_depth","tags":["Slippage"],"summary":"Order-book liquidity profile","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":"imbalance > 0 means more bid- than ask-side liquidity within the band (buy-side support); < 0 means heavier asks.","levels":{"asks":5000,"bids":5000},"source":"Binance","spread":0.01,"symbol":"BTCUSDT","best_ask":63354.7,"best_bid":63354.69,"mid_price":63354.695,"spread_pct":0,"liquidity_within":[{"ask_base":90.48484,"band_pct":0.1,"bid_base":67.58154,"ask_quote":5735591.07,"bid_quote":4279111.48,"imbalance":-0.1454},{"ask_base":182.15534,"band_pct":0.25,"bid_base":194.59198,"ask_quote":11552679.18,"bid_quote":12311029.17,"imbalance":0.0318},{"ask_base":216.47567,"band_pct":0.5,"bid_base":234.12193,"ask_quote":13734846.59,"bid_quote":14806181.55,"imbalance":0.0375},{"ask_base":253.67249,"band_pct":1,"bid_base":285.23814,"ask_quote":16109604.98,"bid_quote":18021851.88,"imbalance":0.056},{"ask_base":420.57054,"band_pct":2,"bid_base":325.91527,"ask_quote":26821603.77,"bid_quote":20564808.25,"imbalance":-0.132}]},"meta":{"timestamp":"2026-06-12T01:41:16.144Z","request_id":"25eac473-9b2e-4271-8826-514b0ba40e17"},"status":"ok","message":"Depth 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/estimate":{"get":{"operationId":"get_v1_estimate","tags":["Slippage"],"summary":"Slippage & market impact of a market order","description":"","parameters":[{"name":"symbol","in":"query","required":true,"description":"Binance pair","schema":{"type":"string"},"example":"BTCUSDT"},{"name":"side","in":"query","required":false,"description":"buy or sell (default buy)","schema":{"type":"string"},"example":"buy"},{"name":"notional","in":"query","required":false,"description":"Order size in quote currency","schema":{"type":"string"},"example":"250000"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"side":"buy","filled":true,"source":"Binance","symbol":"BTCUSDT","mid_price":63354.695,"requested":{"notional":250000},"top_price":63354.7,"base_filled":3.94601498,"worst_price":63361.22,"quote_filled":250000,"avg_fill_price":63355.05606105,"levels_consumed":43,"price_impact_pct":0.0103,"slippage_pct_vs_mid":0.0006,"slippage_pct_vs_top":0.0006},"meta":{"timestamp":"2026-06-12T01:41:16.511Z","request_id":"d39409ff-b861-4437-819c-dfcfd698bbf3"},"status":"ok","message":"Estimate 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":["Slippage"],"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:17.125Z","request_id":"819b01a7-45b8-4781-8955-059a0cc9acc3"},"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. estimate size is notional (quote currency, e.g. notional=250000) or quantity (base coin, e.g. quantity=5). slippage_pct is signed so positive = costlier than the reference. Depth is read fresh per call (no cache); only the tradable-symbol list is cached hourly.","source":"Binance public REST (api.binance.com/api/v3, live)","service":"slippage-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/depth":"Order-book liquidity profile within ±0.1/0.25/0.5/1/2% of mid, with imbalance (symbol=BTCUSDT).","GET /v1/symbols":"Tradable Binance pairs, optionally filtered by quote (quote=USDT).","GET /v1/estimate":"Average fill price, slippage and market impact for a market order (symbol=BTCUSDT, side=buy, notional=250000)."},"description":"What a crypto trade actually costs once it eats into the order book, computed live from Binance's full depth feed (up to 5000 levels), no key, nothing stored. estimate walks the live book for a pair/side/size (quote or base) and returns the average fill price, slippage vs mid and vs top-of-book, price impact, levels consumed and whether the book holds enough liquidity. depth returns a liquidity profile: top bid/ask, mid, spread and cumulative bid/ask liquidity within ±0.1/0.25/0.5/1/2% of mid plus the imbalance. symbols lists tradable pairs. The execution-cost / market-impact analytics cut — distinct from the raw order-book feed, VWAP-on-candles and price/ticker APIs.","trading_symbols":1370,"upstream_status":"ok"},"meta":{"timestamp":"2026-06-12T01:41:17.196Z","request_id":"5df5fa86-7502-4a49-ba9a-ed208e973b17"},"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":300,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1287,"monthly_call_quota":12000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3812,"monthly_call_quota":75000,"rps_limit":18,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":8640,"monthly_call_quota":400000,"rps_limit":45,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/slippage-api"}