{"openapi":"3.1.0","info":{"title":"Hurst Exponent & Market Regime API","version":"1.0.0","description":"Tells you whether each market is trending, behaving like a random walk, or mean-reverting — the single most important thing to know before choosing a strategy — computed live from Yahoo Finance daily closes, no key, nothing stored. A trend-following system bleeds money in a mean-reverting market, and a fade-the-move system gets run over in a trending one; the Hurst exponent (via rescaled-range R/S analysis) measures which world you are in. A Hurst above ~0.55 means the series is persistent — moves tend to continue, so it trends and trend-following fits; near 0.5 it is a random walk with no edge either way; below ~0.45 it is anti-persistent — moves tend to reverse, so it mean-reverts and fading extremes fits. Alongside it the API returns the Kaufman Efficiency Ratio (net move divided by the total path travelled, 0 = pure noise, 1 = a perfectly straight trend), a second intuitive read on how cleanly a market is trending. The asset endpoint returns one instrument's Hurst, efficiency ratio and a regime label; the screener endpoint ranks the cross-asset universe (equities, sectors, commodities, bonds, FX and crypto; filterable by class) from most trending to most mean-reverting. This is the persistence / trend-versus-mean-reversion regime cut — distinct from the z-score stretch gauges (how far a price is from its average right now, not the structure of its moves), the multi-timeframe momentum-alignment API and the price APIs. It tells you which kind of strategy the market is paying for.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/hurst-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 from most trending to most mean-reverting","description":"","parameters":[{"name":"metric","in":"query","required":false,"description":"hurst or efficiency","schema":{"type":"string"},"example":"hurst"},{"name":"window","in":"query","required":false,"description":"Lookback in trading days (100-756)","schema":{"type":"string"},"example":"252"},{"name":"class","in":"query","required":false,"description":"equity, sector, commodity, bond, fx, crypto or all","schema":{"type":"string"},"example":"all"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Ranked by hurst descending (most trending / most efficient first) over window_days of daily closes. Hurst > 0.5 = persistent (trends, trend-following fits); ~0.5 = random walk; < 0.5 = anti-persistent (mean-reverts, fade extremes). Efficiency ratio 0 = pure noise, 1 = a straight trend. Read fresh per call, nothing cached.","class":"all","count":21,"metric":"hurst","source":"Yahoo Finance","results":[{"name":"Gold","rank":1,"class":"commodity","hurst":0.603,"regime":"strongly trending (persistent — trend-following fits)","symbol":"GLD","available":true,"observations":252,"efficiency_ratio":0.064},{"name":"Bitcoin","rank":2,"class":"crypto","hurst":0.599,"regime":"strongly trending (persistent — trend-following fits)","symbol":"BTC-USD","available":true,"observations":252,"efficiency_ratio":0.16},{"name":"Utilities","rank":3,"class":"sector","hurst":0.596,"regime":"strongly trending (persistent — trend-following fits)","symbol":"XLU","available":true,"observations":252,"efficiency_ratio":0.046},{"name":"Technology","rank":4,"class":"sector","hurst":0.586,"regime":"strongly trending (persistent — trend-following fits)","symbol":"XLK","available":true,"observations":252,"efficiency_ratio":0.156},{"name":"Health Care","rank":5,"class":"sector","hurst":0.576,"regime":"trending (mildly persistent)","symbol":"XLV","available":true,"observations":252,"efficiency_ratio":0.068},{"name":"Silver","rank":6,"class":"commodity","hurst":0.576,"regime":"trending (mildly persistent)","symbol":"SLV","available":true,"observations":252,"efficiency_ratio":0.068},{"name":"Ethereum","rank":7,"class":"crypto","hurst":0.567,"regime":"trending (mildly persistent)","symbol":"ETH-USD","available":true,"observations":252,"efficiency_ratio":0.166},{"name":"GBP/USD","rank":8,"class":"fx","hurst":0.554,"regime":"trending (mildly persistent)","symbol":"GBPUSD=X","available":true,"observations":252,"efficiency_ratio":0.012},{"name":"Nasdaq 100","rank":9,"class":"equity","hurst":0.553,"regime":"trending (mildly persistent)","symbol":"QQQ","available":true,"observations":252,"efficiency_ratio":0.145},{"name":"Financials","rank":10,"class":"sector","hurst":0.551,"regime":"trending (mildly persistent)","symbol":"XLF","available":true,"observations":252,"efficiency_ratio":0.017},{"name":"US Small Caps","rank":11,"class":"equity","hurst":0.534,"regime":"trending (mildly persistent)","symbol":"IWM","available":true,"observations":252,"efficiency_ratio":0.124},{"name":"S&P 500","rank":12,"class":"equity","hurst":0.532,"regime":"trending (mildly persistent)","symbol":"SPY","available":true,"observations":252,"efficiency_ratio":0.138},{"name":"20Y+ Treasuries","rank":13,"class":"bond","hurst":0.53,"regime":"random walk (no persistence edge)","symbol":"TLT","available":true,"observations":252,"efficiency_ratio":0.001},{"name":"EUR/USD","rank":14,"class":"fx","hurst":0.527,"regime":"random walk (no persistence edge)","symbol":"EURUSD=X","available":true,"observations":252,"efficiency_ratio":0.002},{"name":"Crude Oil","rank":15,"class":"commodity","hurst":0.526,"regime":"random walk (no persistence edge)","symbol":"USO","available":true,"observations":252,"efficiency_ratio":0.108},{"name":"Broad Commodities","rank":16,"class":"commodity","hurst":0.526,"regime":"random walk (no persistence edge)","symbol":"DBC","available":true,"observations":252,"efficiency_ratio":0.119},{"name":"Emerging Markets","rank":17,"class":"equity","hurst":0.513,"regime":"random walk (no persistence edge)","symbol":"EEM","available":true,"observations":252,"efficiency_ratio":0.142},{"name":"Energy","rank":18,"class":"sector","hurst":0.508,"regime":"random walk (no persistence edge)","symbol":"XLE","available":true,"observations":252,"efficiency_ratio":0.107},{"name":"Developed ex-US","rank":19,"class":"equity","hurst":0.496,"regime":"random walk (no persistence edge)","symbol":"EFA","available":true,"observations":252,"efficiency_ratio":0.083},{"name":"USD/JPY","rank":20,"class":"fx","hurst":0.474,"regime":"random walk (no persistence edge)","symbol":"USDJPY=X","available":true,"observations":252,"efficiency_ratio":0.099},{"name":"High-Yield Credit","rank":21,"class":"bond","hurst":0.473,"regime":"random walk (no persistence edge)","symbol":"HYG","available":true,"observations":252,"efficiency_ratio":0.011}],"sorted_by":"hurst","unavailable":[],"window_days":252,"most_trending":{"hurst":0.603,"symbol":"GLD"},"most_mean_reverting":{"hurst":0.473,"symbol":"HYG"}},"meta":{"timestamp":"2026-06-12T10:34:47.737Z","request_id":"b8375972-3e3b-406b-9e75-5b11f18880df"},"status":"ok","message":"Hurst 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":"Hurst, efficiency ratio and regime for one instrument","description":"","parameters":[{"name":"symbol","in":"query","required":true,"description":"Universe symbol","schema":{"type":"string"},"example":"SPY"},{"name":"window","in":"query","required":false,"description":"Lookback in trading days (100-756)","schema":{"type":"string"},"example":"252"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"S&P 500","note":"Hurst exponent via rescaled-range (R/S) analysis on log returns over window_days; efficiency ratio = net change / total path travelled on the close series. Hurst > 0.5 trends, < 0.5 mean-reverts. Read fresh per call, nothing cached.","class":"equity","hurst":0.532,"reads":{"hurst":"trending — momentum/trend-following strategies have an edge","efficiency":"noisy, directionless"},"regime":"trending (mildly persistent)","source":"Yahoo Finance","symbol":"SPY","window_days":252,"observations":252,"efficiency_ratio":0.138},"meta":{"timestamp":"2026-06-12T10:34:47.870Z","request_id":"bb4595ae-bcbd-4861-9167-719c446c1018"},"status":"ok","message":"Asset Hurst 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 cross-asset universe and its classes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The cross-asset universe the screener ranks. Pass class= to a screener call to rank within one class.","count":21,"assets":[{"name":"S&P 500","class":"equity","symbol":"SPY"},{"name":"Nasdaq 100","class":"equity","symbol":"QQQ"},{"name":"US Small Caps","class":"equity","symbol":"IWM"},{"name":"Developed ex-US","class":"equity","symbol":"EFA"},{"name":"Emerging Markets","class":"equity","symbol":"EEM"},{"name":"Technology","class":"sector","symbol":"XLK"},{"name":"Financials","class":"sector","symbol":"XLF"},{"name":"Energy","class":"sector","symbol":"XLE"},{"name":"Health Care","class":"sector","symbol":"XLV"},{"name":"Utilities","class":"sector","symbol":"XLU"},{"name":"Gold","class":"commodity","symbol":"GLD"},{"name":"Silver","class":"commodity","symbol":"SLV"},{"name":"Crude Oil","class":"commodity","symbol":"USO"},{"name":"Broad Commodities","class":"commodity","symbol":"DBC"},{"name":"20Y+ Treasuries","class":"bond","symbol":"TLT"},{"name":"High-Yield Credit","class":"bond","symbol":"HYG"},{"name":"EUR/USD","class":"fx","symbol":"EURUSD=X"},{"name":"USD/JPY","class":"fx","symbol":"USDJPY=X"},{"name":"GBP/USD","class":"fx","symbol":"GBPUSD=X"},{"name":"Bitcoin","class":"crypto","symbol":"BTC-USD"},{"name":"Ethereum","class":"crypto","symbol":"ETH-USD"}],"source":"Yahoo Finance","classes":["equity","sector","commodity","bond","fx","crypto"]},"meta":{"timestamp":"2026-06-12T10:34:47.983Z","request_id":"8c8648cd-f13c-4f49-af15-7f2d44f6b984"},"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 hurst (default) or efficiency. window is 100-756 trading days (default 252; Hurst needs a long sample). class filters to equity/sector/commodity/bond/fx/crypto (default all). Read fresh per call, nothing cached.","source":"Yahoo Finance daily closes, live","classes":["equity","sector","commodity","bond","fx","crypto"],"metrics":["hurst","efficiency"],"service":"hurst-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/asset":"Hurst, efficiency ratio and regime for one instrument (symbol=SPY, window=252).","GET /v1/screener":"Rank the universe by Hurst or efficiency ratio, most trending first (metric=hurst, window=252, class=all).","GET /v1/universe":"The cross-asset universe and its classes."},"description":"Hurst exponent & market regime — tells you whether each market is trending, a random walk, or mean-reverting, live from Yahoo Finance daily closes (no key, nothing stored). The Hurst exponent (rescaled-range R/S analysis) above ~0.55 means persistent/trending (trend-following fits), near 0.5 a random walk, below ~0.45 anti-persistent/mean-reverting (fade extremes). The Kaufman efficiency ratio (net move / total path) is a second read on trend cleanliness. asset returns one instrument's Hurst, efficiency ratio and regime label; screener ranks the cross-asset universe from most trending to most mean-reverting. The persistence / trend-vs-mean-reversion regime cut — distinct from the z-score stretch gauges, the multi-timeframe momentum-alignment API and the price APIs.","universe_size":21,"upstream_status":"ok","most_trending_252d":"GLD"},"meta":{"timestamp":"2026-06-12T10:34:48.152Z","request_id":"31d6b572-f96e-40ab-a727-033e832abe5a"},"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":670,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1250,"monthly_call_quota":14100,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3860,"monthly_call_quota":79000,"rps_limit":16,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":8580,"monthly_call_quota":458000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/hurst-api"}