Data dictionary.

Clear definitions for the trade data used across WorldTradePulse.

Dimensions

Dimensions describe what a trade record refers to. Some are stored as relational fields and some are represented by linked country or product records.

ConceptMeaningHow to use it
Reporter countryCountry publishing the trade recordChoose the country you are analysing
Partner countryOther country in the bilateral relationshipCompare trade relationships
ISO3Three-letter country identifier where availableIdentify countries consistently
UN M49UN numerical country or area codeResolve reporters against UN Comtrade
YearCalendar year of the annual recordChoose a time period
Flow codeX exports; M importsInterpret direction from the reporter's perspective
FrequencyA for annual dataConfirm the reporting period
HS classificationHarmonized System product classificationGroup merchandise categories
HS levelNumber of digits in product category; current ingestion uses 2Understand product granularity

Measures

MeasureDefinitionImportant note
Trade valueReported monetary value for a trade recordUN Comtrade generally reports values in current US dollars; values are not inflation-adjusted by default
Total imports / exportsSum of relevant reported trade valuesDepends on partner/product filters and available records
Partner sharePartner's value divided by selected totalChanges with filtering and missing data

What not to assume

  • No row does not necessarily mean zero trade.
  • Imports reported by one country may not equal exports reported by its partner.
  • Reported trade value is not profit, GDP or physical volume.
  • Comparisons across years may be affected by reporting or classification changes.

Scope: This dictionary explains the user-facing data concepts. It is not yet a complete PostgreSQL schema reference or API contract.

Keep exploring WorldTradePulseNext: Model dictionary ↗