Raw schema
{
"type": "object",
"properties": {
"panel_request": {
"type": "string",
"maxLength": 160,
"description": "Server-issued paid country-panel request token. Only the embedded country view supplies this."
},
"section": {
"type": "string",
"enum": [
"countrySignals",
"signalsRaw",
"flights",
"vessels",
"fleet",
"facts",
"energy",
"maritime",
"risk",
"stock",
"food",
"demographics",
"resilience",
"factors",
"debt",
"flows",
"tariffs",
"products",
"commodities",
"exposure",
"dependency",
"bypass",
"chokepoints",
"cost",
"pipelines",
"facilities",
"shortages",
"pipelineDetail",
"facilityDetail",
"shortageDetail",
"disruptions",
"scenario",
"defense",
"no2",
"markets",
"china",
"production",
"housing",
"imf"
],
"description": "Which of the 39 fixed readers to run; each oneOf branch below documents one. signalsRaw requires a verified paid country-panel receipt and a matching arguments.country_code."
},
"arguments": {
"type": "object",
"additionalProperties": {
"type": [
"string",
"number",
"boolean"
]
},
"description": "Arguments for the chosen section, as the matching oneOf branch defines them (key names differ per section and unknown keys are rejected). Omit for sections that take none."
},
"jmespath": {
"type": "string",
"description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
}
},
"required": [
"section"
],
"oneOf": [
{
"properties": {
"section": {
"const": "countrySignals",
"description": "One bounded country-qualified source family or eligible flight page. Requires a verified same-country panel."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"country_code": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "Uppercase ISO 3166-1 alpha-2 country code, e.g. \"DE\"."
},
"family": {
"type": "string",
"enum": [
"COUNTRY_SIGNAL_FAMILY_OUTAGES",
"COUNTRY_SIGNAL_FAMILY_UNREST",
"COUNTRY_SIGNAL_FAMILY_FIRES",
"COUNTRY_SIGNAL_FAMILY_RADIATION",
"COUNTRY_SIGNAL_FAMILY_SANCTIONS",
"COUNTRY_SIGNAL_FAMILY_CONFLICT",
"COUNTRY_SIGNAL_FAMILY_POSTURE",
"COUNTRY_SIGNAL_FAMILY_FLIGHT_PAGE"
],
"description": "Fixed source family enum; one source per request."
},
"window_index": {
"default": 0,
"type": "integer",
"minimum": 0,
"maximum": 1,
"description": "Country-derived flight window index, 0 or 1; otherwise 0."
},
"cursor": {
"default": "",
"type": "string",
"maxLength": 200,
"description": "Prior eligible flight page cursor, at most 200 characters; otherwise empty."
}
},
"required": [
"country_code",
"family"
],
"additionalProperties": false,
"description": "Arguments for the countrySignals section."
}
},
"required": [
"arguments"
]
},
{
"properties": {
"section": {
"const": "signalsRaw",
"description": "Attributed raw signal samples for one country: earthquakes, Internet outages, travel advisories and thermal escalations, each with scope, snapshot time and attribution. Needs a verified same-country paid panel token."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"country_code": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "Uppercase ISO 3166-1 alpha-2 country code, e.g. \"DE\". Must equal the country of the verified panel token."
}
},
"required": [
"country_code"
],
"additionalProperties": false,
"description": "Arguments for the signalsRaw section."
}
},
"required": [
"arguments"
]
},
{
"properties": {
"section": {
"const": "flights",
"description": "Military flight observations inside a bounding box, 100 per page, with provider attribution."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"ne_lat": {
"default": 0,
"type": "number",
"minimum": -90,
"maximum": 90,
"description": "North-east corner latitude of the bounding box in degrees (-90 to 90)."
},
"ne_lon": {
"default": 0,
"type": "number",
"minimum": -180,
"maximum": 180,
"description": "North-east corner longitude of the bounding box in degrees (-180 to 180)."
},
"sw_lat": {
"default": 0,
"type": "number",
"minimum": -90,
"maximum": 90,
"description": "South-west corner latitude of the bounding box in degrees (-90 to 90)."
},
"sw_lon": {
"default": 0,
"type": "number",
"minimum": -180,
"maximum": 180,
"description": "South-west corner longitude of the bounding box in degrees (-180 to 180)."
},
"page_size": {
"default": 100,
"type": "integer",
"minimum": 100,
"maximum": 100,
"description": "Fixed page size of 100 rows."
},
"operator": {
"default": "MILITARY_OPERATOR_UNSPECIFIED",
"type": "string",
"const": "MILITARY_OPERATOR_UNSPECIFIED",
"description": "Fixed to the unspecified operator filter; no operator narrowing is available."
},
"aircraft_type": {
"default": "MILITARY_AIRCRAFT_TYPE_UNSPECIFIED",
"type": "string",
"const": "MILITARY_AIRCRAFT_TYPE_UNSPECIFIED",
"description": "Fixed to the unspecified aircraft-type filter; no type narrowing is available."
},
"cursor": {
"default": "",
"type": "string",
"maxLength": 200,
"description": "Opaque cursor from the previous page's pagination block; empty string for the first page."
}
},
"additionalProperties": false,
"description": "Arguments for the flights section."
}
}
},
{
"properties": {
"section": {
"const": "vessels",
"description": "Live AIS vessel snapshot with connection status, snapshot time, density zones and disruptions; unavailable when the snapshot is older than one hour."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"ne_lat": {
"default": 0,
"type": "number",
"description": "Fixed to 0: the reader returns the global snapshot rather than a box query."
},
"ne_lon": {
"default": 0,
"type": "number",
"description": "Fixed to 0: the reader returns the global snapshot rather than a box query."
},
"sw_lat": {
"default": 0,
"type": "number",
"description": "Fixed to 0: the reader returns the global snapshot rather than a box query."
},
"sw_lon": {
"default": 0,
"type": "number",
"description": "Fixed to 0: the reader returns the global snapshot rather than a box query."
},
"include_candidates": {
"default": "true",
"type": "string",
"const": "true",
"description": "Fixed to \"true\": candidate vessel matches are included in the snapshot."
}
},
"additionalProperties": false,
"description": "Arguments for the vessels section."
}
}
},
{
"properties": {
"section": {
"const": "fleet",
"description": "The latest USNI fleet and marine tracker report; takes no arguments."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {},
"additionalProperties": false,
"description": "Arguments for the fleet section."
}
}
},
{
"properties": {
"section": {
"const": "facts",
"description": "Reference facts about the country."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"country_code": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "Uppercase ISO 3166-1 alpha-2 country code, e.g. \"DE\"."
}
},
"required": [
"country_code"
],
"additionalProperties": false,
"description": "Arguments for the facts section."
}
},
"required": [
"arguments"
]
},
{
"properties": {
"section": {
"const": "energy",
"description": "The country's energy profile."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"country_code": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "Uppercase ISO 3166-1 alpha-2 country code, e.g. \"DE\"."
}
},
"required": [
"country_code"
],
"additionalProperties": false,
"description": "Arguments for the energy section."
}
},
"required": [
"arguments"
]
},
{
"properties": {
"section": {
"const": "maritime",
"description": "Port activity for the country's monitored ports."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"country_code": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "Uppercase ISO 3166-1 alpha-2 country code, e.g. \"DE\"."
}
},
"required": [
"country_code"
],
"additionalProperties": false,
"description": "Arguments for the maritime section."
}
},
"required": [
"arguments"
]
},
{
"properties": {
"section": {
"const": "risk",
"description": "Country risk: Composite Instability Index with components, travel-advisory level and sanctions exposure."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"country_code": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "Uppercase ISO 3166-1 alpha-2 country code, e.g. \"DE\"."
}
},
"required": [
"country_code"
],
"additionalProperties": false,
"description": "Arguments for the risk section."
}
},
"required": [
"arguments"
]
},
{
"properties": {
"section": {
"const": "stock",
"description": "The country's benchmark stock index quote."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"country_code": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "Uppercase ISO 3166-1 alpha-2 country code, e.g. \"DE\"."
}
},
"required": [
"country_code"
],
"additionalProperties": false,
"description": "Arguments for the stock section."
}
},
"required": [
"arguments"
]
},
{
"properties": {
"section": {
"const": "food",
"description": "Food stock observations for one country or the WORLD aggregate, optionally narrowed to one commodity."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"countryCode": {
"type": "string",
"pattern": "^(?:[A-Z]{2}|WORLD)$",
"description": "Uppercase ISO 3166-1 alpha-2 code, or WORLD for the global aggregate."
},
"commodity": {
"default": "",
"type": "string",
"maxLength": 40,
"description": "Commodity name to narrow to, up to 40 characters; empty string for every commodity."
}
},
"required": [
"countryCode"
],
"additionalProperties": false,
"description": "Arguments for the food section."
}
},
"required": [
"arguments"
]
},
{
"properties": {
"section": {
"const": "demographics",
"description": "Demographic capability observations: age structure, education and industrial workforce."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"countryCode": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "Uppercase ISO 3166-1 alpha-2 country code, e.g. \"DE\"."
}
},
"required": [
"countryCode"
],
"additionalProperties": false,
"description": "Arguments for the demographics section."
}
},
"required": [
"arguments"
]
},
{
"properties": {
"section": {
"const": "resilience",
"description": "The country's resilience score with its domain breakdown."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"countryCode": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "Uppercase ISO 3166-1 alpha-2 country code, e.g. \"DE\"."
}
},
"required": [
"countryCode"
],
"additionalProperties": false,
"description": "Arguments for the resilience section."
}
},
"required": [
"arguments"
]
},
{
"properties": {
"section": {
"const": "factors",
"description": "The five-factor scorecard with provenance and raw observations."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"countryCode": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "Uppercase ISO 3166-1 alpha-2 country code, e.g. \"DE\"."
}
},
"required": [
"countryCode"
],
"additionalProperties": false,
"description": "Arguments for the factors section."
}
},
"required": [
"arguments"
]
},
{
"properties": {
"section": {
"const": "debt",
"description": "National debt levels for every country; takes no arguments."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {},
"additionalProperties": false,
"description": "Arguments for the debt section."
}
}
},
{
"properties": {
"section": {
"const": "flows",
"description": "UN COMTRADE trade flows reported by one country, optionally narrowed to one commodity or to anomalies."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"reporter_code": {
"type": "string",
"pattern": "^\\d{1,3}$",
"description": "UN M49 numeric country code with 1-3 digits, e.g. \"840\" for the United States."
},
"cmd_code": {
"default": "",
"type": "string",
"pattern": "^\\d{0,6}$",
"description": "HS commodity code of up to 6 digits; empty string for every commodity."
},
"anomalies_only": {
"default": "false",
"type": "string",
"enum": [
"true",
"false"
],
"description": "\"true\" keeps only flows flagged as anomalous; \"false\" (default) returns every flow."
}
},
"required": [
"reporter_code"
],
"additionalProperties": false,
"description": "Arguments for the flows section."
}
},
"required": [
"arguments"
]
},
{
"properties": {
"section": {
"const": "tariffs",
"description": "Applied tariff trend series for one reporting country."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"reporting_country": {
"type": "string",
"pattern": "^\\d{1,3}$",
"description": "UN M49 numeric country code with 1-3 digits, e.g. \"840\" for the United States."
},
"product_sector": {
"default": "",
"type": "string",
"maxLength": 20,
"description": "Product sector code of up to 20 characters; empty string for all products."
},
"years": {
"default": 10,
"type": "integer",
"minimum": 1,
"maximum": 10,
"description": "Trailing years of history to return, 1-10 (default 10)."
},
"partner_country": {
"default": "",
"type": "string",
"pattern": "^\\d{0,3}$",
"description": "UN M49 numeric partner code; empty string for all partners."
}
},
"required": [
"reporting_country"
],
"additionalProperties": false,
"description": "Arguments for the tariffs section."
}
},
"required": [
"arguments"
]
},
{
"properties": {
"section": {
"const": "products",
"description": "The country's supply-chain product profile, optionally narrowed to one HS heading."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"iso2": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "Uppercase ISO 3166-1 alpha-2 country code, e.g. \"DE\"."
},
"hs4": {
"type": "string",
"pattern": "^\\d{4}$",
"description": "Optional 4-digit HS heading to narrow to one product group."
}
},
"required": [
"iso2"
],
"additionalProperties": false,
"description": "Arguments for the products section."
}
},
"required": [
"arguments"
]
},
{
"properties": {
"section": {
"const": "commodities",
"description": "Commodity supply vulnerabilities for the country."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"iso2": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "Uppercase ISO 3166-1 alpha-2 country code, e.g. \"DE\"."
}
},
"required": [
"iso2"
],
"additionalProperties": false,
"description": "Arguments for the commodities section."
}
},
"required": [
"arguments"
]
},
{
"properties": {
"section": {
"const": "exposure",
"description": "Chokepoint exposure index for one country and HS chapter."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"iso2": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "Uppercase ISO 3166-1 alpha-2 country code, e.g. \"DE\"."
},
"hs2": {
"type": "string",
"enum": [
"10",
"27",
"29",
"30",
"39",
"62",
"72",
"84",
"85",
"87"
],
"description": "Two-digit HS chapter: 10 cereals, 27 fuels, 29 organic chemicals, 30 pharmaceuticals, 39 plastics, 62 apparel, 72 iron and steel, 84 machinery, 85 electrical equipment, 87 vehicles."
}
},
"required": [
"iso2",
"hs2"
],
"additionalProperties": false,
"description": "Arguments for the exposure section."
}
},
"required": [
"arguments"
]
},
{
"properties": {
"section": {
"const": "dependency",
"description": "Sector dependency on maritime chokepoints for one country and HS chapter."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"iso2": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "Uppercase ISO 3166-1 alpha-2 country code, e.g. \"DE\"."
},
"hs2": {
"type": "string",
"enum": [
"10",
"27",
"29",
"30",
"39",
"62",
"72",
"84",
"85",
"87"
],
"description": "Two-digit HS chapter: 10 cereals, 27 fuels, 29 organic chemicals, 30 pharmaceuticals, 39 plastics, 62 apparel, 72 iron and steel, 84 machinery, 85 electrical equipment, 87 vehicles."
}
},
"required": [
"iso2",
"hs2"
],
"additionalProperties": false,
"description": "Arguments for the dependency section."
}
},
"required": [
"arguments"
]
},
{
"properties": {
"section": {
"const": "bypass",
"description": "Rerouting options when one chokepoint closes, by cargo type and closure share."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"chokepointId": {
"type": "string",
"pattern": "^[a-z0-9_-]{1,80}$",
"description": "Chokepoint registry id as a lowercase slug, e.g. \"hormuz_strait\"."
},
"cargoType": {
"default": "container",
"type": "string",
"enum": [
"container",
"tanker",
"bulk"
],
"description": "Cargo type: container (default), tanker or bulk."
},
"closurePct": {
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 100,
"description": "Share of the chokepoint closed, 0-100 percent (default 0)."
}
},
"required": [
"chokepointId"
],
"additionalProperties": false,
"description": "Arguments for the bypass section."
}
},
"required": [
"arguments"
]
},
{
"properties": {
"section": {
"const": "chokepoints",
"description": "Current status of every monitored chokepoint; takes no arguments."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {},
"additionalProperties": false,
"description": "Arguments for the chokepoints section."
}
}
},
{
"properties": {
"section": {
"const": "cost",
"description": "Multi-sector cost shock for one country from a chokepoint closure of a given length."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"iso2": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "Uppercase ISO 3166-1 alpha-2 country code, e.g. \"DE\"."
},
"chokepointId": {
"type": "string",
"pattern": "^[a-z0-9_-]{1,80}$",
"description": "Chokepoint registry id as a lowercase slug, e.g. \"hormuz_strait\"."
},
"closureDays": {
"default": 30,
"type": "integer",
"minimum": 1,
"maximum": 365,
"description": "Closure length in days, 1-365 (default 30)."
}
},
"required": [
"iso2",
"chokepointId"
],
"additionalProperties": false,
"description": "Arguments for the cost section."
}
},
"required": [
"arguments"
]
},
{
"properties": {
"section": {
"const": "pipelines",
"description": "The pipeline registry."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"commodityType": {
"default": "",
"type": "string",
"const": "",
"description": "Fixed to the empty string: this reader returns every value and accepts no narrowing."
}
},
"additionalProperties": false,
"description": "Arguments for the pipelines section."
}
}
},
{
"properties": {
"section": {
"const": "facilities",
"description": "The energy storage facility registry."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"facilityType": {
"default": "",
"type": "string",
"const": "",
"description": "Fixed to the empty string: this reader returns every value and accepts no narrowing."
}
},
"additionalProperties": false,
"description": "Arguments for the facilities section."
}
}
},
{
"properties": {
"section": {
"const": "shortages",
"description": "Current fuel shortages."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"country": {
"default": "",
"type": "string",
"const": "",
"description": "Fixed to the empty string: this reader returns every value and accepts no narrowing."
},
"product": {
"default": "",
"type": "string",
"const": "",
"description": "Fixed to the empty string: this reader returns every value and accepts no narrowing."
},
"severity": {
"default": "",
"type": "string",
"const": "",
"description": "Fixed to the empty string: this reader returns every value and accepts no narrowing."
}
},
"additionalProperties": false,
"description": "Arguments for the shortages section."
}
}
},
{
"properties": {
"section": {
"const": "pipelineDetail",
"description": "One pipeline's detail; unavailable when the pipeline does not originate in, end in or transit the country."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"country_code": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "Uppercase ISO 3166-1 alpha-2 country code, e.g. \"DE\". The pipeline must originate in, end in or transit this country."
},
"pipelineId": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,100}$",
"description": "Pipeline id as listed by the pipelines section."
}
},
"required": [
"country_code",
"pipelineId"
],
"additionalProperties": false,
"description": "Arguments for the pipelineDetail section."
}
},
"required": [
"arguments"
]
},
{
"properties": {
"section": {
"const": "facilityDetail",
"description": "One storage facility's detail; unavailable when the facility is not in the country."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"country_code": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "Uppercase ISO 3166-1 alpha-2 country code, e.g. \"DE\". The facility must be located in this country."
},
"facilityId": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,100}$",
"description": "Facility id as listed by the facilities section."
}
},
"required": [
"country_code",
"facilityId"
],
"additionalProperties": false,
"description": "Arguments for the facilityDetail section."
}
},
"required": [
"arguments"
]
},
{
"properties": {
"section": {
"const": "shortageDetail",
"description": "One fuel shortage's detail; unavailable when the shortage is not in the country."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"country_code": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "Uppercase ISO 3166-1 alpha-2 country code, e.g. \"DE\". The shortage must be located in this country."
},
"shortageId": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,100}$",
"description": "Shortage id as listed by the shortages section."
}
},
"required": [
"country_code",
"shortageId"
],
"additionalProperties": false,
"description": "Arguments for the shortageDetail section."
}
},
"required": [
"arguments"
]
},
{
"properties": {
"section": {
"const": "disruptions",
"description": "Energy disruption events, optionally only those still ongoing."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"assetId": {
"default": "",
"type": "string",
"const": "",
"description": "Fixed to the empty string: this reader returns every value and accepts no narrowing."
},
"assetType": {
"default": "",
"type": "string",
"const": "",
"description": "Fixed to the empty string: this reader returns every value and accepts no narrowing."
},
"ongoingOnly": {
"default": "false",
"type": "string",
"enum": [
"true",
"false"
],
"description": "\"true\" keeps only disruptions still ongoing; \"false\" (default) includes resolved ones."
}
},
"additionalProperties": false,
"description": "Arguments for the disruptions section."
}
}
},
{
"properties": {
"section": {
"const": "scenario",
"description": "Energy supply shock scenario for one country and chokepoint at a chosen disruption share and fuel."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"country_code": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "Uppercase ISO 3166-1 alpha-2 country code, e.g. \"DE\"."
},
"chokepoint_id": {
"type": "string",
"pattern": "^[a-z0-9_-]{1,80}$",
"description": "Chokepoint registry id as a lowercase slug, e.g. \"hormuz_strait\"."
},
"disruption_pct": {
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 100,
"description": "Share of the chokepoint flow disrupted, 0-100 percent (default 0)."
},
"fuel_mode": {
"default": "oil",
"type": "string",
"enum": [
"both",
"oil",
"gas"
],
"description": "Fuel scope: oil (default), gas or both."
}
},
"required": [
"country_code",
"chokepoint_id"
],
"additionalProperties": false,
"description": "Arguments for the scenario section."
}
},
"required": [
"arguments"
]
},
{
"properties": {
"section": {
"const": "defense",
"description": "Defense industrial base indicators and arms-supplier shares for the country."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"country_code": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "Uppercase ISO 3166-1 alpha-2 country code, e.g. \"DE\"."
}
},
"required": [
"country_code"
],
"additionalProperties": false,
"description": "Arguments for the defense section."
}
},
"required": [
"arguments"
]
},
{
"properties": {
"section": {
"const": "no2",
"description": "Sentinel-5P NO2 industrial activity direction for the country against the same window in prior years, with the Copernicus credit."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"country_code": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "Uppercase ISO 3166-1 alpha-2 country code, e.g. \"DE\"."
},
"kind": {
"default": "NO2_REGION_KIND_COUNTRY",
"type": "string",
"const": "NO2_REGION_KIND_COUNTRY",
"description": "Fixed to NO2_REGION_KIND_COUNTRY: this reader returns the country region only."
}
},
"required": [
"country_code"
],
"additionalProperties": false,
"description": "Arguments for the no2 section."
}
},
"required": [
"arguments"
]
},
{
"properties": {
"section": {
"const": "markets",
"description": "Prediction markets list with optional title and category narrowing."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"page_size": {
"default": 50,
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Markets per page, 1-100 (default 50)."
},
"query": {
"default": "",
"type": "string",
"maxLength": 100,
"description": "Case-insensitive title substring, up to 100 characters; empty string for every market."
},
"category": {
"default": "",
"type": "string",
"maxLength": 40,
"description": "Category bucket name, up to 40 characters; empty string for every category."
},
"cursor": {
"default": "",
"type": "string",
"const": "",
"description": "Fixed to the empty string: only the first page is readable here."
}
},
"additionalProperties": false,
"description": "Arguments for the markets section."
}
}
},
{
"properties": {
"section": {
"const": "china",
"description": "China decision signals; takes no arguments."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {},
"additionalProperties": false,
"description": "Arguments for the china section."
}
}
},
{
"properties": {
"section": {
"const": "production",
"description": "Mine and refinery production for one commodity across countries and stages."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"commodity": {
"type": "string",
"pattern": "^[a-z0-9-]{1,60}$",
"description": "Commodity slug in lowercase, e.g. \"copper\"."
},
"iso2": {
"default": "",
"type": "string",
"const": "",
"description": "Fixed to the empty string: this reader returns every value and accepts no narrowing."
},
"stage": {
"default": "",
"type": "string",
"const": "",
"description": "Fixed to the empty string: this reader returns every value and accepts no narrowing."
}
},
"required": [
"commodity"
],
"additionalProperties": false,
"description": "Arguments for the production section."
}
},
"required": [
"arguments"
]
},
{
"properties": {
"section": {
"const": "housing",
"description": "BIS housing datasets: debt-service ratio and residential and commercial property prices."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"keys": {
"type": "string",
"const": "bisDsr,bisPropertyResidential,bisPropertyCommercial",
"description": "Fixed list of the bootstrap keys this reader fetches."
}
},
"required": [
"keys"
],
"additionalProperties": false,
"description": "Arguments for the housing section."
}
},
"required": [
"arguments"
]
},
{
"properties": {
"section": {
"const": "imf",
"description": "IMF macro datasets: macro, growth, labor and external accounts."
},
"arguments": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"keys": {
"type": "string",
"const": "imfMacro,imfGrowth,imfLabor,imfExternal",
"description": "Fixed list of the bootstrap keys this reader fetches."
}
},
"required": [
"keys"
],
"additionalProperties": false,
"description": "Arguments for the imf section."
}
},
"required": [
"arguments"
]
}
]
}