primaryValue
Optional
Trade value in current USD (FOB for exports, CIF for imports).
UN Comtrade Trade Flow Watch
Pricing
from $1.00 / 1,000 result rows
Bilateral commodity trade flows from UN Comtrade's official free API: annual trade records per reporter, partner, HS code and year, with values, weights and quantities, per-pair aggregates and change vs previous run. Official UN open data, no key needed. Latest published year per reporter.
recordKey
Required
Stable unique key: '{period}:{reporterCode}:{flowCode}:{partnerCode}:{cmdCode}:{customsCode}:{motCode}' (motCode 0 = total across transport modes).
period
Required
Reference year as returned by the API ('2024').
reporterCode
Required
UN numeric reporter code (Peru=604, China=156, USA=842).
reporter
Optional
Reporter name resolved from the static country list.
flowCode
Required
Trade flow: M=import, X=export, RX=re-export, DX=re-import (a pair's response mixes flows).
partnerCode
Required
UN numeric partner code; 0 = World aggregate.
partner
Optional
Partner name resolved from the static country list ('World' for 0).
cmdCode
Required
HS commodity code (as queried, e.g. '8517').
primaryValue
Optional
Trade value in current USD (FOB for exports, CIF for imports).
netWgt
Optional
Net weight in kg.
qty
Optional
Quantity in the commodity's quantity unit (see qtyUnitAbbr); often 0/-1-coded when unknown.
qtyUnitAbbr
Optional
Quantity unit abbreviation as reported.
cifvalue
Optional
CIF value in USD (imports only).
fobvalue
Optional
FOB value in USD (exports only).
customsCode
Optional
Customs procedure code (C00 = total).
motCode
Optional
Mode-of-transport code (0 = total; 1000 sea, 2100 air, etc.).
isAggregate
Optional
UN flag: row is an aggregate/estimated figure rather than directly reported.
isReported
Optional
UN flag: figure directly reported by the country.
pairKey
Required
Watch pair this record belongs to: '{reporterCode}:{partnerCode}:{cmdCode}:{period}'.
sourceQuery
Required
Query params this record was fetched with.
collectedAt
Required
UTC ISO-8601 collection timestamp.