{"openapi":"3.1.0","info":{"title":"Commodities Momentum & Relative-Strength API","version":"1.0.0","description":"Which corner of the commodity complex is leading and which is lagging, ranked by trailing momentum, computed live from Yahoo Finance futures (no key, nothing stored). A price tells you where a commodity is; momentum tells you where the money is flowing. This scores every major commodity — crude, Brent, natural gas, gasoline and heating oil in energy; gold, silver, copper, platinum and palladium in metals; corn, wheat and soybeans in grains; coffee, sugar, cocoa, cotton and orange juice in softs; live cattle and lean hogs in livestock — by its return over five horizons (1 week, 1 month, 3 months, 6 months and a ~1-year proxy), blends them into a single momentum score and ranks the whole complex into leaders and laggards. The screener endpoint returns that ranked table with a relative-strength rank and trend regime for each. The momentum endpoint drills into one commodity: its multi-horizon returns, where it sits versus its 50- and 200-day averages, and a trend label. The commodities endpoint lists what is covered. The cross-commodity momentum / relative-strength factor cut — distinct from the commodity-price feed (front-month prices), the commodity-spreads API (crack/crush/ratios) and the precious-metals spot API. It answers what is leading the complex, not what one thing costs.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/commoditymomentum-api","description":"oanor gateway"}],"tags":[{"name":"Screener"},{"name":"Momentum"},{"name":"Commodities"},{"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":"Commodity complex ranked by momentum with leaders/laggards","description":"","parameters":[{"name":"group","in":"query","required":false,"description":"Filter by sector: energy, metals, grains, softs, livestock","schema":{"type":"string"},"example":"metals"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The commodity complex ranked by blended trailing momentum (1w-6m returns), strongest first. rank is the relative-strength rank. Use leaders/laggards for the headline rotation. group filters to energy, metals, grains, softs or livestock.","group":"metals","source":"Yahoo Finance","leaders":[{"name":"Copper","regime":"uptrend","momentum_score":7.93},{"name":"Gold","regime":"downtrend","momentum_score":-6.94},{"name":"Palladium","regime":"downtrend","momentum_score":-8.33}],"scanned":5,"laggards":[{"name":"Platinum","regime":"downtrend","momentum_score":-8.94},{"name":"Silver","regime":"downtrend","momentum_score":-8.37},{"name":"Palladium","regime":"downtrend","momentum_score":-8.33}],"commodities":[{"key":"copper","name":"Copper","rank":1,"group":"metals","price":6.3965,"regime":"uptrend","symbol":"HG=F","currency":"USD","above_ma50":true,"above_ma200":true,"returns_pct":{"1m":-3.6,"1w":2.12,"3m":11.93,"6m":21.25,"ytd_proxy":32.67},"momentum_score":7.93},{"key":"gold","name":"Gold","rank":2,"group":"metals","price":4231.7998,"regime":"downtrend","symbol":"GC=F","currency":"USD","above_ma50":false,"above_ma200":false,"returns_pct":{"1m":-9.92,"1w":-2.43,"3m":-16.24,"6m":0.84,"ytd_proxy":25.17},"momentum_score":-6.94},{"key":"palladium","name":"Palladium","rank":3,"group":"metals","price":1317,"regime":"downtrend","symbol":"PA=F","currency":"USD","above_ma50":false,"above_ma200":false,"returns_pct":{"1m":-13.98,"1w":5.61,"3m":-15.26,"6m":-9.69},"momentum_score":-8.33},{"key":"silver","name":"Silver","rank":4,"group":"metals","price":67.035,"regime":"downtrend","symbol":"SI=F","currency":"USD","above_ma50":false,"above_ma200":false,"returns_pct":{"1m":-24.58,"1w":-2.77,"3m":-17.15,"6m":11.02,"ytd_proxy":85.11},"momentum_score":-8.37},{"key":"platinum","name":"Platinum","rank":5,"group":"metals","price":1721.8,"regime":"downtrend","symbol":"PL=F","currency":"USD","above_ma50":false,"above_ma200":false,"returns_pct":{"1m":-21.27,"1w":-3.92,"3m":-15.46,"6m":4.87,"ytd_proxy":35.29},"momentum_score":-8.94}]},"meta":{"timestamp":"2026-06-12T10:35:25.915Z","request_id":"ef5aa41e-4471-4860-bc5e-48197ebc3611"},"status":"ok","message":"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/momentum":{"get":{"operationId":"get_v1_momentum","tags":["Momentum"],"summary":"One commodity multi-horizon returns, MA position and trend regime","description":"","parameters":[{"name":"commodity","in":"query","required":true,"description":"Key, name or alias (see /v1/commodities)","schema":{"type":"string"},"example":"gold"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"key":"gold","name":"Gold","note":"returns_pct are trailing price changes over 1 week, 1 month, 3 months, 6 months and a ~1y (ytd proxy) horizon. momentum_score blends the 1w-6m returns. regime combines the score with the 50/200-day moving-average position. Not financial advice.","group":"metals","price":4231.7998,"regime":"downtrend","source":"Yahoo Finance","symbol":"GC=F","currency":"USD","above_ma50":false,"above_ma200":false,"returns_pct":{"1m":-9.92,"1w":-2.43,"3m":-16.24,"6m":0.84,"ytd_proxy":25.17},"momentum_score":-6.94},"meta":{"timestamp":"2026-06-12T10:35:26.034Z","request_id":"0485b9a5-b319-493f-91a7-64382f562ed6"},"status":"ok","message":"Momentum 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/commodities":{"get":{"operationId":"get_v1_commodities","tags":["Commodities"],"summary":"Supported commodities and groups","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Supported commodities. Pass key, name or alias as commodity= to /v1/momentum, or group= to /v1/screener.","count":22,"groups":["energy","metals","grains","softs","livestock"],"source":"Yahoo Finance","commodities":[{"key":"crude_oil","name":"WTI Crude Oil","group":"energy","symbol":"CL=F"},{"key":"brent","name":"Brent Crude Oil","group":"energy","symbol":"BZ=F"},{"key":"natural_gas","name":"Natural Gas","group":"energy","symbol":"NG=F"},{"key":"gasoline","name":"RBOB Gasoline","group":"energy","symbol":"RB=F"},{"key":"heating_oil","name":"Heating Oil","group":"energy","symbol":"HO=F"},{"key":"gold","name":"Gold","group":"metals","symbol":"GC=F"},{"key":"silver","name":"Silver","group":"metals","symbol":"SI=F"},{"key":"copper","name":"Copper","group":"metals","symbol":"HG=F"},{"key":"platinum","name":"Platinum","group":"metals","symbol":"PL=F"},{"key":"palladium","name":"Palladium","group":"metals","symbol":"PA=F"},{"key":"corn","name":"Corn","group":"grains","symbol":"ZC=F"},{"key":"wheat","name":"Wheat","group":"grains","symbol":"ZW=F"},{"key":"soybeans","name":"Soybeans","group":"grains","symbol":"ZS=F"},{"key":"soybean_oil","name":"Soybean Oil","group":"grains","symbol":"ZL=F"},{"key":"soybean_meal","name":"Soybean Meal","group":"grains","symbol":"ZM=F"},{"key":"coffee","name":"Coffee","group":"softs","symbol":"KC=F"},{"key":"sugar","name":"Sugar","group":"softs","symbol":"SB=F"},{"key":"cocoa","name":"Cocoa","group":"softs","symbol":"CC=F"},{"key":"cotton","name":"Cotton","group":"softs","symbol":"CT=F"},{"key":"orange_juice","name":"Orange Juice","group":"softs","symbol":"OJ=F"},{"key":"live_cattle","name":"Live Cattle","group":"livestock","symbol":"LE=F"},{"key":"lean_hogs","name":"Lean Hogs","group":"livestock","symbol":"HE=F"}]},"meta":{"timestamp":"2026-06-12T10:35:26.125Z","request_id":"d6594f29-a204-4e15-911e-ab50feeb4bb1"},"status":"ok","message":"Commodities 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":"commodity is a key/name/alias (gold, crude oil, KC=F; see /v1/commodities). screener group= filters by sector. momentum_score blends 1w-6m trailing returns. Read fresh per call, nothing cached.","groups":["energy","metals","grains","softs","livestock"],"source":"Yahoo Finance daily commodity futures, 1y range, live","service":"commoditymomentum-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/momentum":"One commodity's multi-horizon returns, MA position and trend regime (commodity=gold).","GET /v1/screener":"The commodity complex ranked by momentum, with leaders/laggards (group=energy optional).","GET /v1/commodities":"The supported commodities and groups."},"description":"Commodities momentum & relative strength — which part of the commodity complex is leading and which is lagging, ranked by trailing momentum, live from Yahoo Finance futures (no key, nothing stored). screener returns the whole complex ranked by a blended momentum score with a relative-strength rank and trend regime. momentum drills into one commodity (multi-horizon returns + 50/200-day position). commodities lists what is covered. The cross-commodity momentum / relative-strength factor cut — distinct from the commodity-price feed, the commodity-spreads API and the precious-metals spot API. It answers what is leading the complex.","upstream_status":"ok","commodities_covered":22,"gold_momentum_score":-6.94},"meta":{"timestamp":"2026-06-12T10:35:26.212Z","request_id":"5c873f5f-523c-4bd3-a4db-99395d4fec34"},"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":800,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1066,"monthly_call_quota":21000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3144,"monthly_call_quota":105000,"rps_limit":18,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":7460,"monthly_call_quota":540000,"rps_limit":45,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/commoditymomentum-api"}