All APIs

Coverage

Explore live coverage: Economics; FX; Spot commodity prices (Gold, Silver, Platinum, Palladium, Copper, WTI crude oil, Brent crude oil); Palm oil; Weekly US gasoline prices (EIA); Weekly US diesel prices (EIA); Monthly commodity benchmarks (World Bank); Daily spot prices (WTI crude oil, Brent crude oil, Natural gas); Yield curves for the US, the UK, Germany, Japan, and Canada; Prediction market odds (Kalshi and Polymarket); Economic release calendars; Public holidays.

Economics API

Explore the API →

Official indicators: CPI; Inflation; Unemployment; Labour-force participation; GDP; GDP growth; Trade balance; Exports; Imports; Yield curves for the US, the UK, Germany, Japan, and Canada. Coverage varies by country.

Cadence and publishers by country
CountryCurrencyInflationLabourGDPTradeOfficial publishers
AustraliaAUDMonthlyMonthlyQuarterlyMonthlyAustralian Bureau of Statistics (ABS)
AustriaEURMonthlyQuarterlyQuarterlyMonthlyStatistics Austria; Eurostat
BelgiumEURMonthlyQuarterlyQuarterlyMonthlyStatbel; National Bank of Belgium; Eurostat
CanadaCADMonthlyMonthlyQuarterlyMonthlyStatistics Canada
ChileCLPMonthlyMonthlyQuarterlyMonthlyCentral Bank of Chile (BCCh); National Statistics Institute of Chile (INE)
ColombiaCOPMonthlyMonthlyQuarterlyMonthlyNational Administrative Department of Statistics (DANE)
CzechiaCZKMonthlyQuarterlyQuarterlyMonthlyCzech Statistical Office (ČSÚ)
GermanyEURMonthlyQuarterlyQuarterlyMonthlyFederal Statistical Office of Germany (Destatis)
DenmarkDKKMonthlyQuarterlyQuarterlyMonthlyStatistics Denmark; Eurostat
SpainEURMonthlyQuarterlyQuarterlyMonthlyNational Statistics Institute of Spain (INE); Spanish Tax Agency (AEAT)
EstoniaEURMonthlyQuarterlyQuarterlyMonthlyStatistics Estonia
FinlandEURMonthlyMonthlyQuarterlyMonthlyStatistics Finland; Finnish Customs (Tulli)
FranceEURMonthlyQuarterlyQuarterlyMonthlyNational Institute of Statistics and Economic Studies (INSEE); French Customs
United KingdomGBPMonthlyMonthlyQuarterlyMonthlyOffice for National Statistics (ONS)
CroatiaEURMonthlyQuarterlyQuarterlyMonthlyCroatian Bureau of Statistics (CBS)
IrelandEURMonthlyQuarterlyQuarterlyMonthlyCentral Statistics Office (CSO)
ItalyEURMonthlyMonthlyQuarterlyMonthlyItalian National Institute of Statistics (Istat); Eurostat
JapanJPYMonthlyMonthlyQuarterlyMonthlyStatistics Bureau of Japan; Cabinet Office of Japan; Japan Customs
LithuaniaEURMonthlyQuarterlyQuarterlyMonthlyState Data Agency of Lithuania
LuxembourgEURMonthlyQuarterlyQuarterlyMonthlySTATEC; Eurostat
LatviaEURMonthlyQuarterlyQuarterlyMonthlyCentral Statistical Bureau of Latvia (CSB)
MexicoMXNMonthlyMonthlyQuarterlyMonthlyINEGI
MalaysiaMYRMonthlyMonthlyQuarterlyMonthlyDepartment of Statistics Malaysia (DOSM)
NetherlandsEURMonthlyMonthlyQuarterlyMonthlyStatistics Netherlands (CBS)
NorwayNOKMonthlyMonthlyQuarterlyMonthlyStatistics Norway (SSB)
New ZealandNZDNot availableQuarterlyQuarterlyMonthlyStats NZ
PakistanPKRMonthlyNot availableQuarterlyMonthlyPakistan Bureau of Statistics (PBS)
PhilippinesPHPMonthlyMonthlyQuarterlyMonthlyPhilippine Statistics Authority (PSA)
PolandPLNMonthlyQuarterlyQuarterlyMonthlyStatistics Poland; Eurostat
PortugalEURMonthlyQuarterlyQuarterlyMonthlyStatistics Portugal (INE)
QatarQARMonthlyNot availableQuarterlyNot availableNational Planning Council (NPC), via the Qatar Open Data portal
Saudi ArabiaSARMonthlyQuarterlyQuarterlyMonthlyGeneral Authority for Statistics (GASTAT)
SingaporeSGDMonthlyQuarterly or annualQuarterlyMonthlySingapore Department of Statistics (SingStat); Singapore government open-data publications
SloveniaEURMonthlyQuarterlyQuarterlyMonthlyStatistical Office of the Republic of Slovenia (SURS)
SwedenSEKMonthlyMonthlyQuarterlyMonthlyStatistics Sweden (SCB)
United StatesUSDMonthlyMonthlyQuarterlyMonthlyBureau of Labor Statistics (BLS); Bureau of Economic Analysis (BEA); US Census Bureau
View API reference →

