Skip to content
Developer docs: all pages

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

Parameters
NameInDescription
key(required)pathlng, crude_oil, petroleum_imports, grain, bunker_fuel, barge_grain, gasoline, diesel, raw_materials, us_petroleum_stocks or canada_grain_exports.
monthsqueryMonths back, 1 to 60 (default 12).
Request
curl -H "Authorization: Bearer $VOYDAR_API_KEY" \
  https://www.voydar.com/api/v1/trade/commodities/lng?months=12
Response (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"]
}