70 monthly series
Explore eight categories, from metals and energy to grains and fertilizers. Each observation spans a calendar month.
All APIs
Historical commodity prices API
A commodity prices API for 70 monthly series from the World Bank Pink Sheet. Read copper price history, fertilizer prices and agricultural benchmarks in USD, with units as published. Source: The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0
First request
Quickstart →The response excerpt shows copper. The full metals response also includes other series and next_cursor.
curl --request GET \
--url "https://api.narwhalapi.com/v1/commodities/physical/series?category=metals" \
--header "Authorization: Bearer $NARWHAL_API_KEY"Example response Illustrative response · not a live request
{
"series": [
{
"series_id": "worldbank-cmo-copper",
"commodity": "copper",
"category": "metals",
"product": "copper",
"market": "WLD",
"area": null,
"price_type": "international_benchmark",
"basis": "settlement price",
"currency": "USD",
"unit": "metric_ton",
"unit_quantity": "1",
"frequency": "monthly",
"description": "Grade A copper, minimum 99.9935% purity, cathodes and wire bar shapes, exchange settlement price.",
"publisher": "World Bank",
"attribution": "The World Bank: World Bank Commodity Price Data (The Pink Sheet)",
"coverage_start": "1960-01-01",
"coverage_end": "2026-09-30"
}
]
}Endpoints
GETDiscover physical price series/v1/commodities/physical/series
GETGet physical price series details/v1/commodities/physical/series/{series_id}
GETGet the latest physical price/v1/commodities/physical/series/{series_id}/latest
GETGet physical price history/v1/commodities/physical/series/{series_id}/observations
Monthly prices with a long history
History back to 1960
Compare historical commodity prices over decades. Some series start later or have ended. Check each series for its coverage dates.
Units as published
All prices use USD. Keep unit and unit_quantity together, including USD per 100 sheets for plywood.
Coverage
View coverage →A new month is added after each monthly publication. Individual series can lag or have ended. Barley and sorghum end in August 2020; Mexican shrimp ends in October 2023. Check coverage_end before treating a value as current. Most series use WLD for a world benchmark. Others identify a country or the European Union. Source: The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0
- Softs: Coffee, cocoa, sugar, tea and cotton.
- Oils and oilseeds: Palm oil, soybean oil, soybeans and groundnuts.
- Metals: Copper, aluminium, gold, silver and iron ore.
- Grains: Rice, wheat, maize, barley and sorghum.
- Energy: Crude oil, coal and natural gas.
- Fertilizers: Urea, phosphate rock, potassium chloride, diammonium phosphate and triple superphosphate.
- Forestry: Logs, sawnwood and plywood.
- Livestock and dairy: Beef, chicken, lamb and shrimp.
Explore related pages
Physical series API reference
REST and MCP parameters, responses and history.
Open the reference →Monthly benchmark coverage
Every series, grouped by category, with its market, unit and starting year.
View coverage →Common questions
How do I get copper price history?
Use worldbank-cmo-copper with the observations endpoint. Pass start and end together to select a date window. Copper prices are monthly decimal strings in USD per metric ton.
Does this commodity API include fertilizer prices and rice prices?
Yes. Use category=fertilizers for fertilizer prices, commodity=urea for the urea price series, or commodity=rice for rice price benchmarks. Discovery returns the series IDs for latest prices and history.
How far back does history go?
The earliest monthly series start in January 1960. Others start later, and some have ended. Read coverage_start and coverage_end for each series. Your plan's history allowance also applies.
What units and licence apply?
All prices use USD and the published unit and quantity. No unit conversion is applied. Keep the attribution with the data, which is licensed under CC BY 4.0. Source: The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0