China Trade & Market Data

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['period', 'commodity', 'flow'], 'properties': {'flow': {'enum': ['IMPORT', 'EXPORT'], 'type': 'string', 'description': 'China trade direction: IMPORT or EXPORT. Required.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Maximum number of records returned. Integer 1–100; default 20. A page may contain fewer records.'}, 'metric': {'type': 'string', 'maxLength': 256, 'minLength': 1, '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.'}, 'offset': {'type': 'integer', 'maximum': 999, 'minimum': 0, 'description': 'Zero-based pagination offset. Integer 0–999; default 0. Offsets of 1000 or greater are rejected. Use the returned next_offset when present.'}, 'period': {'type': 'string', 'maxLength': 256, 'minLength': 1, '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.'}, 'snapshot': {'type': 'string', 'maxLength': 256, 'minLength': 1, '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.'}, 'commodity': {'type': 'string', 'maxLength': 256, 'minLength': 1, '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.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['period', 'country'], 'properties': {'flow': {'enum': ['IMPORT', 'EXPORT', 'BOTH'], 'type': 'string', 'description': 'China trade direction: IMPORT or EXPORT or BOTH (recorded combined total). Optional; omission includes collected directions.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Maximum number of records returned. Integer 1–100; default 20. A page may contain fewer records.'}, 'offset': {'type': 'integer', 'maximum': 999, 'minimum': 0, 'description': 'Zero-based pagination offset. Integer 0–999; default 0. Offsets of 1000 or greater are rejected. Use the returned next_offset when present.'}, 'period': {'type': 'string', 'maxLength': 256, 'minLength': 1, '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', 'maxLength': 256, 'minLength': 1, '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.'}, 'snapshot': {'type': 'string', 'maxLength': 256, 'minLength': 1, '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.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['year'], 'properties': {'year': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, '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.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Maximum number of records returned. Integer 1–100; default 20. A page may contain fewer records.'}, 'metric': {'type': 'string', 'maxLength': 256, 'minLength': 1, '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.'}, 'offset': {'type': 'integer', 'maximum': 999, 'minimum': 0, 'description': 'Zero-based pagination offset. Integer 0–999; default 0. Offsets of 1000 or greater are rejected. Use the returned next_offset when present.'}, 'country': {'type': 'string', 'maxLength': 256, 'minLength': 1, '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.'}, 'snapshot': {'type': 'string', 'maxLength': 256, 'minLength': 1, '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.'}}, 'additionalProperties': False}

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

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['period'], 'properties': {'flow': {'type': 'string', 'maxLength': 256, 'minLength': 1, '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.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Maximum number of records returned. Integer 1–100; default 20. A page may contain fewer records.'}, 'metric': {'type': 'string', 'maxLength': 256, 'minLength': 1, 'description': 'Recorded metric trade_value; country workbook unit is 亿美元, China–Portuguese-speaking-partner unit is 万美元. No unit conversion. Optional.'}, 'offset': {'type': 'integer', 'maximum': 999, 'minimum': 0, 'description': 'Zero-based pagination offset. Integer 0–999; default 0. Offsets of 1000 or greater are rejected. Use the returned next_offset when present.'}, 'period': {'type': 'string', 'maxLength': 256, 'minLength': 1, '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', 'maxLength': 256, 'minLength': 1, '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.'}, 'snapshot': {'type': 'string', 'maxLength': 256, 'minLength': 1, '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.'}}, 'additionalProperties': False}