Exchange rates using any currency as base or quote, each with its own timestamp and stale flag.

Currencies

USD
EUR
GBP
JPY
CHF
AUD
CAD
NZD
SEK
NOK
DKK
PLN
HUF
CZK
RON
BGN
TRY
ISK
CNY
KRW
IDR
MYR
SGD
HKD
INR
PHP
THB
BRL
MXN
ILS
ZAR
AED
AFN
ALL
AMD
AOA
ARS
AWG
AZN
BAM
BBD
BDT
BHD
BIF
BMD
BND
BOB
BSD
BTN
BWP
BZD
CDF
CLP
COP
CRC
CVE
DJF
DOP
DZD
EGP
ETB
FJD
FKP
GEL
GHS
GIP
GMD
GNF
GTQ
GYD
HNL
HTG
IQD
JMD
JOD
KES
KGS
KHR
KMF
KWD
KYD
KZT
LAK
LBP
LKR
LRD
LSL
LYD
MAD
MDL
MGA
MKD
MMK
MNT
MOP
MRU
MUR
MVR
MWK
MZN
NAD
NGN
NIO
NPR
OMR
PAB
PEN
PGK
PKR
PYG
QAR
RSD
RWF
SAR
SBD
SCR
SDG
SHP
SLE
SOS
SRD
STN
SZL
TJS
TMT
TND
TOP
TTD
TWD
TZS
UAH
UGX
UYU
UZS
VES
VND
VUV
WST
XAF
XCD
XOF
XPF
YER
ZMW

Intraday when available

Actively traded currencies update while markets are open.

Daily reference floor

Daily reference rates provide the fallback when needed.

Freshness per rate

Each current rate includes its own timestamp and stale flag.

History varies

History starts in 1971, 1999, or 2000 by currency.

View API reference →

Commodities API

Explore the API →

Commodity coverage: Spot commodity prices (Gold, Silver, Platinum, Palladium, Copper, WTI crude oil, Brent crude oil); Palm oil; Weekly US gasoline prices (EIA); Weekly US diesel prices (EIA); Monthly commodity benchmarks (World Bank); Daily spot prices (WTI crude oil, Brent crude oil, Natural gas). Prices keep their published units.

Source: U.S. Energy Information Administration. Source: The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0

Palm oil series and areas
Price seriesNative unitHistorical coverage
Indonesia · CPO referenceUSD / metric tonne68 effective periods · 9 August 2022–30 September 2026.
Indonesia · FFB purchase schedulesIDR / kilogram7 accepted series · 60 complete schedules. History and current availability vary by area.
Malaysia · CPO local deliveredMYR / metric tonne1 national + 7 regional series · 1,457 daily reports · 2 January 2020–9 September 2026. Each report retains its quote months.
Malaysia · FFB referenceMYR / 1% OER6 regions · 71 monthly reports containing daily prices · July 2020–September 2026.

Coverage snapshot: 10 September 2026. Date bounds do not mean every day has a reported price.

Malaysian CPO excludes 289 unavailable report dates and one inconsistent report dated 15 November 2022. No-trade cells are not prices.

Malaysian FFB excludes August, September and October 2020 and April 2021 because the source formats disagree. Pre-July-2020 FFB grades and FCPO futures are outside this coverage.

Indonesian FFB areas

AreasCodeStatusCoverage
RiauID-RICurrent schedulesWeekly official purchase schedule.
West KalimantanID-KBAcceptance onlyRelease and schedule must match.
Aceh EastNarwhal areaAccepted historyComplete dated schedules.
Aceh WestNarwhal areaAccepted historyComplete dated schedules.
East KalimantanID-KIAccepted historyHistorical schedules; current coverage is limited.
Bangka BelitungID-BBAccepted historyComplete dated schedules.
LampungID-LAAccepted historyHistorical schedules; current coverage is limited.
FreshnessCoverage
Release dateWhen the authority published the schedule.
Effective periodThe exact inclusive dates the schedule covers.
Tree-age bandsAll prices published together stay in one response.
Whole revisionsA revision replaces the complete schedule.
Monthly benchmark series

