{"openapi":"3.1.0","info":{"title":"Market Ratios API","version":"1.0.0","description":"Live intermarket relative-value ratios as an API — the cross-asset signals macro and technical traders watch, computed from Yahoo Finance prices. Each ratio divides one market by another to reveal relative value and regime: the Gold/Oil ratio (barrels of crude per ounce of gold), the Oil/Gas energy spread, the Copper/Gold ratio (a growth and interest-rate barometer), the S&P 500 priced in gold, and the Stocks/Bonds ratio (risk-on versus risk-off, SPY/TLT). For each it returns both leg prices, the ratio value, the day change and a plain-language reading. Get one ratio or the whole board in a single call. The intermarket relative-value layer for trading, macro-research and dashboard apps. Live, no key, no cache. Distinct from single-asset price APIs and from the precious-metals ratio — this is the cross-asset ratio set.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/marketratios-api","description":"oanor gateway"}],"tags":[{"name":"Ratio"},{"name":"List"},{"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/ratio":{"get":{"operationId":"get_v1_ratio","tags":["Ratio"],"summary":"One intermarket ratio with both legs and reading","description":"","parameters":[{"name":"ratio","in":"query","required":true,"description":"Ratio key (gold_oil|oil_gas|copper_gold|spx_gold|stocks_bonds)","schema":{"type":"string"},"example":"gold_oil"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"Gold / Oil","ratio":"gold_oil","value":48.0852,"reading":"Barrels of crude oil per ounce of gold. High = oil cheap vs gold (risk-off / weak growth).","previous":47.7919,"numerator":{"label":"Gold","price":4359.4,"symbol":"GC=F"},"change_pct":0.61,"denominator":{"label":"WTI Crude","price":90.66,"symbol":"CL=F"}},"meta":{"timestamp":"2026-06-09T03:02:06.218Z","request_id":"b2350366-9948-4e98-9b52-e245249494ac"},"status":"ok","message":"Ratio 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/list":{"get":{"operationId":"get_v1_list","tags":["List"],"summary":"The whole ratio board in one call","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":5,"ratios":[{"name":"Gold / Oil","ratio":"gold_oil","value":48.0852,"reading":"Barrels of crude oil per ounce of gold. High = oil cheap vs gold (risk-off / weak growth).","previous":47.7919,"numerator":{"label":"Gold","price":4359.4,"symbol":"GC=F"},"change_pct":0.61,"denominator":{"label":"WTI Crude","price":90.66,"symbol":"CL=F"}},{"name":"Oil / Natural Gas","ratio":"oil_gas","value":28.7627,"reading":"Energy relative value — WTI price per unit of natural gas. The classic energy spread.","previous":29.0118,"numerator":{"label":"WTI Crude","price":90.66,"symbol":"CL=F"},"change_pct":-0.86,"denominator":{"label":"Natural Gas","price":3.15,"symbol":"NG=F"}},{"name":"Copper / Gold","ratio":"copper_gold","value":0.001452,"reading":"A growth and interest-rate barometer; rising copper/gold signals risk-on and higher yields.","previous":0.001455,"numerator":{"label":"Copper","price":6.33,"symbol":"HG=F"},"change_pct":-0.26,"denominator":{"label":"Gold","price":4359.4,"symbol":"GC=F"}},{"name":"S&P 500 / Gold","ratio":"spx_gold","value":1.6988,"reading":"The S&P 500 priced in gold — ounces of gold to buy the index. Rising = equities outperforming gold.","previous":1.6922,"numerator":{"label":"S&P 500","price":7405.73,"symbol":"^GSPC"},"change_pct":0.39,"denominator":{"label":"Gold","price":4359.4,"symbol":"GC=F"}},{"name":"Stocks / Bonds (SPY/TLT)","ratio":"stocks_bonds","value":8.7358,"reading":"Risk-on vs risk-off — rising favours stocks over long bonds.","previous":8.6709,"numerator":{"label":"S&P 500 ETF","price":739.22,"symbol":"SPY"},"change_pct":0.75,"denominator":{"label":"20Y+ Treasury ETF","price":84.62,"symbol":"TLT"}}]},"meta":{"timestamp":"2026-06-09T03:02:06.448Z","request_id":"8a8391dd-862c-4ea3-869b-f5f22a160198"},"status":"ok","message":"Ratios 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 and ratio list","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"ratios":{"oil_gas":"Oil / Natural Gas","gold_oil":"Gold / Oil","spx_gold":"S&P 500 / Gold","copper_gold":"Copper / Gold","stocks_bonds":"Stocks / Bonds (SPY/TLT)"},"source":"Yahoo Finance public chart API (live)","service":"marketratios-api","endpoints":{"GET /v1/list":"The whole ratio board in one call.","GET /v1/meta":"This document.","GET /v1/ratio":"One intermarket ratio (ratio=gold_oil|oil_gas|copper_gold|spx_gold|stocks_bonds)."},"description":"Live intermarket relative-value ratios from Yahoo Finance: Gold/Oil (barrels per ounce), Oil/Gas energy spread, Copper/Gold (growth & rate barometer), S&P 500 priced in gold, and Stocks/Bonds (SPY/TLT risk-on/off). Each with both leg prices, the ratio, day change and a plain-language reading. Get one ratio or the whole board. Live, no key. Distinct from single-asset price APIs and from the precious-metals ratio — this is the cross-asset ratio set.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-09T03:02:06.541Z","request_id":"316ba0d3-d24a-4b65-8633-e2bfbf1a5771"},"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":8000,"rps_limit":4,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1000,"monthly_call_quota":100000,"rps_limit":12,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2500,"monthly_call_quota":500000,"rps_limit":35,"hard_limit":true},{"slug":"desk","name":"Desk","price_cents_month":6100,"monthly_call_quota":2500000,"rps_limit":100,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/marketratios-api"}