GET/api/v1/trade/commodities/{key}
A commodity: volume summary, price series and sources
Volume summary and published price series for one commodity: lng (DOE export cargoes), crude_oil or petroleum_imports (EIA-814 company imports; not total US imports), us_petroleum_stocks (EIA Weekly Petroleum Status Report), canada_grain_exports (Canadian Grain Commission), and the price-only keys gasoline, diesel (EIA weekly US retail prices, USD per gallon) and raw_materials (Statistics Canada raw materials price index). `prices` lists each held price or price-index series with its unit, currency, basis and source; series are never averaged or added and `kind: index` is a unitless index. `price` is always null. grain (USDA FGIS export inspections), bunker_fuel and barge_grain are recognised but held pending rights and return only `withheld`. These are reported government statistics, each series with its source and licence; nothing here is a voyage model or an estimate of what a ship carries. Sources withheld for rights reasons are listed as withheld with the reason, and no plan unlocks them. Available on every API plan, including the free Sandbox. A server-side release switch is checked on every request: while it is off for your account this endpoint answers 404 (not_found), free.
1 creditKey required
| Name | In | Description |
|---|---|---|
| key(required) | path | lng, crude_oil, petroleum_imports, grain, bunker_fuel, barge_grain, gasoline, diesel, raw_materials, us_petroleum_stocks or canada_grain_exports. |
| months | query | Months back, 1 to 60 (default 12). |
curl -H "Authorization: Bearer $VOYDAR_API_KEY" \
https://www.voydar.com/api/v1/trade/commodities/lng?months=12Response (abridged)
{
"type": "port_list",
"apiVersion": "1",
"count": 2,
"data": [
{ "unlocode": "NLAMS", "name": "Amsterdam", "country": "NL", "coordinates": { "lat": 52.4, "lon": 4.82, "source": "unlocode" },
"api": "https://www.voydar.com/api/v1/ports/nlams" },
{ "unlocode": "NLRTM", "name": "Rotterdam", "country": "NL", "coordinates": { "lat": 51.9, "lon": 4.5, "source": "nga_wpi" },
"api": "https://www.voydar.com/api/v1/ports/nlrtm" }
],
"next": "https://www.voydar.com/api/v1/ports?country=NL&limit=2&cursor=NLRTM",
"withheld": [],
"attribution": [ "…" ], "license": [ "…" ], "sources": ["nga_wpi", "unlocode"]
}