Prices in your currency
Convert a commodity price into your own currency with an exchange rate.
Read the guide →Follow palm oil, daily oil and gas prices, weekly US retail fuel prices and monthly commodity benchmarks. Each series keeps its market, published units and observation period.
curl --request GET \
--url "https://api.narwhalapi.com/v1/commodities/palmoil/physical/id-ri-oil-palm-ffb-smallholder-purchase-agreement" \
--header "Authorization: Bearer $NARWHAL_API_KEY"{
"series_id": "id-ri-oil-palm-ffb-smallholder-purchase-agreement",
"currency": "IDR",
"unit": "kilogram",
"unit_key": "kilogram",
"period_start": "2026-08-26",
"period_end": "2026-09-01",
"revision": 1,
"prices": [
{
"tree_age_min_years": 3,
"tree_age_max_years": 3,
"price": "2998.31"
},
{
"tree_age_min_years": 4,
"tree_age_max_years": 4,
"price": "3347.20"
},
{
"tree_age_min_years": 5,
"tree_age_max_years": 5,
"price": "3595.38"
},
{
"tree_age_min_years": 6,
"tree_age_max_years": 6,
"price": "3734.94"
},
{
"tree_age_min_years": 7,
"tree_age_max_years": 7,
"price": "3818.86"
},
{
"tree_age_min_years": 8,
"tree_age_max_years": 8,
"price": "3865.46"
},
{
"tree_age_min_years": 9,
"tree_age_max_years": 9,
"price": "3878.72"
},
{
"tree_age_min_years": 10,
"tree_age_max_years": 20,
"price": "3836.93"
},
{
"tree_age_min_years": 21,
"tree_age_max_years": 21,
"price": "3770.94"
},
{
"tree_age_min_years": 22,
"tree_age_max_years": 22,
"price": "3695.31"
},
{
"tree_age_min_years": 23,
"tree_age_max_years": 23,
"price": "3609.33"
},
{
"tree_age_min_years": 24,
"tree_age_max_years": 24,
"price": "3544.29"
},
{
"tree_age_min_years": 25,
"tree_age_max_years": 25,
"price": "3490.84"
},
{
"tree_age_min_years": 26,
"tree_age_max_years": 26,
"price": "3471.62"
},
{
"tree_age_min_years": 27,
"tree_age_max_years": 27,
"price": "3441.82"
},
{
"tree_age_min_years": 28,
"tree_age_max_years": 28,
"price": "3385.41"
},
{
"tree_age_min_years": 29,
"tree_age_max_years": 29,
"price": "3344.02"
},
{
"tree_age_min_years": 30,
"tree_age_max_years": 30,
"price": "3249.41"
}
]
}/v1/commodities/palmoil/physicalFind admitted Palm oil physical series by product and country.
productoptionalFilter by the physical product.
countryoptionalFilter by country, such as IDN.
areaoptionalUse an area returned by discovery: ISO 3166-2 where applicable, or a Narwhal-defined nwl-* ID such as nwl-mys-north.
price_typeoptionalofficial_purchase_schedule, government_reference or market_average. The value must be compatible with the product.
currencyoptionalFilter the native currency, such as IDR, USD or MYR. This does not convert prices.
producer_typeoptionalApplies to Indonesian FFB purchase schedules; not accepted with product=cpo.
producer_arrangementoptionalpurchase_agreement or supported_scheme. Applies to Indonesian FFB schedules; not accepted with product=cpo.
limitoptionalMaximum series per page. Defaults to 100.
cursoroptionalContinue with the returned next_cursor and every original filter and limit unchanged.
seriesarrayComplete approved series ordered by stable series_id.
series[].series_idstringStable identity used by the history operation.
series[].product / series[].countrystringsProduct and geographic scope.
series[].areastringNational series omit area. Regional IDs may use the nwl-* namespace.
series[].observation_type / series[].period_typeenumsscalar or age_schedule; effective or observation. These define the response variant and date semantics.
series[].price_type / series[].currency / series[].unitstringsThe source-defined price type, currency and native unit.
series[].unit_keystringunit_key is the unit in one standard spelling, such as troy_ounce, barrel or tonne; unit keeps the source's wording. When a price is quoted in cents, price_scale is 0.01: multiply the price by it to get the amount in currency.
series[].producer_arrangementstringPresent only on Indonesian FFB age-schedule series when the source names an arrangement. Omitted otherwise.
series[].frequency / series[].coverage_start / series[].coverage_endstring and datesCadence and accepted history bounds, not a guarantee of uninterrupted coverage.
next_cursorstring or nullContinuation token, or null when there are no more series.
/v1/commodities/palmoil/physical/{series_id}Get the latest accepted Palm oil observation.
series_idrequiredUse an ID returned by discovery.
price_monthoptionalMPOB CPO only. Selects one quoted month; defaults to each report's own month.
series_idstringStable physical-series identity.
currency / unitstringsCurrency and native unit: kilogram for Indonesian FFB schedules, metric_ton for CPO, or one_percent_oer for Malaysian FFB references.
unit_keystringunit_key is the unit in one standard spelling, such as troy_ounce, barrel or tonne; unit keeps the source's wording. When a price is quoted in cents, price_scale is 0.01: multiply the price by it to get the amount in currency.
period_start / period_enddatesEffective prices use inclusive dates. MPOB uses the report date through the next day, with an exclusive end.
revisionintegerRevision of the price or complete schedule.
price or pricesdecimal string or complete arrayA positive decimal-string price, or a complete prices array with tree_age_min_years, tree_age_max_years and price. Both age bounds are inclusive. Malaysian FFB stays in one_percent_oer.
price_monthYYYY-MMRequired for MPOB CPO quotes; identifies the quoted month; period_start and period_end identify the report-day observation interval.
/v1/commodities/palmoil/physical/{series_id}/observationsGet oldest-first Palm oil observations.
series_idrequiredSeries returned by discovery.
startoptionalInclusive range start; supply it with end. Indonesian effective periods are included when they overlap the range. Malaysian daily prices are selected by report date.
endoptionalExclusive upper bound. It must be later than start.
limitoptionalMaximum observations to return. Defaults to 100; age schedules remain complete.
cursoroptionalContinue with every original parameter unchanged, including series_id, dates, limit and price_month. A changed publication can expire the cursor.
price_monthoptionalMPOB CPO only. Selects one quoted month; defaults to each report's own month.
series_idstringStable physical-series identity.
currency / unitstringsCurrency and native unit shared by every observation.
unit_keystringunit_key is the unit in one standard spelling, such as troy_ounce, barrel or tonne; unit keeps the source's wording. When a price is quoted in cents, price_scale is 0.01: multiply the price by it to get the amount in currency.
observationsarrayPeriod, revision, and scalar value or complete schedule ordered oldest first; MPOB CPO rows retain price_month; Malaysian CPO and FFB rows retain their report-day period_start/period_end.
next_cursorstring or nullOpaque continuation token, or null at the end.
Convert a commodity price into your own currency with an exchange rate.
Read the guide →Page through all the history, save it to a file and resume if it stops.
Read the guide →Run a small script once a day and append the result to a CSV.
Read the guide →Set a carrier surcharge from the weekly diesel price.
Read the use case →Price wheat, rice, sugar and palm oil from monthly series.
Read the use case →Follow the freight and fuel series the API has.
Read the use case →Gold, silver, platinum and palladium spot prices, plus WTI, Brent and copper reference prices.
Explore the API →Current exchange rates, currency conversion and stored rate history.
Explore the API →Free to start. $10 free credits every month, then $2 per 1,000 calls.
See pricing →Coverage includes palm oil, daily oil and gas prices, weekly US gasoline and diesel retail averages, and monthly commodity benchmarks. Each series has its own market, unit and coverage dates.
Use the series definitions first. Prices with different grades, units, delivery bases, or effective periods are not interchangeable.
Compare like with like: currency, unit, grade, location, price type and period all matter. Weekly fuel prices are retail averages. Source: U.S. Energy Information Administration. Monthly benchmarks cover 70 series with history back to 1960. Source: The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0
Free $10 credits every month, no card.Free $10 credits a month, no card.