GET/api/v1/trade/freight
Freight rate and cost indices
Freight price series with latest value, 1-month and 12-month change and a bounded history: BLS Producer Price Index for freight and logistics, the BTS Freight Transportation Services Index, where loaded and licensed. The USDA Mississippi barge rate is held pending rights and appears only under `withheld`. Commercial freight indices (Baltic, Drewry, SCFI and similar) are not held. At most 20 series, each with up to 60 months. The PPI series are not seasonally adjusted and the TSI is (`seasonal`); the newest months are preliminary and revised. A source with nothing loaded is listed under `noData`. Each series may carry `signal`, calculated by Voydar on the published values for the newest month (`derived: true`, evidenceClass calculated, with method, version, inputs and attribution): change on the month and on the year, the modified z-score of the newest change against up to 60 earlier changes (`outsideUsualRange` at 3.5 or more), `firstMonthOutside` (true only in the first month of a run; a change on the year stays outside for up to twelve months after one shift in level, so later months are a state, not news), `outsideSince`, and the seasonal index of the month as a percentage. It is absent when the series is too short or the fact is older than the newest value. Not a forecast. 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 |
|---|---|---|
| series | query | A series id or key, a mode (sea, inland-water, rail, air, truck, port, logistics), or a source id. |
| months | query | Months of history, 1 to 60 (default 12). |
curl -H "Authorization: Bearer $VOYDAR_API_KEY" \
https://www.voydar.com/api/v1/trade/freight?series=sea&months=24Response (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"]
}