Sign in

v2

latestOpenAPI 3.0.4Commercial License2026-08-0718678294.5 KB
Prices

Get prices from the past 7 days (most recent 100 raw points)

Returns the most recent page of raw price points inside a 7-day window (default interval=raw).

Page cap. This endpoint returns at most 100 raw points per page. per_page above 100 is reduced to 100; the applied value is returned in X-Per-Page and in data.metadata.truncation.pagination.

Read this if you want a daily series. Series stored as hourly snapshots of a once-daily assessment (all marine/bunker codes, e.g. VLSFO_SGSIN_USD) spend the entire 100-point budget on ~4-5 calendar days, so this endpoint cannot cover a week for them. Use /v1/prices/historical?by_code=…&start_date=…&end_date=…&per_page=500, which returns one point per day for the full window. Use /v1/prices/past_day for intraday detail.

Truncation is signalled. When the response does not cover the requested window, data.metadata.truncation is present — truncated, points_returned, points_available_in_window, window_requested vs window_covered (including the number of distinct days actually covered), and the /v1/prices/historical request that returns the complete daily series. The response also carries X-Truncated: true. When data.metadata.truncation is absent, the page covers the full requested window.

get/v1/prices/past_week

Query parameters

by_code'ALUMINUM_USD' | 'AMMONIA_USD' | 'ASPHALT_USD' | 'AZERI_LIGHT_USD' | 'BAKKEN_DUC_WELLS' | 'BAKKEN_FRAC_SPREADS' | 'BIODIESEL_USD' | 'BRENT_CRUDE_USD' | 'CANADA_RIG_COUNT' | 'CAPP_COAL_USD' | 'CME_COAL_USD' | 'COAL_USD' | 'COKING_COAL_USD' | 'COPPER_USD' | 'CUSHING_STORAGE' | 'DIESEL_USD' | 'DUBAI_CRUDE_USD' | 'DUTCH_TTF_EUR' | 'DUTCH_TTF_NATURAL_GAS_USD' | 'EAGLEFORD_DUC_WELLS' | 'EAGLEFORD_FRAC_SPREADS' | 'ETHANOL_USD' | 'ETHYLENE_USD' | 'EUR_USD' | 'USD_NOK' | 'EUR_NOK' | 'EU_CARBON_EUR' | 'UK_CARBON_GBP' | 'GASOLINE_RBOB_USD' | 'GASOLINE_USD' | 'GBP_USD' | 'GOLD_USD' | 'SILVER_USD' | 'GOLD_AM_USD' | 'GOLD_AM_GBP' | 'GOLD_AM_EUR' | 'GOLD_PM_USD' | 'GOLD_PM_GBP' | 'GOLD_PM_EUR' | 'SILVER_FIX_USD' | 'SILVER_FIX_GBP' | 'SILVER_FIX_EUR' | 'HEATING_OIL_USD' | 'HFO_180_USD' | 'HFO_380_USD' | 'ILLINOIS_COAL_USD' | 'INTERNATIONAL_RIG_COUNT' | 'IRON_ORE_USD' | 'JET_A1_NWE_USD' | 'JET_FUEL_USD' | 'JKM_LNG_USD' | 'LEAD_USD' | 'MGO_05S_USD' | 'METHANOL_USD' | 'NAPHTHA_USD' | 'NICKEL_USD' | 'NATURAL_GAS_GBP' | 'NATURAL_GAS_STORAGE' | 'NATURAL_GAS_USD' | 'NEWCASTLE_COAL_USD' | 'NORTH_DAKOTA_WELL_PERMITS' | 'NYMEX_APPALACHIAN_USD' | 'NYMEX_WESTERN_RAIL_USD' | 'OKLAHOMA_WELL_PERMITS' | 'PALLADIUM_USD' | 'PERMIAN_DUC_WELLS' | 'PERMIAN_FRAC_SPREADS' | 'POLYETHYLENE_USD' | 'POLYPROPYLENE_USD' | 'PLATINUM_USD' | 'PRB_COAL_USD' | 'TAPIS_CRUDE_USD' | 'TIN_USD' | 'TEXAS_WELL_PERMITS' | 'ULSD_DIESEL_USD' | 'URALS_CRUDE_USD' | 'URANIUM_USD' | 'UREA_USD' | 'US_RIG_COUNT' | 'VLSFO_USD' | 'WCS_CRUDE_USD' | 'WTI_USD' | 'ZINC_USD'
Example:JET_FUEL_USD

Commodity code or comma-separated commodity codes. Discover current codes with GET /v1/commodities.

by_type'spot_price' | 'daily_average_price'
Example:spot_price

Optional price-type filter.

start_datestring date
Example:2025-06-01

Override default start date (YYYY-MM-DD). Also accepts camelCase: startDate

end_datestring date
Example:2025-12-31

Override default end date (YYYY-MM-DD). Also accepts camelCase: endDate

interval'raw' | 'hourly' | 'daily' | 'weekly' | 'monthly'
Example:daily

Data aggregation interval

per_pageinteger
Example:100

Points per page. Capped at 100 on raw responses (500 when an interval is supplied); requests above the cap are reduced and the applied value is reported in X-Per-Page and data.metadata.truncation.

pageinteger
Example:1

One-based page number.

Response

Past week price data

Example response

{
  "prices": [
    {
      "price": 75.42,
      "formatted": "$75.42",
      "currency": "USD",
      "code": "BRENT_CRUDE_USD",
      "created_at": "2025-01-20T10:30:00.000Z",
      "updated_at": "2025-01-20T10:30:00.000Z",
      "type": "spot_price",
      "change_24h": 0.74,
      "change_24h_percent": 1.25
    }
  ],
  "meta": {
    "current_page": 1,
    "total_pages": 10,
    "total_count": 250,
    "per_page": 25
  }
}