All APIs

Commodities API

Prices for spot metals and physical commodities, with native units and series definitions.

First request

curl --request GET \
  --url "https://api.narwhalapi.com/v1/commodities/palmoil/physical?product=ffb&country=IDN" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

Example response Illustrative response · not a live request

{
  "series": [
    {
      "series_id": "id-ri-oil-palm-ffb-smallholder-purchase-agreement",
      "product": "ffb",
      "observation_type": "age_schedule",
      "period_type": "effective",
      "country": "IDN",
      "area": "ID-RI",
      "producer_arrangement": "purchase_agreement",
      "price_type": "official_purchase_schedule",
      "currency": "IDR",
      "unit": "kilogram",
      "coverage_start": "2026-08-19",
      "coverage_end": "2026-09-01",
      "frequency": "weekly"
    }
  ],
  "next_cursor": null
}

Endpoints

Spot metals price API

GETGet a spot price or a futures-based reference price./v1/commodities/spot/{commodity}/{currency}

API reference →

GETGet open, high, low and close bars for gold, silver, platinum, palladium, copper, WTI and BRENT. Copper history is available./v1/commodities/spot/{commodity}/{currency}/bars

API reference →

Physical commodity prices API

GETDiscover palm oil series./v1/commodities/palmoil/physical

API reference →

GETInspect a palm oil series./v1/commodities/palmoil/physical/{series_id}

API reference →

GETRetrieve palm oil observations./v1/commodities/palmoil/physical/{series_id}/observations

API reference →

Sources and methodology

Palm oil series

Discover admitted CPO and FFB series by product, country, area, price type, currency, and native unit.

Read the methodology →

Effective periods

Each accepted observation keeps the dates and revision that define when its price applies.

Physical history

Read source-defined palm oil observations without turning missing or excluded reports into synthetic values.

Coverage

View coverage →

The live release covers spot metals and physical commodities. Units, price types, geography, and effective periods remain attached to each admitted series; futures products are not currently public.