{"openapi":"3.1.0","info":{"title":"Cross-Asset Volatility & Risk-Adjusted Return API","version":"1.0.0","description":"The risk dashboard for the whole multi-asset book — how volatile each asset class is, how much it returned, and how much return it paid per unit of risk, computed live from Yahoo Finance (no key, nothing stored). Return without risk is meaningless; this puts them side by side. For every instrument — equities, bonds, gold, oil, commodities, FX and crypto — it measures the annualised realised volatility (the standard deviation of daily returns, the market's fear gauge), the trailing return, a Sharpe-style risk-adjusted return (return per unit of volatility) and the worst peak-to-trough drawdown over the window. The ranking endpoint returns the universe ranked by whichever you choose — volatility, Sharpe, return or drawdown — so you can see the calmest and wildest assets and who paid the best risk-adjusted return. The asset endpoint returns one instrument's full risk profile. The universe endpoint lists what is covered. The cross-asset volatility / risk-adjusted-return ranking cut — distinct from the crypto-only volatility and risk APIs, the FX-only volatility API and the bring-your-own-series risk-metrics, CAPM and portfolio-optimiser calculators. It ranks live risk across asset classes.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/assetvolatility-api","description":"oanor gateway"}],"tags":[{"name":"Ranking"},{"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/ranking":{"get":{"operationId":"get_v1_ranking","tags":["Ranking"],"summary":"Multi-asset universe ranked by volatility, Sharpe, return or drawdown","description":"","parameters":[{"name":"sort","in":"query","required":false,"description":"volatility, sharpe, return or drawdown","schema":{"type":"string"},"example":"sharpe"},{"name":"window","in":"query","required":false,"description":"Lookback in days (20-250)","schema":{"type":"string"},"example":"90"},{"name":"class","in":"query","required":false,"description":"Filter by class","schema":{"type":"string"},"example":"commodities"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Annualised realised volatility (std of daily log returns x sqrt(252)), trailing return, a Sharpe-style risk-adjusted return (annualised return / annualised volatility, zero risk-free) and the worst drawdown over window_days. sort by volatility (calmest first), sharpe, return or drawdown. Not financial advice.","class":"commodities","assets":[{"key":"oil","class":"commodities","label":"Crude Oil","vol_regime":"high volatility","observations":90,"sharpe_ratio":5.65,"ann_return_pct":349.3,"max_drawdown_pct":-16.48,"total_return_pct":71.02,"ann_volatility_pct":61.8},{"key":"broad_commodities","class":"commodities","label":"Broad Commodities","vol_regime":"elevated volatility","observations":90,"sharpe_ratio":3.23,"ann_return_pct":76.7,"max_drawdown_pct":-8.96,"total_return_pct":22.56,"ann_volatility_pct":23.8},{"key":"silver","class":"commodities","label":"Silver","vol_regime":"high volatility","observations":90,"sharpe_ratio":-0.56,"ann_return_pct":-38.7,"max_drawdown_pct":-32.16,"total_return_pct":-16.04,"ann_volatility_pct":69.2},{"key":"natural_gas","class":"commodities","label":"Natural Gas","vol_regime":"high volatility","observations":90,"sharpe_ratio":-0.7,"ann_return_pct":-30.4,"max_drawdown_pct":-24.93,"total_return_pct":-12.13,"ann_volatility_pct":43.4},{"key":"gold","class":"commodities","label":"Gold","vol_regime":"elevated volatility","observations":90,"sharpe_ratio":-0.78,"ann_return_pct":-24.5,"max_drawdown_pct":-23.56,"total_return_pct":-9.55,"ann_volatility_pct":31.5}],"source":"Yahoo Finance","calmest":[{"key":"broad_commodities","ann_volatility_pct":23.8},{"key":"gold","ann_volatility_pct":31.5},{"key":"natural_gas","ann_volatility_pct":43.4}],"scanned":5,"sorted_by":"sharpe","window_days":90,"most_volatile":[{"key":"silver","ann_volatility_pct":69.2},{"key":"oil","ann_volatility_pct":61.8},{"key":"natural_gas","ann_volatility_pct":43.4}],"best_risk_adjusted":[{"key":"oil","sharpe_ratio":5.65},{"key":"broad_commodities","sharpe_ratio":3.23},{"key":"silver","sharpe_ratio":-0.56}]},"meta":{"timestamp":"2026-06-12T10:35:16.813Z","request_id":"e8585947-be3b-436c-842c-55c9053f1cd8"},"status":"ok","message":"Ranking 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":"One instrument full risk profile","description":"","parameters":[{"name":"asset","in":"query","required":true,"description":"Asset key (see /v1/universe)","schema":{"type":"string"},"example":"gold"},{"name":"window","in":"query","required":false,"description":"Lookback in days (20-250)","schema":{"type":"string"},"example":"90"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"key":"gold","note":"ann_volatility_pct is annualised realised volatility; sharpe_ratio is annualised return divided by annualised volatility (zero risk-free); max_drawdown_pct is the worst peak-to-trough fall over the window. Computed from daily closes.","class":"commodities","label":"Gold","source":"Yahoo Finance","symbol":"GLD","vol_regime":"elevated volatility","window_days":90,"observations":90,"sharpe_ratio":-0.78,"ann_return_pct":-24.5,"max_drawdown_pct":-23.56,"total_return_pct":-9.55,"ann_volatility_pct":31.5},"meta":{"timestamp":"2026-06-12T10:35:16.937Z","request_id":"fcb7a655-4fad-4590-a70d-afd80f527acb"},"status":"ok","message":"Asset risk 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":"Supported instruments","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Supported cross-asset instruments. Pass key as asset= to /v1/asset, class=/sort= to /v1/ranking.","count":18,"sorts":["volatility","sharpe","return","drawdown"],"assets":[{"key":"sp500","class":"equities","label":"S&P 500","symbol":"SPY"},{"key":"nasdaq100","class":"equities","label":"Nasdaq 100","symbol":"QQQ"},{"key":"russell2000","class":"equities","label":"Russell 2000","symbol":"IWM"},{"key":"emerging","class":"equities","label":"Emerging Markets","symbol":"EEM"},{"key":"long_treasuries","class":"bonds","label":"Long US Treasuries","symbol":"TLT"},{"key":"ig_credit","class":"bonds","label":"Investment-Grade Credit","symbol":"LQD"},{"key":"high_yield","class":"bonds","label":"High-Yield Credit","symbol":"HYG"},{"key":"gold","class":"commodities","label":"Gold","symbol":"GLD"},{"key":"silver","class":"commodities","label":"Silver","symbol":"SLV"},{"key":"oil","class":"commodities","label":"Crude Oil","symbol":"USO"},{"key":"natural_gas","class":"commodities","label":"Natural Gas","symbol":"UNG"},{"key":"broad_commodities","class":"commodities","label":"Broad Commodities","symbol":"DBC"},{"key":"us_dollar","class":"fx","label":"US Dollar Index","symbol":"UUP"},{"key":"eurusd","class":"fx","label":"EUR/USD","symbol":"EURUSD=X"},{"key":"usdjpy","class":"fx","label":"USD/JPY","symbol":"USDJPY=X"},{"key":"real_estate","class":"real_estate","label":"US Real Estate (REITs)","symbol":"VNQ"},{"key":"bitcoin","class":"crypto","label":"Bitcoin","symbol":"BTC-USD"},{"key":"ether","class":"crypto","label":"Ether","symbol":"ETH-USD"}],"source":"Yahoo Finance","classes":["equities","bonds","commodities","fx","crypto","real_estate"]},"meta":{"timestamp":"2026-06-12T10:35:17.046Z","request_id":"cfd2641e-3a69-4d3c-bcdb-a23c72ba63b3"},"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":"window is 20-250 days (default 90). sort is volatility (default), sharpe, return or drawdown. Volatility is annualised by sqrt(252); Sharpe uses a zero risk-free rate. Read fresh per call, nothing cached.","sorts":["volatility","sharpe","return","drawdown"],"source":"Yahoo Finance daily closes (1y range) across a multi-asset universe, live","classes":["equities","bonds","commodities","fx","crypto","real_estate"],"service":"assetvolatility-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/asset":"One instrument's full risk profile (asset=gold, window=90).","GET /v1/ranking":"Multi-asset universe ranked by volatility/sharpe/return/drawdown with headline calmest/most-volatile/best-risk-adjusted (sort=sharpe, class=commodities).","GET /v1/universe":"The supported instruments."},"description":"Cross-asset volatility & risk-adjusted return — the risk dashboard for the whole multi-asset book, live from Yahoo Finance (no key, nothing stored). ranking returns the universe ranked by volatility, Sharpe, return or drawdown, with the calmest, most-volatile and best risk-adjusted assets. asset returns one instrument's full risk profile (annualised volatility, return, Sharpe, max drawdown). universe lists what is covered. The cross-asset volatility / risk-adjusted-return ranking cut — distinct from the crypto-only volatility and risk APIs, the FX-only volatility API and the bring-your-own-series risk-metrics, CAPM and portfolio-optimiser calculators.","universe_size":18,"assets_scanned":18,"upstream_status":"ok"},"meta":{"timestamp":"2026-06-12T10:35:17.359Z","request_id":"c56413ba-2e3d-4c11-a4fc-0df3b35e14d1"},"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":760,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1162,"monthly_call_quota":16900,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3522,"monthly_call_quota":89500,"rps_limit":16,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":8060,"monthly_call_quota":488000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/assetvolatility-api"}