{"openapi":"3.1.0","info":{"title":"Relative Volume (RVOL) API","version":"1.0.0","description":"Which markets are trading on abnormal volume right now — the first scan a day-trader runs to find what is \"in play\" — computed live from Yahoo Finance daily volume, no key, nothing stored. Price tells you where a market is; volume tells you whether anyone cares. A stock drifting on half its normal volume is noise; the same stock on three times its average is a market reacting to something — earnings, news, a breakout — and that is where the opportunity and the risk live. Relative volume (RVOL) is today's volume divided by its recent average: 1.0 is a normal day, 2.0 is double, and anything above signals unusual participation. For each instrument this API returns today's volume, its 20- and 50-day average volume, the RVOL against each, where today's volume sits as a percentile of the window, the dollar (notional) volume for liquidity, and whether volume is trending up or down. The asset endpoint returns one instrument's full volume profile; the screener endpoint ranks the universe by RVOL, putting the names trading on the most unusual volume — the ones in play — at the top. This is the relative-volume / unusual-activity cut — distinct from the bring-your-own-series volume-indicator tools (OBV, MFI), the crypto volume-by-price profile, the order-flow tape and the price APIs. It is the volume that is out of the ordinary.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/rvol-api","description":"oanor gateway"}],"tags":[{"name":"Screener"},{"name":"Asset"},{"name":"Universe"},{"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/screener":{"get":{"operationId":"get_v1_screener","tags":["Screener"],"summary":"Rank the universe by RVOL, volume percentile or dollar volume","description":"","parameters":[{"name":"metric","in":"query","required":false,"description":"rvol, volume_percentile or dollar_volume","schema":{"type":"string"},"example":"rvol"},{"name":"window","in":"query","required":false,"description":"Lookback in trading days (60-500)","schema":{"type":"string"},"example":"90"},{"name":"class","in":"query","required":false,"description":"index, sector, commodity, bond, stock, crypto or all","schema":{"type":"string"},"example":"all"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Ranked by rvol over window_days of daily volume. RVOL is today's volume divided by the prior 20- (or 50-) day average: 1.0 normal, 2.0 double, 3.0+ extreme. volume_percentile places today's volume in the window. dollar_volume is volume x close. Read fresh per call, nothing cached.","class":"all","count":22,"metric":"rvol","source":"Yahoo Finance","results":[{"name":"Gold ETF","rank":1,"read":"elevated volume","class":"commodity","symbol":"GLD","rvol_20":1.87,"rvol_50":1.77,"available":true,"volume_trend":"falling","dollar_volume":4852372452,"volume_percentile":73.3},{"name":"Crude Oil ETF","rank":2,"read":"elevated volume","class":"commodity","symbol":"USO","rvol_20":1.7,"rvol_50":0.74,"available":true,"volume_trend":"falling","dollar_volume":1557528956,"volume_percentile":48.9},{"name":"S&P 500 ETF","rank":3,"read":"elevated volume","class":"index","symbol":"SPY","rvol_20":1.67,"rvol_50":1.56,"available":true,"volume_trend":"falling","dollar_volume":63577723034,"volume_percentile":67.8},{"name":"High-Yield Credit ETF","rank":4,"read":"elevated volume","class":"bond","symbol":"HYG","rvol_20":1.61,"rvol_50":1.37,"available":true,"volume_trend":"falling","dollar_volume":4403151292,"volume_percentile":70},{"name":"Nasdaq 100 ETF","rank":5,"read":"elevated volume","class":"index","symbol":"QQQ","rvol_20":1.56,"rvol_50":1.59,"available":true,"volume_trend":"flat","dollar_volume":51253354883,"volume_percentile":75.6},{"name":"Russell 2000 ETF","rank":6,"read":"normal volume","class":"index","symbol":"IWM","rvol_20":1.48,"rvol_50":1.44,"available":true,"volume_trend":"flat","dollar_volume":12024484284,"volume_percentile":63.3},{"name":"Silver ETF","rank":7,"read":"normal volume","class":"commodity","symbol":"SLV","rvol_20":1.36,"rvol_50":1.26,"available":true,"volume_trend":"falling","dollar_volume":1856323703,"volume_percentile":43.3},{"name":"20Y+ Treasuries ETF","rank":8,"read":"normal volume","class":"bond","symbol":"TLT","rvol_20":1.31,"rvol_50":1.46,"available":true,"volume_trend":"rising","dollar_volume":3022996732,"volume_percentile":63.3},{"name":"Microsoft","rank":9,"read":"normal volume","class":"stock","symbol":"MSFT","rvol_20":1.29,"rvol_50":1.34,"available":true,"volume_trend":"flat","dollar_volume":18390478587,"volume_percentile":87.8},{"name":"Dow Jones ETF","rank":10,"read":"normal volume","class":"index","symbol":"DIA","rvol_20":1.23,"rvol_50":1.33,"available":true,"volume_trend":"rising","dollar_volume":3228068907,"volume_percentile":56.7},{"name":"Technology Sector","rank":11,"read":"normal volume","class":"sector","symbol":"XLK","rvol_20":1.21,"rvol_50":1.43,"available":true,"volume_trend":"rising","dollar_volume":3339936743,"volume_percentile":68.9},{"name":"Financials Sector","rank":12,"read":"normal volume","class":"sector","symbol":"XLF","rvol_20":1.12,"rvol_50":1.13,"available":true,"volume_trend":"flat","dollar_volume":2172116722,"volume_percentile":44.4},{"name":"Energy Sector","rank":13,"read":"normal volume","class":"sector","symbol":"XLE","rvol_20":1.08,"rvol_50":0.94,"available":true,"volume_trend":"falling","dollar_volume":2333249140,"volume_percentile":38.9},{"name":"Amazon","rank":14,"read":"normal volume","class":"stock","symbol":"AMZN","rvol_20":1.01,"rvol_50":0.92,"available":true,"volume_trend":"falling","dollar_volume":9962335575,"volume_percentile":37.8},{"name":"Meta Platforms","rank":15,"read":"normal volume","class":"stock","symbol":"META","rvol_20":1.01,"rvol_50":1.04,"available":true,"volume_trend":"flat","dollar_volume":9996921438,"volume_percentile":74.4},{"name":"Netflix","rank":16,"read":"normal volume","class":"stock","symbol":"NFLX","rvol_20":1.01,"rvol_50":0.88,"available":true,"volume_trend":"falling","dollar_volume":2709907403,"volume_percentile":35.6},{"name":"AMD","rank":17,"read":"normal volume","class":"stock","symbol":"AMD","rvol_20":0.96,"rvol_50":0.79,"available":true,"volume_trend":"falling","dollar_volume":14835545686,"volume_percentile":32.2},{"name":"Tesla","rank":18,"read":"normal volume","class":"stock","symbol":"TSLA","rvol_20":0.94,"rvol_50":0.77,"available":true,"volume_trend":"falling","dollar_volume":17970251620,"volume_percentile":8.9},{"name":"Nvidia","rank":19,"read":"normal volume","class":"stock","symbol":"NVDA","rvol_20":0.88,"rvol_50":0.97,"available":true,"volume_trend":"rising","dollar_volume":32343235869,"volume_percentile":32.2},{"name":"Apple","rank":20,"read":"normal volume","class":"stock","symbol":"AAPL","rvol_20":0.84,"rvol_50":0.89,"available":true,"volume_trend":"rising","dollar_volume":12571163387,"volume_percentile":47.8},{"name":"Bitcoin","rank":21,"read":"normal volume","class":"crypto","symbol":"BTC-USD","rvol_20":0.82,"rvol_50":0.89,"available":true,"volume_trend":"rising","dollar_volume":29920305152,"volume_percentile":33.3},{"name":"Ethereum","rank":22,"read":"quiet — below-average volume","class":"crypto","symbol":"ETH-USD","rvol_20":0.69,"rvol_50":0.73,"available":true,"volume_trend":"rising","dollar_volume":11807350784,"volume_percentile":18.9}],"unusual":[],"sorted_by":"rvol_20","most_active":{"symbol":"GLD","rvol_20":1.87},"unavailable":[],"window_days":90},"meta":{"timestamp":"2026-06-12T10:34:40.271Z","request_id":"c43aedcb-1521-48ce-93fe-a81c1f09895c"},"status":"ok","message":"RVOL screener 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/asset":{"get":{"operationId":"get_v1_asset","tags":["Asset"],"summary":"Full volume profile of one instrument","description":"","parameters":[{"name":"symbol","in":"query","required":true,"description":"Universe symbol","schema":{"type":"string"},"example":"NVDA"},{"name":"window","in":"query","required":false,"description":"Lookback in trading days (60-500)","schema":{"type":"string"},"example":"90"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"Nvidia","note":"RVOL = today's volume / prior 20-day average volume (rvol_50 uses the 50-day). volume_percentile is where today's volume ranks in the window. dollar_volume = today's volume x close (notional liquidity). Read fresh per call, nothing cached.","class":"stock","reads":{"rvol":"normal volume","trend":"20-day volume above 50-day — participation building"},"source":"Yahoo Finance","symbol":"NVDA","rvol_20":0.88,"rvol_50":0.97,"window_days":90,"observations":90,"today_volume":157872000,"volume_trend":"rising","avg_volume_20":179067235,"avg_volume_50":162349018,"dollar_volume":32343235869,"volume_percentile":32.2,"avg_dollar_volume_20":38870693608},"meta":{"timestamp":"2026-06-12T10:34:40.445Z","request_id":"e9ac8f65-2c49-4591-a876-7ea65cdc5d58"},"status":"ok","message":"Asset volume profile 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/universe":{"get":{"operationId":"get_v1_universe","tags":["Universe"],"summary":"The volume-bearing universe and its classes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The volume-bearing universe the screener ranks — ETFs, large-cap stocks and crypto (FX has no exchange volume). Pass class= to a screener call to rank within one class.","count":22,"assets":[{"name":"S&P 500 ETF","class":"index","symbol":"SPY"},{"name":"Nasdaq 100 ETF","class":"index","symbol":"QQQ"},{"name":"Russell 2000 ETF","class":"index","symbol":"IWM"},{"name":"Dow Jones ETF","class":"index","symbol":"DIA"},{"name":"Technology Sector","class":"sector","symbol":"XLK"},{"name":"Financials Sector","class":"sector","symbol":"XLF"},{"name":"Energy Sector","class":"sector","symbol":"XLE"},{"name":"Gold ETF","class":"commodity","symbol":"GLD"},{"name":"Silver ETF","class":"commodity","symbol":"SLV"},{"name":"Crude Oil ETF","class":"commodity","symbol":"USO"},{"name":"20Y+ Treasuries ETF","class":"bond","symbol":"TLT"},{"name":"High-Yield Credit ETF","class":"bond","symbol":"HYG"},{"name":"Apple","class":"stock","symbol":"AAPL"},{"name":"Microsoft","class":"stock","symbol":"MSFT"},{"name":"Nvidia","class":"stock","symbol":"NVDA"},{"name":"Tesla","class":"stock","symbol":"TSLA"},{"name":"Amazon","class":"stock","symbol":"AMZN"},{"name":"Meta Platforms","class":"stock","symbol":"META"},{"name":"AMD","class":"stock","symbol":"AMD"},{"name":"Netflix","class":"stock","symbol":"NFLX"},{"name":"Bitcoin","class":"crypto","symbol":"BTC-USD"},{"name":"Ethereum","class":"crypto","symbol":"ETH-USD"}],"source":"Yahoo Finance","classes":["index","sector","commodity","bond","stock","crypto"]},"meta":{"timestamp":"2026-06-12T10:34:40.557Z","request_id":"2ad5af98-2678-49a5-a6e0-8a347915f90e"},"status":"ok","message":"Universe 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":"metric is rvol (default), volume_percentile or dollar_volume. window is 60-500 trading days (default 90). class filters to index/sector/commodity/bond/stock/crypto (default all). RVOL = today's volume / prior 20-day average. FX is excluded (no exchange volume). Read fresh per call, nothing cached.","source":"Yahoo Finance daily volume, live","classes":["index","sector","commodity","bond","stock","crypto"],"metrics":["rvol","volume_percentile","dollar_volume"],"service":"rvol-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/asset":"Full volume profile of one instrument (symbol=NVDA, window=90).","GET /v1/screener":"Rank the universe by RVOL, volume percentile or dollar volume (metric=rvol, window=90, class=all).","GET /v1/universe":"The volume-bearing universe and its classes."},"description":"Relative volume (RVOL) & unusual activity — which markets are trading on abnormal volume right now, live from Yahoo Finance daily volume (no key, nothing stored). RVOL is today's volume over its recent average: 1.0 normal, 2.0 double, 3.0+ extreme. For each instrument it returns today's volume, the 20/50-day average, the RVOL against each, the volume percentile, the dollar volume and whether volume is rising or falling. asset returns one instrument's volume profile; screener ranks the universe by RVOL, surfacing the names in play. The relative-volume / unusual-activity cut — distinct from the BYO volume-indicator tools (OBV, MFI), the crypto volume-by-price profile, the order-flow tape and the price APIs.","universe_size":22,"upstream_status":"ok","most_active_symbol":"GLD"},"meta":{"timestamp":"2026-06-12T10:34:40.721Z","request_id":"fb103890-5ce1-456d-9259-bd1811cedc36"},"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":695,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1150,"monthly_call_quota":15800,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3480,"monthly_call_quota":84500,"rps_limit":16,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":7760,"monthly_call_quota":482000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/rvol-api"}