EconomicsAPI

Country imports Retrieve a country's annual import values and quantities using required cid as its ISO2 code. Optionally filter by partner country, product and year range. Use to examine what the country imports and how its imports change over time.

getCountryImports

Country partners Rank a country's trading partners by trade value using required cid as its ISO2 code. Filter by import or export flow, product and year range, and use limit to restrict the ranking. Use to identify its largest trade relationships.

getCountryPartners

Country products Rank the products a country trades by value, grouped by HS6 product code. Supply required cid as its ISO2 code and optionally filter by import or export flow and year range. Use limit for a short ranking of its main imports or exports.

getCountryProducts

Data availability Resolve country and indicator names, codes or aliases and check which economic series are available. Supply at least one country, indicator or indicator group. Use include_series=true to include availability for each country and indicator combination. Use the resolved identifiers with getLatest, getHistory or getForecast.

resolveData

Data updates Find economic indicator series updated after a supplied ISO datetime. Provide since, for example 2026-09-01T00:00:00Z, and optionally filter by country. Use to identify changed series before fetching their values with getLatest or getHistory. This does not return the observations themselves.

getUpdates

Economic news Retrieve published economic news briefs and notes. Filter by country, indicator, kind, minimum importance and publication period, or use slug for one item. Returns news content rather than indicator observations. Use before as a pagination cursor and limit to keep results focused.

getNews

FX rates history Retrieve dated historical foreign-exchange reference rates for a series selected with getFxAvailable. Use from and to to restrict the date range. Returns up to 5,000 observations in chronological order. Use for exchange-rate trends; split larger requests into non-overlapping date windows.

getFxHistory

Indicator forecasts Retrieve available economic indicator forecasts for selected countries and indicators. Returns dated forecast values, units, and lower and upper 80% prediction bounds. Use horizon to limit the number of forecast periods. An empty result means no published forecast is available; forecasts are not observed values.

getForecast

Indicator history Retrieve historical economic indicator observations with dates and units. Supply country and indicator, and narrow the period using from and to years or dates. Use transform for supported growth calculations. Follow next_cursor until null to obtain the complete requested range. Use for historical trends and comparisons.

getHistory

Indicators List economic indicator names, slugs, units and frequencies. Filter by country to find indicators with observations there, or by q to match a name or alias. The default view contains common measures; view=all includes specialist measures. Use a returned slug to retrieve values or forecasts.

listIndicators

Latest FX rate Retrieve the latest available foreign-exchange reference rate for the slug or currency-pair alias selected with getFxAvailable. Returns a dated value and its unit. Use for the latest reference conversion rate, not a live trading quote.

getFx

Latest bond yield Retrieve the latest available government bond yield for a slug selected with getYieldsAvailable. Returns its observation date, value and unit. Use to compare dated yields for a specified country and maturity, not live trading quotes.

getYield

Latest commodity price Retrieve the latest available commodity benchmark price for a slug selected with getCommoditiesAvailable. Returns the observation date, value and unit. Use for dated benchmark prices, not live trading quotes; ambiguous aliases return choices.

getCommodity

Latest indicators Retrieve the latest available economic indicator values for selected countries and indicators, including observation dates, units and previous values. Use country and indicator filters from getEconomicsAvailable; common names such as inflation and unemployment are accepted. Use for current country comparisons.

getLatest

Monthly trade Retrieve monthly bilateral goods-trade observations by exporter, importer, product and date range. Use group_by to aggregate by period, exporter, importer or product code. Use for monthly trade trends, not annual totals. This is a separate derived dataset from the annual trade series.

getTradeMonthly

Product details Retrieve catalog metadata for a goods-trade product using required pid as an HS6 code or a two-to-four-digit chapter prefix. Use to identify a product's name and classification before querying its history or trading partners. This returns product metadata, not trade observations.

getProduct

Product history Retrieve annual trade values and quantities for a specified product using required pid. Optionally filter by reporting country, partner, flow direction and year range. Use to examine product trade over time or identify its available years for a particular country pair.

getProductHistory

Product trading partners Retrieve the top exporting and importing countries for a product using required pid. Filter the year range with from and to and restrict the ranking with limit. Use to identify major country markets for a specified product.

getProductMarkets

Search indicators Search the economic indicator catalog using required free-text q, such as inflation or mexico. Returns matching catalog entries, not observations. Use to discover relevant indicators before retrieving values; limit controls the number of matches.

search

Trade countries Find trade country identifiers using required q as a country name or ISO2/ISO3 code. Returns matching countries and their trade availability, including known countries without coverage. Use the returned ISO2 id in country trade requests.

searchTradeCountries

Trade coverage Check annual and monthly trade coverage, country identifiers and available periods. Optionally provide a country name or code to resolve a particular country, including countries with no trade coverage. Use before choosing filters for trade requests; this does not return trade values.

getCoverage

Trade flows Retrieve individual annual goods-trade flows by reporting country, partner, product, flow direction and year range. Discover identifiers with getTradeAvailable. Use for individual trade records; use getTradeSummary instead when requesting an aggregate total. Product accepts one HS code, not a comma-separated list.

getTrade

Trade products Search the goods-trade product catalog using required q as an HS code prefix or product name, such as coffee. Returns matching product codes and names. Use to identify a product before fetching trade data; limit controls the match count.

searchProducts

Trade summary Retrieve aggregated goods-trade totals for a reporting country, partner, product, flow direction and year range. Returns trade value in USD, quantity, period totals and partner breakdowns. Discover identifiers with getTradeAvailable. Use one product code per call and flow=export or import for the requested direction.

getTradeSummary