get_mirror_trade
Two customs records of trade between two reporting countries: reporter's flow (export or import) with partner as the other side, next to the partner's opposite flow with the reporter as the other side. For example reporter JP, partner GB, flow export, code 8708 (auto parts) shows Japan's exports to the United Kingdom beside the United Kingdom's imports from Japan, for the same 12 months (ending at the latest month both sides have published), in US dollars with the weights. Returns each side's value, kg, basis (exports FOB, imports CIF; the US export value is FAS) and partner definition, the difference (import side minus export side) and the ratio (import side / export side). The import side is normally larger because it includes freight and insurance; differences also come from timing, classification and re-exports, and each country defines its partner differently (the UK counts imports by country of consignment). Works at HS6, HS4 and HS2 only. Use it to check one country's figure against the partner's record, or to see how large the valuation gap is; use compare_countries instead to compare more countries on one flow. Customs trade statistics of several reporting countries (Japan JP, United States US, United Kingdom GB, European Union (27 member states) EU) from their official customs data, monthly, by HS product code and partner country. value fields are in the reporter's currency (currency: JPY, USD, GBP or EUR) and _usd fields in US dollars; ratios and shares are fractions precomputed from the full dataset; every answer carries reporter, currency, data_through (latest published month), the reporter's attribution, and notes. Maximum 200 rows per answer. Numbers in answers are rounded once, at the end: amounts (value, _usd, v12 ...) to 2 decimals, quantity and kg to 3, unit prices (unit_price) to 4 significant digits below 100 and 2 decimals from 100 up (never rounded to 0), and ratios, shares and growth rates (yoy, mom*, share*, hhi*, chg3y) to 6; whole numbers and null are left as they are. A null quantity, kg or unit price comes with a *_unavailable_reason (mixed_units, weight_only, no_quantity_in_source, no_weight_in_source, source_gap, withheld; get_catalog lists them in null_reasons), and a missing seasonality with seasonality_unavailable_reason. The national level (JP 9-digit, US 10-digit, GB 8-digit codes) differs between reporters and between import and export; EU has no national level (HS6 only); HS6, HS4 and HS2 are shared. Import and export are separate datasets, so reporter and flow are always required for product figures. Rankings (limit) are limited to the top 20 without an API key (more is refused with out_of_scope) and to 100 with a free API key. Start with get_catalog (coverage, your access limits, which tool to use) or, when you already know the code, get_item_summary for a one-call overview of a product.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"reporter": "<reporter>",
"partner": "<partner>",
"code": "<code>",
"flow": "<flow>"
},
"name": "get_mirror_trade"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | Yes | HS product code with 2, 4 or 6 digits (e.g. "72" iron and steel, "854231" processors, "300490" medicines in dosage form; dots are ignored). National codes are rejected. | |
| flow | Yes | Required. The direction on the reporter side: "export" (exports of the reporter to the partner, mirrored by imports of the partner from the reporter) or "import" (imports of the reporter from the partner, mirrored by exports of the partner to the reporter). | |
| partner | Yes | Required. The other reporting country, "JP", "US", "GB" or "EU" (not the same as reporter). Its opposite flow is read as the mirror, e.g. reporter "JP" flow "export" with partner "US" reads US imports from Japan. | |
| reporter | Yes | Required. The reporting country whose customs statistics are read: "JP" (Japan), "US" (United States), "GB" (United Kingdom) or "EU" (European Union (27 member states)). Partners are the other countries. |