Skip to main content
Commodity prices, USDA transport data, and seasonal anomalies.

GET /api/v1/commodity-prices

IMF commodity benchmark prices, sourced via the FRED API. Series cover wheat, corn, soybeans, crude oil (Brent and WTI), coal, US natural gas, and iron ore. Refreshed weekly on Monday at 06:00 UTC. Parameters
NameTypeRequiredDescription
commoditystringe.g. ‘wheat’, ‘crude_oil_brent’, ‘iron_ore’
sincestringISO date
limitnumberDefault 100, max 500
Response
{ "commodity_prices": [...] }
Example
curl -X GET \
  https://axiomoverwatch.io/api/v1/commodity-prices?commodity=VALUE&since=VALUE

GET /api/v1/transport-data

USDA Grain Transportation Report data: barge, rail, and truck volumes. Parameters
NameTypeRequiredDescription
modestring’barge’ | ‘rail’ | ‘truck’
commoditystringCommodity filter
regionstringOrigin region (fuzzy match)
sincestringISO date
limitnumberDefault 100, max 500
Response
{ "transport_data": [...] }
Example
curl -X GET \
  https://axiomoverwatch.io/api/v1/transport-data?mode=VALUE&commodity=VALUE

GET /api/v1/anomalies

Seasonal and trailing anomalies in export volumes. Parameters
NameTypeRequiredDescription
portstringPort ID
typestring’trailing’ | ‘yoy’ | ‘seasonal_avg’ | ‘seasonal_range’
severitystring’moderate’ | ‘high’ | ‘critical’
limitnumberDefault 100, max 500
Response
{ "anomalies": [...] }
Example
curl -X GET \
  https://axiomoverwatch.io/api/v1/anomalies?port=VALUE&type=VALUE

GET /api/v1/anomalies/maturity

Seasonal analysis maturity levels per port (data sufficiency). Response
{ "maturity": [...] }
Example
curl -X GET \
  https://axiomoverwatch.io/api/v1/anomalies/maturity

GET /api/v1/calibration

Volume estimation calibration data (per-vessel-type and self-calibrated). Response
{ "calibration", "overrides", "self_calibrated", "manual_overrides" }
Example
curl -X GET \
  https://axiomoverwatch.io/api/v1/calibration