All endpoints return JSON. Base URL: https://tradeweave.org
45 endpoints · Cached 1hr (CDN: 24hr) · Most accept year parameter (default: 2024)
/api/countriesList all countries with codes
/api/countries/[iso3]Country summary (name, exports, ECI rank)
/api/countries/[iso3]/tradeProduct-level trade data (treemap-ready)
/api/countries/[iso3]/trade-compositionTrade composition by HS section
/api/countries/[iso3]/timeseriesExports, imports, balance over all years
/api/countries/[iso3]/partnersTop export/import partners with geo data
/api/countries/[iso3]/complexityECI, product complexity proximity
/api/countries/[iso3]/opportunitiesStrategic bets and nearby complex products
/api/countries/[iso3]/vulnerabilitiesConcentrated/declining export warnings
/api/countries/[iso3]/trade-indicesAll classical indices: HHI, Gini, Theil, Lafay, Michaely, ToT, IIT, EXPY, FK similarity
Params: year
/api/countries/[iso3]/rca-dynamicsRising/declining RCA products over window
Params: year, window
/api/countries/[iso3]/rca-transitionClassic/Emerging/Disappearing CA transition matrix
Params: year, window
/api/countries/[iso3]/export-survivalExport survival curves and cohort analysis
Params: year
/api/countries/[iso3]/marginsExtensive vs intensive margin decomposition
Params: year, base_year
/api/countries/[iso3]/diversification-timelineHHI, product count, partner count over time
/api/countries/[iso3]/factor-intensityLall technology classification breakdown
Params: year
/api/countries/[iso3]/market-concentrationDestination HHI, Gini, concentration ratios
Params: year
/api/countries/[iso3]/market-powerGeoDep market power analysis
/api/bilateral/[exporter]/[importer]Bilateral trade by product (exporter/importer are iso3 codes)
Params: year
/api/bilateral/[exporter]/[importer]/timeseriesBilateral trade over all years
/api/bilateral/[exporter]/[importer]/grubel-lloydGrubel-Lloyd IIT analysis by product
Params: year
/api/bilateral/[exporter]/[importer]/complementarityTrade Complementarity Index with gaps
Params: year
/api/productsList all products with codes and sections
/api/products/[hs]Product summary (PCI, top exporters)
/api/products/[hs]/countriesTop exporting countries for this product
/api/products/[hs]/timeseriesGlobal trade in this product over time
/api/products/[hs]/rca-countriesCountries with RCA ≥ 1 in this product
/api/rankingsCountry rankings by exports, imports, HHI
Params: year, sort, limit
/api/rankings/eciEconomic Complexity Index rankings
Params: year
/api/rankings/pciProduct Complexity Index rankings
Params: year
/api/rankings/volumeVolume-based trade rankings
/api/compareSide-by-side comparison with FK similarity
Params: countries (required, comma-separated iso3), year
/api/competition/[iso3]Competitive landscape and market overlap
/api/competition/raceExport race between countries over time
Params: product (required), countries (required, comma-separated iso3), year
/api/gravity/pairGravity model prediction for a country pair
Params: o (required, origin iso3), d (required, destination iso3), year
/api/gravity/potentialTrade potential from gravity residuals
Params: iso3, year, limit
/api/diagnostic/[iso3]Comprehensive diagnostic (strategic health, threats, peers)
/api/bop/[iso3]Balance of Payments data
/api/bop/[iso3]/indicatorsBOP indicator list
/api/bop/[iso3]/timeseriesBOP timeseries
/api/commodities/prices/monthlyMonthly commodity prices
/api/commodities/prices/annualAnnual commodity prices
/api/commodities/food-security/[areaCode]Food security indicators
/api/commodities/agri-trade/searchAgricultural trade search
/api/commodities/value-chains/[areaCode]Agricultural value chains