{"openapi":"3.1.0","info":{"title":"Crypto Smart-Money vs Retail Positioning API","version":"1.0.0","description":"How crypto's biggest, most-capitalised futures traders are positioned versus the retail crowd — and the divergence between them — computed live from Binance's public futures positioning feed (no key, nothing stored). Binance splits its perpetual traders into the whole crowd and the \"top traders\" (the top ~20% of accounts by margin balance, a smart-money proxy) and publishes the long/short split of each. When smart money leans one way while the crowd leans the other, that gap is a classic contrarian signal: an over-long retail crowd the big accounts are quietly fading often marks a local top, and vice versa. The positioning endpoint returns, for a coin, the long/short ratio and long-share of three cohorts side by side — the global crowd, the top traders by account, and the top traders by position size. The divergence endpoint returns the smart-money-minus-retail gap with a plain-language read. The history endpoint returns the time-series across 5m to 1d buckets so you can watch the gap open and close. The smart-money-versus-retail / positioning-divergence cut for crypto — distinct from the single-cohort long/short-ratio feed, the funding-rate, open-interest and price APIs. It tells you who is on which side, not just how many are long.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/smartmoney-api","description":"oanor gateway"}],"tags":[{"name":"Positioning"},{"name":"Divergence"},{"name":"History"},{"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/positioning":{"get":{"operationId":"get_v1_positioning","tags":["Positioning"],"summary":"Three positioning cohorts side by side with the divergence","description":"","parameters":[{"name":"coin","in":"query","required":false,"description":"Base coin (quote defaults to USDT)","schema":{"type":"string"},"example":"BTC"},{"name":"symbol","in":"query","required":false,"description":"Full USDT-perp symbol","schema":{"type":"string"},"example":"BTCUSDT"},{"name":"period","in":"query","required":false,"description":"Bucket: 5m,15m,30m,1h,2h,4h,6h,12h,1d","schema":{"type":"string"},"example":"5m"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Three positioning cohorts from Binance futures, latest reading. retail_crowd is every account; top_traders_* are the top ~20% of accounts by margin balance (smart-money proxy), by account count and by position size. long_account_pct is the share positioned long. The divergence between top_traders_by_position and retail_crowd is the contrarian signal.","period":"5m","source":"Binance USDS-M futures","symbol":"BTCUSDT","cohorts":[{"label":"Global crowd (by accounts)","cohort":"retail_crowd","timestamp":1781260200000,"is_smart_money":false,"long_account_pct":60.2,"long_short_ratio":1.5126,"short_account_pct":39.8},{"label":"Top traders (by accounts)","cohort":"top_traders_by_accounts","timestamp":1781260200000,"is_smart_money":true,"long_account_pct":62.15,"long_short_ratio":1.642,"short_account_pct":37.85},{"label":"Top traders (by position size)","cohort":"top_traders_by_position","timestamp":1781260200000,"is_smart_money":true,"long_account_pct":54.79,"long_short_ratio":1.2117,"short_account_pct":45.21}],"divergence":{"read":"Smart money and the crowd are positioned similarly — no strong divergence signal.","signal":"aligned","ratio_gap":-0.3009,"long_pct_gap":-5.41,"retail_long_pct":60.2,"smart_money_long_pct":54.79}},"meta":{"timestamp":"2026-06-12T10:35:27.228Z","request_id":"be267660-c0d2-4ba4-ad98-c002cfcc1b57"},"status":"ok","message":"Positioning 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/divergence":{"get":{"operationId":"get_v1_divergence","tags":["Divergence"],"summary":"Smart-money-minus-retail long-share gap with a contrarian read","description":"","parameters":[{"name":"coin","in":"query","required":false,"description":"Base coin","schema":{"type":"string"},"example":"ETH"},{"name":"period","in":"query","required":false,"description":"Bucket","schema":{"type":"string"},"example":"1h"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"long_pct_gap = top-trader long-share minus crowd long-share (positive = smart money more long than the crowd). A large positive gap is a bullish tilt; a large negative gap (crowd over-long) is a contrarian bearish tilt. Threshold +/-8 percentage points. Not financial advice.","read":"The crowd is notably more long than the top traders — a contrarian bearish tilt (retail euphoria the big accounts are fading).","period":"1h","signal":"crowd_over_long","source":"Binance USDS-M futures","symbol":"ETHUSDT","ratio_gap":-0.6704,"long_pct_gap":-10.21,"retail_long_pct":65.75,"smart_money_long_pct":55.54},"meta":{"timestamp":"2026-06-12T10:35:27.594Z","request_id":"668c2ac8-7574-40b3-bf19-a1f896be3ed2"},"status":"ok","message":"Divergence 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/history":{"get":{"operationId":"get_v1_history","tags":["History"],"summary":"Time-series of all three cohorts and the gap","description":"","parameters":[{"name":"coin","in":"query","required":false,"description":"Base coin","schema":{"type":"string"},"example":"BTC"},{"name":"period","in":"query","required":false,"description":"Bucket","schema":{"type":"string"},"example":"1h"},{"name":"limit","in":"query","required":false,"description":"Points 1-500","schema":{"type":"string"},"example":"48"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Time-series of all three positioning cohorts and the smart-money-minus-retail long-share gap, oldest to newest. Watch long_pct_gap open and close to see smart money and the crowd diverge and re-converge.","count":48,"period":"1h","points":[{"timestamp":1781089200000,"long_pct_gap":-14.09,"retail_crowd_long_pct":67.98,"retail_crowd_ls_ratio":2.123,"top_traders_by_accounts_long_pct":68.86,"top_traders_by_accounts_ls_ratio":2.2113,"top_traders_by_position_long_pct":53.89,"top_traders_by_position_ls_ratio":1.1686},{"timestamp":1781092800000,"long_pct_gap":-14.13,"retail_crowd_long_pct":68.14,"retail_crowd_ls_ratio":2.1387,"top_traders_by_accounts_long_pct":69.08,"top_traders_by_accounts_ls_ratio":2.2342,"top_traders_by_position_long_pct":54.01,"top_traders_by_position_ls_ratio":1.1742},{"timestamp":1781096400000,"long_pct_gap":-14.29,"retail_crowd_long_pct":67.72,"retail_crowd_ls_ratio":2.0979,"top_traders_by_accounts_long_pct":68.59,"top_traders_by_accounts_ls_ratio":2.1837,"top_traders_by_position_long_pct":53.43,"top_traders_by_position_ls_ratio":1.1473},{"timestamp":1781100000000,"long_pct_gap":-13.77,"retail_crowd_long_pct":67.02,"retail_crowd_ls_ratio":2.0321,"top_traders_by_accounts_long_pct":67.76,"top_traders_by_accounts_ls_ratio":2.1017,"top_traders_by_position_long_pct":53.25,"top_traders_by_position_ls_ratio":1.1391},{"timestamp":1781103600000,"long_pct_gap":-13.65,"retail_crowd_long_pct":66.85,"retail_crowd_ls_ratio":2.0166,"top_traders_by_accounts_long_pct":67.66,"top_traders_by_accounts_ls_ratio":2.0921,"top_traders_by_position_long_pct":53.2,"top_traders_by_position_ls_ratio":1.1368},{"timestamp":1781107200000,"long_pct_gap":-13.33,"retail_crowd_long_pct":66.46,"retail_crowd_ls_ratio":1.9815,"top_traders_by_accounts_long_pct":67.18,"top_traders_by_accounts_ls_ratio":2.0469,"top_traders_by_position_long_pct":53.13,"top_traders_by_position_ls_ratio":1.1335},{"timestamp":1781110800000,"long_pct_gap":-13.69,"retail_crowd_long_pct":66.9,"retail_crowd_ls_ratio":2.0211,"top_traders_by_accounts_long_pct":67.68,"top_traders_by_accounts_ls_ratio":2.0941,"top_traders_by_position_long_pct":53.21,"top_traders_by_position_ls_ratio":1.1372},{"timestamp":1781114400000,"long_pct_gap":-14.44,"retail_crowd_long_pct":67.2,"retail_crowd_ls_ratio":2.0488,"top_traders_by_accounts_long_pct":68,"top_traders_by_accounts_ls_ratio":2.125,"top_traders_by_position_long_pct":52.76,"top_traders_by_position_ls_ratio":1.117},{"timestamp":1781118000000,"long_pct_gap":-14.51,"retail_crowd_long_pct":67.22,"retail_crowd_ls_ratio":2.0506,"top_traders_by_accounts_long_pct":68.05,"top_traders_by_accounts_ls_ratio":2.1299,"top_traders_by_position_long_pct":52.71,"top_traders_by_position_ls_ratio":1.1147},{"timestamp":1781121600000,"long_pct_gap":-14.51,"retail_crowd_long_pct":67.19,"retail_crowd_ls_ratio":2.0479,"top_traders_by_accounts_long_pct":68.01,"top_traders_by_accounts_ls_ratio":2.126,"top_traders_by_position_long_pct":52.68,"top_traders_by_position_ls_ratio":1.1134},{"timestamp":1781125200000,"long_pct_gap":-14.51,"retail_crowd_long_pct":67.24,"retail_crowd_ls_ratio":2.0525,"top_traders_by_accounts_long_pct":68.06,"top_traders_by_accounts_ls_ratio":2.1309,"top_traders_by_position_long_pct":52.73,"top_traders_by_position_ls_ratio":1.1156},{"timestamp":1781128800000,"long_pct_gap":-14.48,"retail_crowd_long_pct":67.28,"retail_crowd_ls_ratio":2.0562,"top_traders_by_accounts_long_pct":68.16,"top_traders_by_accounts_ls_ratio":2.1407,"top_traders_by_position_long_pct":52.8,"top_traders_by_position_ls_ratio":1.1187},{"timestamp":1781132400000,"long_pct_gap":-14.78,"retail_crowd_long_pct":67.58,"retail_crowd_ls_ratio":2.0845,"top_traders_by_accounts_long_pct":68.43,"top_traders_by_accounts_ls_ratio":2.1676,"top_traders_by_position_long_pct":52.8,"top_traders_by_position_ls_ratio":1.1186},{"timestamp":1781136000000,"long_pct_gap":-15,"retail_crowd_long_pct":67.82,"retail_crowd_ls_ratio":2.1075,"top_traders_by_accounts_long_pct":68.64,"top_traders_by_accounts_ls_ratio":2.1888,"top_traders_by_position_long_pct":52.82,"top_traders_by_position_ls_ratio":1.1195},{"timestamp":1781139600000,"long_pct_gap":-15.08,"retail_crowd_long_pct":67.76,"retail_crowd_ls_ratio":2.1017,"top_traders_by_accounts_long_pct":68.48,"top_traders_by_accounts_ls_ratio":2.1726,"top_traders_by_position_long_pct":52.68,"top_traders_by_position_ls_ratio":1.1132},{"timestamp":1781143200000,"long_pct_gap":-14.53,"retail_crowd_long_pct":67.12,"retail_crowd_ls_ratio":2.0414,"top_traders_by_accounts_long_pct":67.87,"top_traders_by_accounts_ls_ratio":2.1124,"top_traders_by_position_long_pct":52.59,"top_traders_by_position_ls_ratio":1.1095},{"timestamp":1781146800000,"long_pct_gap":-13.9,"retail_crowd_long_pct":66.47,"retail_crowd_ls_ratio":1.9824,"top_traders_by_accounts_long_pct":66.82,"top_traders_by_accounts_ls_ratio":2.0139,"top_traders_by_position_long_pct":52.57,"top_traders_by_position_ls_ratio":1.1083},{"timestamp":1781150400000,"long_pct_gap":-12.83,"retail_crowd_long_pct":65.82,"retail_crowd_ls_ratio":1.9257,"top_traders_by_accounts_long_pct":66.12,"top_traders_by_accounts_ls_ratio":1.9516,"top_traders_by_position_long_pct":52.99,"top_traders_by_position_ls_ratio":1.127},{"timestamp":1781154000000,"long_pct_gap":-12.23,"retail_crowd_long_pct":65.07,"retail_crowd_ls_ratio":1.8629,"top_traders_by_accounts_long_pct":65.49,"top_traders_by_accounts_ls_ratio":1.8977,"top_traders_by_position_long_pct":52.84,"top_traders_by_position_ls_ratio":1.1204},{"timestamp":1781157600000,"long_pct_gap":-11.77,"retail_crowd_long_pct":64.5,"retail_crowd_ls_ratio":1.8169,"top_traders_by_accounts_long_pct":65.04,"top_traders_by_accounts_ls_ratio":1.8604,"top_traders_by_position_long_pct":52.73,"top_traders_by_position_ls_ratio":1.1156},{"timestamp":1781161200000,"long_pct_gap":-11.07,"retail_crowd_long_pct":64.09,"retail_crowd_ls_ratio":1.7847,"top_traders_by_accounts_long_pct":64.6,"top_traders_by_accounts_ls_ratio":1.8249,"top_traders_by_position_long_pct":53.02,"top_traders_by_position_ls_ratio":1.1284},{"timestamp":1781164800000,"long_pct_gap":-10.81,"retail_crowd_long_pct":63.85,"retail_crowd_ls_ratio":1.7663,"top_traders_by_accounts_long_pct":64.47,"top_traders_by_accounts_ls_ratio":1.8145,"top_traders_by_position_long_pct":53.04,"top_traders_by_position_ls_ratio":1.1293},{"timestamp":1781168400000,"long_pct_gap":-10.12,"retail_crowd_long_pct":63.7,"retail_crowd_ls_ratio":1.7548,"top_traders_by_accounts_long_pct":64.22,"top_traders_by_accounts_ls_ratio":1.7949,"top_traders_by_position_long_pct":53.58,"top_traders_by_position_ls_ratio":1.1541},{"timestamp":1781172000000,"long_pct_gap":-9.58,"retail_crowd_long_pct":63.22,"retail_crowd_ls_ratio":1.7189,"top_traders_by_accounts_long_pct":63.83,"top_traders_by_accounts_ls_ratio":1.7647,"top_traders_by_position_long_pct":53.64,"top_traders_by_position_ls_ratio":1.1573},{"timestamp":1781175600000,"long_pct_gap":-9.08,"retail_crowd_long_pct":63.18,"retail_crowd_ls_ratio":1.7159,"top_traders_by_accounts_long_pct":63.78,"top_traders_by_accounts_ls_ratio":1.7609,"top_traders_by_position_long_pct":54.1,"top_traders_by_position_ls_ratio":1.1786},{"timestamp":1781179200000,"long_pct_gap":-9.35,"retail_crowd_long_pct":63.1,"retail_crowd_ls_ratio":1.71,"top_traders_by_accounts_long_pct":63.71,"top_traders_by_accounts_ls_ratio":1.7556,"top_traders_by_position_long_pct":53.75,"top_traders_by_position_ls_ratio":1.1624},{"timestamp":1781182800000,"long_pct_gap":-7.34,"retail_crowd_long_pct":61.91,"retail_crowd_ls_ratio":1.6254,"top_traders_by_accounts_long_pct":62.77,"top_traders_by_accounts_ls_ratio":1.686,"top_traders_by_position_long_pct":54.57,"top_traders_by_position_ls_ratio":1.2013},{"timestamp":1781186400000,"long_pct_gap":-7.63,"retail_crowd_long_pct":61.55,"retail_crowd_ls_ratio":1.6008,"top_traders_by_accounts_long_pct":62.39,"top_traders_by_accounts_ls_ratio":1.6589,"top_traders_by_position_long_pct":53.92,"top_traders_by_position_ls_ratio":1.1702},{"timestamp":1781190000000,"long_pct_gap":-7.21,"retail_crowd_long_pct":61.34,"retail_crowd_ls_ratio":1.5867,"top_traders_by_accounts_long_pct":62.35,"top_traders_by_accounts_ls_ratio":1.656,"top_traders_by_position_long_pct":54.13,"top_traders_by_position_ls_ratio":1.1802},{"timestamp":1781193600000,"long_pct_gap":-7.6,"retail_crowd_long_pct":61.78,"retail_crowd_ls_ratio":1.6164,"top_traders_by_accounts_long_pct":62.78,"top_traders_by_accounts_ls_ratio":1.6867,"top_traders_by_position_long_pct":54.18,"top_traders_by_position_ls_ratio":1.1824},{"timestamp":1781197200000,"long_pct_gap":-7.81,"retail_crowd_long_pct":61.92,"retail_crowd_ls_ratio":1.6261,"top_traders_by_accounts_long_pct":62.93,"top_traders_by_accounts_ls_ratio":1.6976,"top_traders_by_position_long_pct":54.11,"top_traders_by_position_ls_ratio":1.179},{"timestamp":1781200800000,"long_pct_gap":-8.72,"retail_crowd_long_pct":62.43,"retail_crowd_ls_ratio":1.6617,"top_traders_by_accounts_long_pct":63.06,"top_traders_by_accounts_ls_ratio":1.7071,"top_traders_by_position_long_pct":53.71,"top_traders_by_position_ls_ratio":1.1601},{"timestamp":1781204400000,"long_pct_gap":-8.2,"retail_crowd_long_pct":61.85,"retail_crowd_ls_ratio":1.6212,"top_traders_by_accounts_long_pct":62.65,"top_traders_by_accounts_ls_ratio":1.6774,"top_traders_by_position_long_pct":53.65,"top_traders_by_position_ls_ratio":1.1575},{"timestamp":1781208000000,"long_pct_gap":-8.04,"retail_crowd_long_pct":61.76,"retail_crowd_ls_ratio":1.6151,"top_traders_by_accounts_long_pct":62.46,"top_traders_by_accounts_ls_ratio":1.6638,"top_traders_by_position_long_pct":53.72,"top_traders_by_position_ls_ratio":1.161},{"timestamp":1781211600000,"long_pct_gap":-7.77,"retail_crowd_long_pct":61.63,"retail_crowd_ls_ratio":1.6062,"top_traders_by_accounts_long_pct":62.46,"top_traders_by_accounts_ls_ratio":1.6638,"top_traders_by_position_long_pct":53.86,"top_traders_by_position_ls_ratio":1.1672},{"timestamp":1781215200000,"long_pct_gap":-7.72,"retail_crowd_long_pct":61.55,"retail_crowd_ls_ratio":1.6008,"top_traders_by_accounts_long_pct":62.39,"top_traders_by_accounts_ls_ratio":1.6589,"top_traders_by_position_long_pct":53.83,"top_traders_by_position_ls_ratio":1.1659},{"timestamp":1781218800000,"long_pct_gap":-7.62,"retail_crowd_long_pct":61.44,"retail_crowd_ls_ratio":1.5934,"top_traders_by_accounts_long_pct":62.29,"top_traders_by_accounts_ls_ratio":1.6518,"top_traders_by_position_long_pct":53.82,"top_traders_by_position_ls_ratio":1.1654},{"timestamp":1781222400000,"long_pct_gap":-7.06,"retail_crowd_long_pct":61.34,"retail_crowd_ls_ratio":1.5867,"top_traders_by_accounts_long_pct":62.14,"top_traders_by_accounts_ls_ratio":1.6413,"top_traders_by_position_long_pct":54.28,"top_traders_by_position_ls_ratio":1.1872},{"timestamp":1781226000000,"long_pct_gap":-6.77,"retail_crowd_long_pct":61.31,"retail_crowd_ls_ratio":1.5846,"top_traders_by_accounts_long_pct":62.07,"top_traders_by_accounts_ls_ratio":1.6364,"top_traders_by_position_long_pct":54.54,"top_traders_by_position_ls_ratio":1.1997},{"timestamp":1781229600000,"long_pct_gap":-6.55,"retail_crowd_long_pct":61.12,"retail_crowd_ls_ratio":1.572,"top_traders_by_accounts_long_pct":62.01,"top_traders_by_accounts_ls_ratio":1.6323,"top_traders_by_position_long_pct":54.57,"top_traders_by_position_ls_ratio":1.2012},{"timestamp":1781233200000,"long_pct_gap":-6.15,"retail_crowd_long_pct":60.9,"retail_crowd_ls_ratio":1.5575,"top_traders_by_accounts_long_pct":62.74,"top_traders_by_accounts_ls_ratio":1.6838,"top_traders_by_position_long_pct":54.75,"top_traders_by_position_ls_ratio":1.2098},{"timestamp":1781236800000,"long_pct_gap":-6.21,"retail_crowd_long_pct":60.97,"retail_crowd_ls_ratio":1.5621,"top_traders_by_accounts_long_pct":62.82,"top_traders_by_accounts_ls_ratio":1.6896,"top_traders_by_position_long_pct":54.76,"top_traders_by_position_ls_ratio":1.2106},{"timestamp":1781240400000,"long_pct_gap":-5.35,"retail_crowd_long_pct":60.44,"retail_crowd_ls_ratio":1.5278,"top_traders_by_accounts_long_pct":62.3,"top_traders_by_accounts_ls_ratio":1.6525,"top_traders_by_position_long_pct":55.09,"top_traders_by_position_ls_ratio":1.2268},{"timestamp":1781244000000,"long_pct_gap":-6.44,"retail_crowd_long_pct":61.18,"retail_crowd_ls_ratio":1.576,"top_traders_by_accounts_long_pct":62.96,"top_traders_by_accounts_ls_ratio":1.6998,"top_traders_by_position_long_pct":54.74,"top_traders_by_position_ls_ratio":1.2095},{"timestamp":1781247600000,"long_pct_gap":-6.64,"retail_crowd_long_pct":61.57,"retail_crowd_ls_ratio":1.6021,"top_traders_by_accounts_long_pct":63.58,"top_traders_by_accounts_ls_ratio":1.7457,"top_traders_by_position_long_pct":54.93,"top_traders_by_position_ls_ratio":1.2187},{"timestamp":1781251200000,"long_pct_gap":-6.76,"retail_crowd_long_pct":61.78,"retail_crowd_ls_ratio":1.6164,"top_traders_by_accounts_long_pct":63.83,"top_traders_by_accounts_ls_ratio":1.7647,"top_traders_by_position_long_pct":55.02,"top_traders_by_position_ls_ratio":1.2234},{"timestamp":1781254800000,"long_pct_gap":-6.5,"retail_crowd_long_pct":61.5,"retail_crowd_ls_ratio":1.5974,"top_traders_by_accounts_long_pct":63.49,"top_traders_by_accounts_ls_ratio":1.739,"top_traders_by_position_long_pct":55,"top_traders_by_position_ls_ratio":1.2224},{"timestamp":1781258400000,"long_pct_gap":-5.79,"retail_crowd_long_pct":60.61,"retail_crowd_ls_ratio":1.5387,"top_traders_by_accounts_long_pct":62.51,"top_traders_by_accounts_ls_ratio":1.6674,"top_traders_by_position_long_pct":54.82,"top_traders_by_position_ls_ratio":1.2134}],"source":"Binance USDS-M futures","symbol":"BTCUSDT"},"meta":{"timestamp":"2026-06-12T10:35:27.944Z","request_id":"0c3159fb-e1ba-445a-8e75-fa5b07c68603"},"status":"ok","message":"History 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":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"symbol is a USDT perpetual (BTCUSDT) or a base (BTC, default quote USDT). period is 5m-1d (default 5m). history limit is 1-500 (default 48). Read fresh per call, nothing cached.","source":"Binance USDS-M futures data (globalLongShortAccountRatio, topLongShortAccountRatio, topLongShortPositionRatio), live","periods":["5m","15m","30m","1h","2h","4h","6h","12h","1d"],"service":"smartmoney-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/history":"Time-series of all three cohorts and the gap (symbol=BTCUSDT, period=1h, limit=48).","GET /v1/divergence":"Smart-money-minus-retail long-share gap with a contrarian read (symbol=BTCUSDT).","GET /v1/positioning":"Three positioning cohorts side by side with the divergence (symbol=BTCUSDT, period=5m)."},"description":"Crypto smart-money vs retail positioning — how Binance's top traders (top ~20% of accounts by margin) are positioned versus the retail crowd, and the divergence between them, live (no key, nothing stored). positioning returns the long/short ratio and long-share of three cohorts side by side. divergence returns the smart-money-minus-retail gap with a contrarian read. history returns the time-series. The positioning-divergence / smart-money-versus-retail cut — distinct from the single-cohort long/short-ratio feed, funding-rate, open-interest and price APIs. It tells you who is on which side.","upstream_status":"ok","btc_long_pct_gap":-5.41},"meta":{"timestamp":"2026-06-12T10:35:28.285Z","request_id":"7b06c4e0-bf9e-480a-9b1c-d196f8d093d5"},"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":750,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1188,"monthly_call_quota":20000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3588,"monthly_call_quota":95000,"rps_limit":18,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":8280,"monthly_call_quota":500000,"rps_limit":45,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/smartmoney-api"}