70 monthly series in USD. WLD means a world benchmark and EUU means the European Union. Other markets use country codes. Units below include the quantity priced.

A new month is added after each monthly publication. Some series start later, have gaps or have ended. Barley and sorghum end in August 2020; Mexican shrimp ends in October 2023. Check each series for its latest coverage dates.

Source: The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0

Softs · 17 series

NameMarketUnitFrom year
Bananas, EuropeWLDKilogram1997
Bananas, USUSAKilogram1960
CocoaWLDKilogram1960
Coffee, ArabicaWLDKilogram1960
Coffee, RobustaWLDKilogram1960
Cotton, A IndexWLDKilogram1960
OrangesWLDKilogram1960
Rubber, RSS3WLDKilogram1960
Rubber, TSR 20WLDKilogram1999
Sugar, European UnionEUUKilogram1960
Sugar, USUSAKilogram1960
Sugar, worldWLDKilogram1960
Tea, three auction averageWLDKilogram1960
Tea, ColomboLKAKilogram1960
Tea, KolkataINDKilogram1960
Tea, MombasaKENKilogram1960
Tobacco, US import unit valueUSAMetric ton1960

Oils and oilseeds · 11 series

NameMarketUnitFrom year
Coconut oilWLDMetric ton1960
Fish mealWLDMetric ton1979
Groundnut oilWLDMetric ton1960
GroundnutsWLDMetric ton1980
Palm kernel oilWLDMetric ton1996
Palm oilWLDMetric ton1960
Rapeseed oilWLDMetric ton2002
Soybean mealWLDMetric ton1960
Soybean oilWLDMetric ton1960
SoybeansWLDMetric ton1960
Sunflower oilWLDMetric ton2002

Metals · 10 series

NameMarketUnitFrom year
AluminiumWLDMetric ton1960
CopperWLDMetric ton1960
GoldWLDTroy ounce1960
Iron ore, spotWLDDry metric ton unit1960
LeadWLDMetric ton1960
NickelWLDMetric ton1960
PlatinumWLDTroy ounce1960
SilverWLDTroy ounce1960
TinWLDMetric ton1960
ZincWLDMetric ton1960

Grains · 9 series

NameMarketUnitFrom year
BarleyWLDMetric ton1960
MaizeWLDMetric ton1960
Rice, Thai 25%THAMetric ton1986
Rice, Thai 5%THAMetric ton1960
Rice, Thai A.1THAMetric ton1986
Rice, Vietnamese 5%VNMMetric ton2003
SorghumWLDMetric ton1960
Wheat, US hard red winterUSAMetric ton1960
Wheat, US soft red winterUSAMetric ton1979

Energy · 9 series

NameMarketUnitFrom year
Coal, AustraliaAUSMetric ton1970
Coal, South AfricaZAFMetric ton1984
Crude oil, averageWLDBarrel1960
Crude oil, BrentWLDBarrel1960
Crude oil, DubaiWLDBarrel1960
Crude oil, WTIWLDBarrel1982
Liquefied natural gas, JapanJPNMillion British thermal units1977
Natural gas, EuropeWLDMillion British thermal units1960
Natural gas, USUSAMillion British thermal units1960

Fertilizers · 5 series

NameMarketUnitFrom year
Diammonium phosphateWLDMetric ton1967
Phosphate rockWLDMetric ton1960
Potassium chlorideWLDMetric ton1960
Triple superphosphateWLDMetric ton1960
UreaWLDMetric ton1960

Forestry · 5 series

NameMarketUnitFrom year
Logs, CameroonCMRCubic metre1970
Logs, MalaysiaMYSCubic metre1960
PlywoodWLD100 sheets1979
Sawnwood, CameroonCMRCubic metre1970
Sawnwood, MalaysiaMYSCubic metre1960

Livestock and dairy · 4 series

NameMarketUnitFrom year
BeefWLDKilogram1960
ChickenWLDKilogram1960
LambWLDKilogram1971
Shrimp, MexicanMEXKilogram1960

Explore the historical commodity prices API

View API reference →

Prediction markets API

Explore the API →

Market-implied probabilities for economic releases, central bank decisions, metals and energy prices.

Dates & Calendars API

Explore the API →

