{"openapi":"3.1.0","info":{"title":"Commodities API","version":"1.0.0","description":"Live commodity futures prices as an API — the energy, grain, soft and livestock commodity complex, served from Yahoo Finance. For any commodity it returns the front-month futures price, the previous close, the absolute and percentage change on the day, the day's high and low and the 52-week high and low, with the price's currency and quoting unit (e.g. USD per barrel, US cents per bushel). Look a commodity up by name or alias (crude oil, Brent, natural gas, gasoline, corn, wheat, soybeans, coffee, sugar, cocoa, cotton, orange juice, live cattle, lean hogs and more), pull a category board (energy, grains, softs, livestock) ranked by the day's move, or get the whole board in one call. The commodity-quote layer for trading, markets and dashboard apps. Live, no key. Distinct from the precious-metals API — this is the energy, agricultural and soft-commodity complex.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/commodities-api","description":"oanor gateway"}],"tags":[{"name":"Commodity"},{"name":"Category"},{"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/commodity":{"get":{"operationId":"get_v1_commodity","tags":["Commodity"],"summary":"One commodity futures quote","description":"","parameters":[{"name":"commodity","in":"query","required":true,"description":"Commodity key or alias (e.g. wti, natgas, corn, coffee, oil, gas)","schema":{"type":"string"},"example":"wti"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"Crude Oil (WTI)","unit":"barrel","as_of":"2026-06-09T02:52:20.000Z","price":90.65,"quote":"USD per barrel","change":-0.65,"symbol":"CL=F","day_low":90.48,"category":"energy","currency":"USD","day_high":91.55,"commodity":"wti","change_pct":-0.71,"week52_low":54.98,"week52_high":119.48,"previous_close":91.3},"meta":{"timestamp":"2026-06-09T03:02:25.913Z","request_id":"2744de19-7a5e-4d07-9812-6e439c7311c0"},"status":"ok","message":"Commodity 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/category":{"get":{"operationId":"get_v1_category","tags":["Category"],"summary":"A category board ranked by day change","description":"","parameters":[{"name":"category","in":"query","required":true,"description":"Category: energy|grains|softs|livestock","schema":{"type":"string"},"example":"energy"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":5,"category":"energy","commodities":[{"name":"Natural Gas","unit":"MMBtu","as_of":"2026-06-09T02:51:54.000Z","price":3.15,"quote":"USD per MMBtu","change":0.01,"symbol":"NG=F","day_low":3.13,"category":"energy","currency":"USD","day_high":3.15,"commodity":"natgas","change_pct":0.16,"week52_low":2.48,"week52_high":7.83,"previous_close":3.15},{"name":"RBOB Gasoline","unit":"gallon","as_of":"2026-06-09T02:52:08.000Z","price":3.01,"quote":"USD per gallon","change":-0.01,"symbol":"RB=F","day_low":3.01,"category":"energy","currency":"USD","day_high":3.02,"commodity":"gasoline","change_pct":-0.33,"week52_low":1.67,"week52_high":3.82,"previous_close":3.02},{"name":"Brent Crude Oil","unit":"barrel","as_of":"2026-06-09T02:50:58.000Z","price":93.61,"quote":"USD per barrel","change":-0.64,"symbol":"BZ=F","day_low":93.48,"category":"energy","currency":"USD","day_high":94.52,"commodity":"brent","change_pct":-0.68,"week52_low":58.72,"week52_high":126.1,"previous_close":94.25},{"name":"Crude Oil (WTI)","unit":"barrel","as_of":"2026-06-09T02:52:20.000Z","price":90.65,"quote":"USD per barrel","change":-0.65,"symbol":"CL=F","day_low":90.48,"category":"energy","currency":"USD","day_high":91.55,"commodity":"wti","change_pct":-0.71,"week52_low":54.98,"week52_high":119.48,"previous_close":91.3},{"name":"Heating Oil","unit":"gallon","as_of":"2026-06-09T02:46:03.000Z","price":3.57,"quote":"USD per gallon","change":-0.03,"symbol":"HO=F","day_low":3.57,"category":"energy","currency":"USD","day_high":3.6,"commodity":"heatingoil","change_pct":-0.76,"week52_low":2.05,"week52_high":4.84,"previous_close":3.6}]},"meta":{"timestamp":"2026-06-09T03:02:26.120Z","request_id":"d168fc29-f83a-4719-8f96-251d2619e275"},"status":"ok","message":"Category board 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":"Whole commodity board in one call","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":19,"commodities":[{"name":"Orange Juice","unit":"lb","as_of":"2026-06-08T17:59:14.000Z","price":164,"quote":"US cents per lb","change":3.4,"symbol":"OJ=F","day_low":154,"category":"softs","currency":"USX","day_high":168.25,"commodity":"orangejuice","change_pct":2.12,"week52_low":132.5,"week52_high":344.3,"previous_close":160.6},{"name":"Cotton","unit":"lb","as_of":"2026-06-08T15:30:26.000Z","price":77.87,"quote":"US cents per lb","change":0.39,"symbol":"CT=F","day_low":84.37,"category":"softs","currency":"USX","day_high":87.36,"commodity":"cotton","change_pct":0.5,"week52_low":60.71,"week52_high":88.88,"previous_close":77.48},{"name":"Sugar No.11","unit":"lb","as_of":"2026-06-08T16:59:59.000Z","price":14.16,"quote":"US cents per lb","change":0.04,"symbol":"SB=F","day_low":14.11,"category":"softs","currency":"USX","day_high":14.36,"commodity":"sugar","change_pct":0.28,"week52_low":13.22,"week52_high":17.05,"previous_close":14.12},{"name":"Natural Gas","unit":"MMBtu","as_of":"2026-06-09T02:51:54.000Z","price":3.15,"quote":"USD per MMBtu","change":0.01,"symbol":"NG=F","day_low":3.13,"category":"energy","currency":"USD","day_high":3.15,"commodity":"natgas","change_pct":0.16,"week52_low":2.48,"week52_high":7.83,"previous_close":3.15},{"name":"Corn","unit":"bushel","as_of":"2026-06-09T02:50:21.000Z","price":419.25,"quote":"US cents per bushel","change":0.5,"symbol":"ZC=F","day_low":418.25,"category":"grains","currency":"USX","day_high":421,"commodity":"corn","change_pct":0.12,"week52_low":368.75,"week52_high":481.75,"previous_close":418.75},{"name":"Live Cattle","unit":"lb","as_of":"2026-06-08T18:04:59.000Z","price":236.73,"quote":"US cents per lb","change":0,"symbol":"LE=F","day_low":236.25,"category":"livestock","currency":"USX","day_high":243.25,"commodity":"livecattle","change_pct":0,"week52_low":204.55,"week52_high":258.73,"previous_close":236.73},{"name":"Feeder Cattle","unit":"lb","as_of":"2026-06-08T18:04:55.000Z","price":350.7,"quote":"US cents per lb","change":0,"symbol":"GF=F","day_low":349,"category":"livestock","currency":"USX","day_high":358.55,"commodity":"feedercattle","change_pct":0,"week52_low":299.52,"week52_high":381.03,"previous_close":350.7},{"name":"Lean Hogs","unit":"lb","as_of":"2026-06-08T18:04:59.000Z","price":97.38,"quote":"US cents per lb","change":0,"symbol":"HE=F","day_low":97.15,"category":"livestock","currency":"USX","day_high":101.1,"commodity":"leanhogs","change_pct":0,"week52_low":77.35,"week52_high":113.7,"previous_close":97.38},{"name":"Wheat","unit":"bushel","as_of":"2026-06-09T02:51:32.000Z","price":582.75,"quote":"US cents per bushel","change":-0.5,"symbol":"ZW=F","day_low":581.75,"category":"grains","currency":"USX","day_high":585.75,"commodity":"wheat","change_pct":-0.09,"week52_low":492.25,"week52_high":679.5,"previous_close":583.25},{"name":"Soybean Meal","unit":"short ton","as_of":"2026-06-09T02:52:09.000Z","price":302.3,"quote":"USD per short ton","change":-0.4,"symbol":"ZM=F","day_low":302.1,"category":"grains","currency":"USD","day_high":303.5,"commodity":"soybeanmeal","change_pct":-0.13,"week52_low":258.6,"week52_high":342.7,"previous_close":302.7},{"name":"Coffee","unit":"lb","as_of":"2026-06-08T17:29:59.000Z","price":245.5,"quote":"US cents per lb","change":-0.4,"symbol":"KC=F","day_low":244.3,"category":"softs","currency":"USX","day_high":250.85,"commodity":"coffee","change_pct":-0.16,"week52_low":243.3,"week52_high":437.95,"previous_close":245.9},{"name":"Oats","unit":"bushel","as_of":"2026-06-09T02:52:23.000Z","price":311.25,"quote":"US cents per bushel","change":-1,"symbol":"ZO=F","day_low":311,"category":"grains","currency":"USX","day_high":313.25,"commodity":"oats","change_pct":-0.32,"week52_low":272,"week52_high":403.5,"previous_close":312.25},{"name":"RBOB Gasoline","unit":"gallon","as_of":"2026-06-09T02:52:08.000Z","price":3.01,"quote":"USD per gallon","change":-0.01,"symbol":"RB=F","day_low":3.01,"category":"energy","currency":"USD","day_high":3.02,"commodity":"gasoline","change_pct":-0.33,"week52_low":1.67,"week52_high":3.82,"previous_close":3.02},{"name":"Cocoa","unit":"metric ton","as_of":"2026-06-08T17:29:55.000Z","price":3893,"quote":"USD per metric ton","change":-13,"symbol":"CC=F","day_low":3857,"category":"softs","currency":"USD","day_high":3980,"commodity":"cocoa","change_pct":-0.33,"week52_low":2798,"week52_high":10288,"previous_close":3906},{"name":"Soybeans","unit":"bushel","as_of":"2026-06-09T02:52:09.000Z","price":1112,"quote":"US cents per bushel","change":-3.75,"symbol":"ZS=F","day_low":1111,"category":"grains","currency":"USX","day_high":1117,"commodity":"soybeans","change_pct":-0.34,"week52_low":960.75,"week52_high":1223.25,"previous_close":1115.75},{"name":"Soybean Oil","unit":"lb","as_of":"2026-06-09T02:52:11.000Z","price":74.17,"quote":"US cents per lb","change":-0.39,"symbol":"ZL=F","day_low":74.17,"category":"grains","currency":"USX","day_high":74.69,"commodity":"soybeanoil","change_pct":-0.52,"week52_low":47,"week52_high":79.69,"previous_close":74.56},{"name":"Brent Crude Oil","unit":"barrel","as_of":"2026-06-09T02:50:58.000Z","price":93.61,"quote":"USD per barrel","change":-0.64,"symbol":"BZ=F","day_low":93.48,"category":"energy","currency":"USD","day_high":94.52,"commodity":"brent","change_pct":-0.68,"week52_low":58.72,"week52_high":126.1,"previous_close":94.25},{"name":"Crude Oil (WTI)","unit":"barrel","as_of":"2026-06-09T02:52:20.000Z","price":90.65,"quote":"USD per barrel","change":-0.65,"symbol":"CL=F","day_low":90.48,"category":"energy","currency":"USD","day_high":91.55,"commodity":"wti","change_pct":-0.71,"week52_low":54.98,"week52_high":119.48,"previous_close":91.3},{"name":"Heating Oil","unit":"gallon","as_of":"2026-06-09T02:46:03.000Z","price":3.57,"quote":"USD per gallon","change":-0.03,"symbol":"HO=F","day_low":3.57,"category":"energy","currency":"USD","day_high":3.6,"commodity":"heatingoil","change_pct":-0.76,"week52_low":2.05,"week52_high":4.84,"previous_close":3.6}]},"meta":{"timestamp":"2026-06-09T03:02:26.365Z","request_id":"bc3d17aa-b558-4f71-86fd-ca5679f64284"},"status":"ok","message":"Commodity board 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 full commodity list","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Yahoo Finance public chart API (live)","service":"commodities-api","endpoints":{"GET /v1/list":"The whole commodity board in one call.","GET /v1/meta":"This document (with the full commodity list).","GET /v1/category":"A category board ranked by day change (category=energy|grains|softs|livestock).","GET /v1/commodity":"One commodity quote (commodity=wti|natgas|corn|coffee|… or aliases like oil, gas)."},"categories":["energy","grains","softs","livestock"],"commodities":{"wti":"Crude Oil (WTI)","corn":"Corn","oats":"Oats","brent":"Brent Crude Oil","cocoa":"Cocoa","sugar":"Sugar No.11","wheat":"Wheat","coffee":"Coffee","cotton":"Cotton","natgas":"Natural Gas","gasoline":"RBOB Gasoline","leanhogs":"Lean Hogs","soybeans":"Soybeans","heatingoil":"Heating Oil","livecattle":"Live Cattle","soybeanoil":"Soybean Oil","orangejuice":"Orange Juice","soybeanmeal":"Soybean Meal","feedercattle":"Feeder Cattle"},"description":"Live commodity futures prices from Yahoo Finance: for any energy, grain, soft or livestock commodity, the front-month futures price, previous close, day change (absolute and percent), day high/low and 52-week high/low, with currency and quoting unit. Look one up, pull a category board (energy, grains, softs, livestock) ranked by the day's move, or get the whole board. Live, no key. Distinct from the precious-metals API — this is the energy, agricultural and soft-commodity complex.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-09T03:02:26.477Z","request_id":"b7d0e10a-9b1f-4339-9000-9feac8aa38d4"},"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":10000,"rps_limit":4,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":900,"monthly_call_quota":135000,"rps_limit":12,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2300,"monthly_call_quota":680000,"rps_limit":35,"hard_limit":true},{"slug":"desk","name":"Desk","price_cents_month":5400,"monthly_call_quota":3400000,"rps_limit":100,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/commodities-api"}