China Trade & Market Data

Find foreign-investment observations for a statistical year, optionally filtered by country or measure. Inputs: year, country, metric. Returns paginated structured records with source_class, provenance, snapshot, pagination and limits. Recorded facts only; this query performs no new inference or aggregation. Coverage is limited to the available snapshot. No match returns an empty data array. Required: year. Missing required or invalid input produces an argument error.

{
  "type": "object",
  "properties": {
    "year": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Recorded statistical year as an integer; this is not the publication year. Exact match. Non-negative integer within the server integer range. Required. Supplied filters are combined with AND."
    },
    "country": {
      "description": "Country or region label exactly as recorded; no country-code or alias conversion. Exact match. Non-empty string, at most 256 characters; control characters are not accepted. Optional; omitted means no filter on this field. Supplied filters are combined with AND.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    },
    "metric": {
      "description": "Statistical measure label exactly as recorded; no unit conversion or aggregation. Exact match. Non-empty string, at most 256 characters; control characters are not accepted. Optional; omitted means no filter on this field. Supplied filters are combined with AND.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    },
    "limit": {
      "description": "Maximum number of records returned. Integer 1–100; default 20. A page may contain fewer records.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "description": "Zero-based pagination offset. Integer 0–999; default 0. Offsets of 1000 or greater are rejected. Use the returned next_offset when present.",
      "type": "integer",
      "minimum": 0,
      "maximum": 999
    },
    "snapshot": {
      "description": "Optional expected snapshot.version, not a historical-version selector. If omitted, the current dataset snapshot is used. For continued pagination reuse the previous response snapshot.version; a mismatch is rejected.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    }
  },
  "required": [
    "year"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Query collected country-workbook trade observations (flows relative to the named reporting country) or China–Portuguese-speaking-country bilateral year-to-date observations. Inputs: period and optional country, flow and metric. This collection is not China national all-partner monthly totals. Returns original structured observations, units, scope, source_class, provenance, snapshot, pagination and limits. No conversion, aggregation or cross-period calculation. No match returns an empty data array. Required: period. Missing required or invalid input produces an argument error.

{
  "type": "object",
  "properties": {
    "period": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "Recorded statistical period: YYYY-MM for a single month, or YYYY-01/YYYY-MM for January-to-month cumulative observations. Exact collected period; these periods are not interchangeable. A snapshot identifies the dataset version, not a selectable statistical period. Required."
    },
    "country": {
      "description": "Reporting country in country workbooks, or China bilateral partner in Portuguese-speaking-country observations; returned scope distinguishes them. Exact recorded name or a documented one-to-one alias. Optional.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    },
    "flow": {
      "description": "Flow relative to the named reporting country for COUNTRY_WORKBOOK_AS_REPORTED; China flow relative to the named partner for CHINA_PORTUGUESE_COUNTRIES_YTD. Recorded values IMPORT, EXPORT or BOTH; scope remains in each fact. Optional.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    },
    "metric": {
      "description": "Recorded metric trade_value; country workbook unit is 亿美元, China–Portuguese-speaking-partner unit is 万美元. No unit conversion. Optional.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    },
    "limit": {
      "description": "Maximum number of records returned. Integer 1–100; default 20. A page may contain fewer records.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "description": "Zero-based pagination offset. Integer 0–999; default 0. Offsets of 1000 or greater are rejected. Use the returned next_offset when present.",
      "type": "integer",
      "minimum": 0,
      "maximum": 999
    },
    "snapshot": {
      "description": "Optional expected snapshot.version, not a historical-version selector. If omitted, the current dataset snapshot is used. For continued pagination reuse the previous response snapshot.version; a mismatch is rejected.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    }
  },
  "required": [
    "period"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Query China merchandise trade by partner country/region, including all-partner totals using country TOTAL. Inputs: period, country and optional flow. IMPORT and EXPORT are China imports and exports; BOTH is recorded combined trade. Returns recorded trade values and units (currently 1000USD), scope, source_class, provenance, snapshot, pagination and limits. No commodity filter or currency conversion. No match returns an empty data array. Required: period, country. Missing required or invalid input produces an argument error.

{
  "type": "object",
  "properties": {
    "period": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "Recorded statistical period: YYYY-MM for a single month, or YYYY-01/YYYY-MM for January-to-month cumulative observations. Exact collected period; these periods are not interchangeable. A snapshot identifies the dataset version, not a selectable statistical period. Required."
    },
    "country": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "China trade partner country/region, or TOTAL for all partners. TOTAL is an aggregate, not an alias for China. Exact recorded name or selected one-to-one alias; original labels remain in output. Required."
    },
    "flow": {
      "description": "China trade direction: IMPORT or EXPORT or BOTH (recorded combined total). Optional; omission includes collected directions.",
      "type": "string",
      "enum": [
        "IMPORT",
        "EXPORT",
        "BOTH"
      ]
    },
    "limit": {
      "description": "Maximum number of records returned. Integer 1–100; default 20. A page may contain fewer records.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "description": "Zero-based pagination offset. Integer 0–999; default 0. Offsets of 1000 or greater are rejected. Use the returned next_offset when present.",
      "type": "integer",
      "minimum": 0,
      "maximum": 999
    },
    "snapshot": {
      "description": "Optional expected snapshot.version, not a historical-version selector. If omitted, the current dataset snapshot is used. For continued pagination reuse the previous response snapshot.version; a mismatch is rejected.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    }
  },
  "required": [
    "period",
    "country"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Query China import or export observations by recorded major-commodity label. Inputs: period, commodity, flow and optional metric. Selected exact Chinese aliases and normalized existing names are supported; this is not general translation or HS-code classification. Returns trade_value or quantity observations with original commodity labels, units, scope, source_class, provenance, snapshot, pagination and limits. No category merging or conversion. No match returns an empty data array. Required: period, commodity, flow. Missing required or invalid input produces an argument error.

{
  "type": "object",
  "properties": {
    "period": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "Recorded statistical period: YYYY-MM for a single month, or YYYY-01/YYYY-MM for January-to-month cumulative observations. Exact collected period; these periods are not interchangeable. A snapshot identifies the dataset version, not a selectable statistical period. Required."
    },
    "commodity": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "Recorded major-commodity name or a selected exact Chinese alias. Existing literal substring matching remains; known aliases resolve only to their exact canonical label. NFKC, leading/trailing spaces and letter case are normalized for known names. No fuzzy translation, HS mapping or broader/narrower category expansion. Required."
    },
    "flow": {
      "type": "string",
      "enum": [
        "IMPORT",
        "EXPORT"
      ],
      "description": "China trade direction: IMPORT or EXPORT. Required."
    },
    "metric": {
      "description": "Recorded metric trade_value or quantity. trade_value currently uses 1000USD; quantity units vary by commodity and are returned unchanged. Optional; omission includes both collected metrics.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    },
    "limit": {
      "description": "Maximum number of records returned. Integer 1–100; default 20. A page may contain fewer records.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "description": "Zero-based pagination offset. Integer 0–999; default 0. Offsets of 1000 or greater are rejected. Use the returned next_offset when present.",
      "type": "integer",
      "minimum": 0,
      "maximum": 999
    },
    "snapshot": {
      "description": "Optional expected snapshot.version, not a historical-version selector. If omitted, the current dataset snapshot is used. For continued pagination reuse the previous response snapshot.version; a mismatch is rejected.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    }
  },
  "required": [
    "period",
    "commodity",
    "flow"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Retrieve definitions of information formation classes, provenance fields and snapshot/version metadata. Takes no arguments. Returns the information-standard document, not business records or an assessment of facts.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}