{
 "meta": {
  "schema_version": "1.0",
  "pipeline_version": "0.1.0",
  "vintage": "2026-10-16",
  "data_as_of": "2026-10-16T07:04:34Z",
  "units": {
   "weight": "t",
   "value": "USD"
  }
 },
 "data": [
  {
   "file": "annual_mirror.json / .csv",
   "fields": [
    {
     "field": "year / period",
     "type": "integer / string",
     "unit": "",
     "description_en": "Calendar year, or month as YYYY-MM",
     "description_mn": "Он, эсвэл сар (YYYY-MM)"
    },
    {
     "field": "mn.t",
     "type": "integer",
     "unit": "t",
     "description_en": "Mongolia: Tonnes reported by this side",
     "description_mn": "Монгол: Энэ талын мэдээлсэн тонн"
    },
    {
     "field": "mn.usd",
     "type": "integer",
     "unit": "USD",
     "description_en": "Mongolia: US dollars reported by this side (Mongolia FOB, China CIF)",
     "description_mn": "Монгол: Энэ талын мэдээлсэн ам.доллар (Монгол FOB, Хятад CIF)"
    },
    {
     "field": "mn.t_source",
     "type": "string",
     "unit": "",
     "description_en": "Mongolia: Source id the tonnes come from",
     "description_mn": "Монгол: Тонны эх сурвалж"
    },
    {
     "field": "mn.usd_source",
     "type": "string",
     "unit": "",
     "description_en": "Mongolia: Source id the dollars come from",
     "description_mn": "Монгол: Ам.долларын эх сурвалж"
    },
    {
     "field": "mn.basis",
     "type": "string",
     "unit": "",
     "description_en": "Mongolia: hs_partner (customs data by partner), curated_official, curated_press or nso_share_adjusted",
     "description_mn": "Монгол: hs_partner (түнш улсаар), curated_official, curated_press эсвэл nso_share_adjusted"
    },
    {
     "field": "mn.t_source_url",
     "type": "string",
     "unit": "",
     "description_en": "Mongolia: Link to the exact request or publication",
     "description_mn": "Монгол: Тухайн хүсэлт эсвэл нийтлэлийн холбоос"
    },
    {
     "field": "mn.share",
     "type": "number",
     "unit": "ratio",
     "description_en": "China's share applied to Mongolia's all-destination total",
     "description_mn": "Монголын нийт экспортод хэрэглэсэн Хятадын эзлэх хувь"
    },
    {
     "field": "mn.t_low / mn.t_high",
     "type": "integer",
     "unit": "t",
     "description_en": "Range for share-adjusted figures: lowest recent share up to 100% of exports",
     "description_mn": "Хувиар тооцсон тооны хүрээ: сүүлийн жилүүдийн хамгийн бага хувиас 100% хүртэл"
    },
    {
     "field": "mn.alt_t_nso_share_adjusted",
     "type": "integer",
     "unit": "t",
     "description_en": "The share-adjusted NSO figure, shown for comparison when another source was chosen",
     "description_mn": "Өөр эх сурвалж сонгосон үед харьцуулахаар үзүүлсэн ҮСХ-ны хувиар тооцсон тоо"
    },
    {
     "field": "cn.t",
     "type": "integer",
     "unit": "t",
     "description_en": "China: Tonnes reported by this side",
     "description_mn": "Хятад: Энэ талын мэдээлсэн тонн"
    },
    {
     "field": "cn.usd",
     "type": "integer",
     "unit": "USD",
     "description_en": "China: US dollars reported by this side (Mongolia FOB, China CIF)",
     "description_mn": "Хятад: Энэ талын мэдээлсэн ам.доллар (Монгол FOB, Хятад CIF)"
    },
    {
     "field": "cn.t_source",
     "type": "string",
     "unit": "",
     "description_en": "China: Source id the tonnes come from",
     "description_mn": "Хятад: Тонны эх сурвалж"
    },
    {
     "field": "cn.usd_source",
     "type": "string",
     "unit": "",
     "description_en": "China: Source id the dollars come from",
     "description_mn": "Хятад: Ам.долларын эх сурвалж"
    },
    {
     "field": "cn.basis",
     "type": "string",
     "unit": "",
     "description_en": "China: hs_partner (customs data by partner), curated_official, curated_press or nso_share_adjusted",
     "description_mn": "Хятад: hs_partner (түнш улсаар), curated_official, curated_press эсвэл nso_share_adjusted"
    },
    {
     "field": "cn.t_source_url",
     "type": "string",
     "unit": "",
     "description_en": "China: Link to the exact request or publication",
     "description_mn": "Хятад: Тухайн хүсэлт эсвэл нийтлэлийн холбоос"
    },
    {
     "field": "cn.excluded_estimated_t",
     "type": "integer",
     "unit": "t",
     "description_en": "UN Comtrade's estimated weight, shown but never compared",
     "description_mn": "НҮБ-ын Comtrade-ийн тооцоолсон жин; харуулсан ч харьцуулаагүй"
    },
    {
     "field": "gap.t",
     "type": "integer",
     "unit": "t",
     "description_en": "China minus Mongolia. Positive: China recorded more coal arriving than Mongolia recorded leaving",
     "description_mn": "Хятад хасах Монгол. Эерэг бол Хятад Монголын бүртгэснээс илүү нүүрс хүлээж авсан"
    },
    {
     "field": "gap.t_pct",
     "type": "number",
     "unit": "%",
     "description_en": "gap.t as a percentage of Mongolia's figure",
     "description_mn": "gap.t-г Монголын тоонд харьцуулсан хувь"
    },
    {
     "field": "gap.usd / gap.usd_pct",
     "type": "integer / number",
     "unit": "USD / %",
     "description_en": "The same for US dollars",
     "description_mn": "Ам.доллараар мөн адил"
    },
    {
     "field": "unit_value.mn_fob",
     "type": "number",
     "unit": "USD/t",
     "description_en": "Mongolia's export price per tonne (FOB)",
     "description_mn": "Монголын экспортын нэг тонны үнэ (FOB)"
    },
    {
     "field": "unit_value.cn_cif",
     "type": "number",
     "unit": "USD/t",
     "description_en": "China's import price per tonne (CIF)",
     "description_mn": "Хятадын импортын нэг тонны үнэ (CIF)"
    },
    {
     "field": "unit_value.spread",
     "type": "number",
     "unit": "USD/t",
     "description_en": "CIF minus FOB; normally positive because of freight and insurance",
     "description_mn": "CIF хасах FOB; тээвэр, даатгалын улмаас ихэвчлэн эерэг"
    },
    {
     "field": "unit_value.inverted",
     "type": "boolean",
     "unit": "",
     "description_en": "True when China's price is more than 5% below Mongolia's",
     "description_mn": "Хятадын үнэ Монголынхоос 5%-иас илүү бага бол үнэн"
    },
    {
     "field": "comparability",
     "type": "string",
     "unit": "",
     "description_en": "comparable (both customs, same basis), approximate, one_sided, none",
     "description_mn": "comparable (хоёр талын гаалийн тоо), approximate (ойролцоо), one_sided (нэг тал), none"
    },
    {
     "field": "notes",
     "type": "string[]",
     "unit": "",
     "description_en": "Note codes; text in notes.json",
     "description_mn": "Тэмдэглэгээний код; тайлбар notes.json-д"
    }
   ]
  },
  {
   "file": "monthly_mirror.json / .csv",
   "fields": [
    {
     "field": "year / period",
     "type": "integer / string",
     "unit": "",
     "description_en": "Calendar year, or month as YYYY-MM",
     "description_mn": "Он, эсвэл сар (YYYY-MM)"
    },
    {
     "field": "mn.t",
     "type": "integer",
     "unit": "t",
     "description_en": "Mongolia: Tonnes reported by this side",
     "description_mn": "Монгол: Энэ талын мэдээлсэн тонн"
    },
    {
     "field": "mn.usd",
     "type": "integer",
     "unit": "USD",
     "description_en": "Mongolia: US dollars reported by this side (Mongolia FOB, China CIF)",
     "description_mn": "Монгол: Энэ талын мэдээлсэн ам.доллар (Монгол FOB, Хятад CIF)"
    },
    {
     "field": "mn.t_source",
     "type": "string",
     "unit": "",
     "description_en": "Mongolia: Source id the tonnes come from",
     "description_mn": "Монгол: Тонны эх сурвалж"
    },
    {
     "field": "mn.usd_source",
     "type": "string",
     "unit": "",
     "description_en": "Mongolia: Source id the dollars come from",
     "description_mn": "Монгол: Ам.долларын эх сурвалж"
    },
    {
     "field": "mn.basis",
     "type": "string",
     "unit": "",
     "description_en": "Mongolia: hs_partner (customs data by partner), curated_official, curated_press or nso_share_adjusted",
     "description_mn": "Монгол: hs_partner (түнш улсаар), curated_official, curated_press эсвэл nso_share_adjusted"
    },
    {
     "field": "mn.t_source_url",
     "type": "string",
     "unit": "",
     "description_en": "Mongolia: Link to the exact request or publication",
     "description_mn": "Монгол: Тухайн хүсэлт эсвэл нийтлэлийн холбоос"
    },
    {
     "field": "mn.share",
     "type": "number",
     "unit": "ratio",
     "description_en": "China's share applied to Mongolia's all-destination total",
     "description_mn": "Монголын нийт экспортод хэрэглэсэн Хятадын эзлэх хувь"
    },
    {
     "field": "mn.t_low / mn.t_high",
     "type": "integer",
     "unit": "t",
     "description_en": "Range for share-adjusted figures: lowest recent share up to 100% of exports",
     "description_mn": "Хувиар тооцсон тооны хүрээ: сүүлийн жилүүдийн хамгийн бага хувиас 100% хүртэл"
    },
    {
     "field": "mn.alt_t_nso_share_adjusted",
     "type": "integer",
     "unit": "t",
     "description_en": "The share-adjusted NSO figure, shown for comparison when another source was chosen",
     "description_mn": "Өөр эх сурвалж сонгосон үед харьцуулахаар үзүүлсэн ҮСХ-ны хувиар тооцсон тоо"
    },
    {
     "field": "cn.t",
     "type": "integer",
     "unit": "t",
     "description_en": "China: Tonnes reported by this side",
     "description_mn": "Хятад: Энэ талын мэдээлсэн тонн"
    },
    {
     "field": "cn.usd",
     "type": "integer",
     "unit": "USD",
     "description_en": "China: US dollars reported by this side (Mongolia FOB, China CIF)",
     "description_mn": "Хятад: Энэ талын мэдээлсэн ам.доллар (Монгол FOB, Хятад CIF)"
    },
    {
     "field": "cn.t_source",
     "type": "string",
     "unit": "",
     "description_en": "China: Source id the tonnes come from",
     "description_mn": "Хятад: Тонны эх сурвалж"
    },
    {
     "field": "cn.usd_source",
     "type": "string",
     "unit": "",
     "description_en": "China: Source id the dollars come from",
     "description_mn": "Хятад: Ам.долларын эх сурвалж"
    },
    {
     "field": "cn.basis",
     "type": "string",
     "unit": "",
     "description_en": "China: hs_partner (customs data by partner), curated_official, curated_press or nso_share_adjusted",
     "description_mn": "Хятад: hs_partner (түнш улсаар), curated_official, curated_press эсвэл nso_share_adjusted"
    },
    {
     "field": "cn.t_source_url",
     "type": "string",
     "unit": "",
     "description_en": "China: Link to the exact request or publication",
     "description_mn": "Хятад: Тухайн хүсэлт эсвэл нийтлэлийн холбоос"
    },
    {
     "field": "cn.excluded_estimated_t",
     "type": "integer",
     "unit": "t",
     "description_en": "UN Comtrade's estimated weight, shown but never compared",
     "description_mn": "НҮБ-ын Comtrade-ийн тооцоолсон жин; харуулсан ч харьцуулаагүй"
    },
    {
     "field": "gap.t",
     "type": "integer",
     "unit": "t",
     "description_en": "China minus Mongolia. Positive: China recorded more coal arriving than Mongolia recorded leaving",
     "description_mn": "Хятад хасах Монгол. Эерэг бол Хятад Монголын бүртгэснээс илүү нүүрс хүлээж авсан"
    },
    {
     "field": "gap.t_pct",
     "type": "number",
     "unit": "%",
     "description_en": "gap.t as a percentage of Mongolia's figure",
     "description_mn": "gap.t-г Монголын тоонд харьцуулсан хувь"
    },
    {
     "field": "gap.usd / gap.usd_pct",
     "type": "integer / number",
     "unit": "USD / %",
     "description_en": "The same for US dollars",
     "description_mn": "Ам.доллараар мөн адил"
    },
    {
     "field": "unit_value.mn_fob",
     "type": "number",
     "unit": "USD/t",
     "description_en": "Mongolia's export price per tonne (FOB)",
     "description_mn": "Монголын экспортын нэг тонны үнэ (FOB)"
    },
    {
     "field": "unit_value.cn_cif",
     "type": "number",
     "unit": "USD/t",
     "description_en": "China's import price per tonne (CIF)",
     "description_mn": "Хятадын импортын нэг тонны үнэ (CIF)"
    },
    {
     "field": "unit_value.spread",
     "type": "number",
     "unit": "USD/t",
     "description_en": "CIF minus FOB; normally positive because of freight and insurance",
     "description_mn": "CIF хасах FOB; тээвэр, даатгалын улмаас ихэвчлэн эерэг"
    },
    {
     "field": "unit_value.inverted",
     "type": "boolean",
     "unit": "",
     "description_en": "True when China's price is more than 5% below Mongolia's",
     "description_mn": "Хятадын үнэ Монголынхоос 5%-иас илүү бага бол үнэн"
    },
    {
     "field": "comparability",
     "type": "string",
     "unit": "",
     "description_en": "comparable (both customs, same basis), approximate, one_sided, none",
     "description_mn": "comparable (хоёр талын гаалийн тоо), approximate (ойролцоо), one_sided (нэг тал), none"
    },
    {
     "field": "notes",
     "type": "string[]",
     "unit": "",
     "description_en": "Note codes; text in notes.json",
     "description_mn": "Тэмдэглэгээний код; тайлбар notes.json-д"
    },
    {
     "field": "mn.t_ytd / cn.t_ytd",
     "type": "integer",
     "unit": "t",
     "description_en": "Year-to-date totals, when every month is available",
     "description_mn": "Оны эхнээс өссөн дүн, бүх сарын тоо байгаа үед"
    },
    {
     "field": "gap.t_ytd / gap.t_ytd_pct",
     "type": "integer / number",
     "unit": "t / %",
     "description_en": "Year-to-date gap",
     "description_mn": "Оны эхнээс өссөн зөрүү"
    },
    {
     "field": "cn.t_ytd_reported",
     "type": "integer",
     "unit": "t",
     "description_en": "China's reported cumulative figure (January and February are published together)",
     "description_mn": "Хятадын мэдээлсэн өссөн дүн (1, 2 дугаар сарыг хамт мэдээлдэг)"
    },
    {
     "field": "rolling_12m",
     "type": "object",
     "unit": "t",
     "description_en": "12-month totals, when all 12 months are comparable",
     "description_mn": "12 сарын нийлбэр, бүх 12 сар харьцуулах боломжтой үед"
    }
   ]
  },
  {
   "file": "observations.csv / .parquet",
   "fields": [
    {
     "field": "source_id",
     "type": "Literal['comtrade_mn', 'comtrade_cn', 'nso_month', 'nso_year', 'nso_country_year', 'nso_production', 'nso_balance', 'gacc_curated', 'mn_customs_curated', 'mrpam', 'derived']",
     "unit": "",
     "description_en": "Pipeline source identifier",
     "description_mn": ""
    },
    {
     "field": "reporter",
     "type": "Literal['MNG', 'CHN']",
     "unit": "",
     "description_en": "Country whose statistics office reported the figure",
     "description_mn": ""
    },
    {
     "field": "partner",
     "type": "Literal['CHN', 'MNG', 'WLD']",
     "unit": "",
     "description_en": "Trading partner; WLD = all destinations",
     "description_mn": ""
    },
    {
     "field": "flow",
     "type": "<class 'str'>",
     "unit": "",
     "description_en": "X export, M import, production, sales, or a coal-balance item",
     "description_mn": ""
    },
    {
     "field": "commodity",
     "type": "<class 'str'>",
     "unit": "",
     "description_en": "HS code (2701, 2701xx) or 'coal' for national items",
     "description_mn": ""
    },
    {
     "field": "freq",
     "type": "Literal['A', 'M']",
     "unit": "",
     "description_en": "A annual, M monthly",
     "description_mn": ""
    },
    {
     "field": "period",
     "type": "<class 'str'>",
     "unit": "",
     "description_en": "'2022' or '2022-07'",
     "description_mn": ""
    },
    {
     "field": "measure",
     "type": "Literal['weight_t', 'value_usd', 'weight_t_ytd', 'value_usd_ytd']",
     "unit": "",
     "description_en": "weight_t, value_usd, or year-to-date variants",
     "description_mn": ""
    },
    {
     "field": "value",
     "type": "<class 'float'>",
     "unit": "t or USD",
     "description_en": "Tonnes or USD; never null (missing rows are absent)",
     "description_mn": ""
    },
    {
     "field": "unit",
     "type": "Literal['t', 'USD']",
     "unit": "",
     "description_en": "",
     "description_mn": ""
    },
    {
     "field": "valuation",
     "type": "Literal['FOB', 'CIF'] | None",
     "unit": "",
     "description_en": "Value rows only: exports FOB, imports CIF",
     "description_mn": ""
    },
    {
     "field": "year",
     "type": "<class 'int'>",
     "unit": "",
     "description_en": "",
     "description_mn": ""
    },
    {
     "field": "month",
     "type": "int | None",
     "unit": "",
     "description_en": "",
     "description_mn": ""
    },
    {
     "field": "is_estimated",
     "type": "<class 'bool'>",
     "unit": "",
     "description_en": "UN Comtrade estimated the quantity or net weight",
     "description_mn": ""
    },
    {
     "field": "is_aggregate",
     "type": "<class 'bool'>",
     "unit": "",
     "description_en": "UN Comtrade isAggregate flag",
     "description_mn": ""
    },
    {
     "field": "is_cumulative_derived",
     "type": "<class 'bool'>",
     "unit": "",
     "description_en": "Monthly value derived as a difference of year-to-date totals",
     "description_mn": ""
    },
    {
     "field": "is_curated",
     "type": "<class 'bool'>",
     "unit": "",
     "description_en": "Hand-entered from a cited publication",
     "description_mn": ""
    },
    {
     "field": "is_share_adjusted",
     "type": "<class 'bool'>",
     "unit": "",
     "description_en": "All-destination total multiplied by China's share",
     "description_mn": ""
    },
    {
     "field": "confidence",
     "type": "Literal['official', 'press', 'derived']",
     "unit": "",
     "description_en": "",
     "description_mn": ""
    },
    {
     "field": "derivation_note",
     "type": "str | None",
     "unit": "",
     "description_en": "",
     "description_mn": ""
    },
    {
     "field": "source_table",
     "type": "str | None",
     "unit": "",
     "description_en": "",
     "description_mn": ""
    },
    {
     "field": "source_url",
     "type": "<class 'str'>",
     "unit": "",
     "description_en": "",
     "description_mn": ""
    },
    {
     "field": "raw_file",
     "type": "str | None",
     "unit": "",
     "description_en": "",
     "description_mn": ""
    },
    {
     "field": "retrieved_at",
     "type": "<class 'str'>",
     "unit": "",
     "description_en": "",
     "description_mn": ""
    },
    {
     "field": "source_updated_at",
     "type": "str | None",
     "unit": "",
     "description_en": "",
     "description_mn": ""
    },
    {
     "field": "vintage",
     "type": "<class 'str'>",
     "unit": "",
     "description_en": "",
     "description_mn": ""
    },
    {
     "field": "citation",
     "type": "str | None",
     "unit": "",
     "description_en": "",
     "description_mn": ""
    }
   ]
  }
 ]
}