Official economic release schedules by country, plus public holidays by country and year from official sources.

Public holiday years and scope
CountryYearsCoverage
ARG2026, 2027 — Not available yetNational public holidays
AUS2026, 2027New South Wales only: regional public and bank holidays
BRA2026, 2027 — Not available yetFederal-government public holidays; optional and partial closures excluded
CAN2026, 2027Nationwide statutory baseline for federally regulated private-sector employers; provincial and federal public-service calendars excluded
CHN2026, 2027 — Not available yetNational holiday breaks; make-up working days excluded
DEU2026, 2027 — Not available yetCommon nationwide public holidays; state additions excluded
FRA2026, 2027Common national statutory holidays; regional additions excluded
GBR2026, 2027Bank holidays for England and Wales, Scotland, and Northern Ireland
HKG2026, 2027Hong Kong general holidays; ordinary Sundays excluded
IDN2026, 2027National holidays and collective leave, separately labeled
ITA2026, 2027National civil public holidays; regional and employer closures excluded
JPN2026, 2027National public holidays
IND2026 — Not available yet, 2027 — Not available yetSource review in progress
MEX2026, 2027National mandatory labour-rest dates; banking, state/municipal-only and sector closures excluded
NLD2026, 2027National public holidays; time off depends on employment terms
NZL2026, 2027National holidays and observed dates; regional anniversaries excluded
KOR2026 — Not available yet, 2027 — Not available yetSource review in progress
RUS2026 — Not available yet, 2027 — Not available yetSource review in progress
SAU2026 — Not available yet, 2027 — Not available yetSource review in progress
SGP2026, 2027National public holidays and source-designated observed dates
TUR2026 — Not available yet, 2027 — Not available yetSource review in progress
EST2026, 2027National public holidays and days of rest; national days of importance and shortened workdays excluded
IRL2026, 2027National public holidays; employer-specific alternatives and leave entitlements excluded
LVA2026, 2027National public holidays; commemorations and regional events excluded
LTU2026, 2027National public holidays under Labour Code Article 123; regional events excluded
USA2026, 2027Federal employee holidays and observed dates; state holidays excluded
ZAF2026, 2027National public holidays; school-only holidays excluded
POL2026, 2027National public holidays; ordinary Sundays, regional events and employer closures excluded
CZE2026, 2027National public holidays; significant days, ordinary Sundays and employer closures excluded
SVN2026, 2027National public holidays and work-free days; non-work-free commemorations and local holidays excluded
HRV2026, 2027National public holidays and non-working days; commemorations and denominational days excluded
PRT2026, 2027National mandatory public holidays; optional, municipal and regional holidays excluded
AUT2026, 2027National public holidays
BEL2026, 2027National public holidays
COL2026, 2027National public holidays
DNK2026, 2027Danmarks Nationalbank closing days; not a general employment holiday calendar
ESP2026, 2027 — Not available yetNational public holidays
LUX2026, 2027National public holidays
NOR2026, 2027 — Not available yetNorges Bank settlement-system closing days; not a general employment holiday calendar
SVK2026, 2027National public holidays
SWE2026, 2027National public holidays
TWN2026, 2027Government office calendar; private-sector and market closures excluded
PHL2026 — Not available yet, 2027 — Not available yetSource review in progress
View API reference →

Common questions

Do I need a separate API key for each API?

The same Narwhal API key works for every Narwhal API, and each family links to its API reference for parameters and response fields. Contact support about any country, currency or series that is not listed.

Does every country have the same economic indicators?

Available indicators vary by country, and release cadence follows the official publisher; the country table lists cadence and publishers. Data comes from official national statistics offices and central banks, and Narwhal stores complete accepted releases so your requests do not call publisher websites live.

Which currency pairs are supported, and how often do rates update?

Any supported currency can be the base or quote currency. Actively traded currencies update intraday while markets are open, with daily reference rates as the minimum; every rate carries its own timestamp and stale flag.

Which currencies are supported for spot metal prices?

Gold is quoted in 31 currencies, while silver, platinum, palladium and copper are quoted in US dollars. Spot quotes can be stale while markets are closed.

Are physical commodity prices reported every day?

A date range does not mean a price was reported every day. Palm oil prices retain the source's native unit and price definition.

What topics do prediction markets cover?

Prediction markets provide market-implied probabilities on economic releases, central bank decisions, metals and energy prices.

Why is a public holiday calendar marked “not available yet”?

A public holiday calendar becomes available only once the official source has published it. Until then, it is marked “not available yet”.