{"openapi":"3.1.1","info":{"title":"datasteg API","version":"20261110.1","summary":"Read-only economic data and explainers from the datasteg apps.","description":"Every answer names its release, sources and period and links the page it mirrors. The API returns what the pages show: derived views, at most one page or chart per call, no raw source series and no bulk downloads. Each source's terms apply to its data.","contact":{"name":"datasteg","url":"https://www.datasteg.com/en/technology/api"},"license":{"name":"Each source's terms apply; see meta.sources in every answer","url":"https://www.datasteg.com/en/technology/api"}},"servers":[{"url":"https://api.datasteg.com"}],"tags":[{"name":"datasteg","description":"Across the apps"},{"name":"money-flow","description":"Where money is created and how it flows between economies, from BIS, IMF and central-bank statistics."},{"name":"trade-flow","description":"The world trade network and product chains, ore to product, from UN Comtrade customs records, as shares, ranks and ratios."},{"name":"global-network","description":"For each economy, where its funding comes from and where its goods go, joined from money-flow (BIS, IMF) and trade-flow (UN Comtrade), with shock replays and stress signals."},{"name":"articles","description":"Explainers on economics and finance from central-bank research and official statistics, in English and Korean, with their numbered facts, chart data, sources and glossary."}],"paths":{"/v1":{"get":{"operationId":"index","tags":["datasteg"],"summary":"Index","description":"What the API offers, with links.","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/apps":{"get":{"operationId":"apps","tags":["datasteg"],"summary":"Apps","description":"Each app: status, current release, built time, views and tools.","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/search":{"get":{"operationId":"search","tags":["datasteg"],"summary":"Search every app","description":"Economies, data views, chains, events, articles, research documents and data publishers.","parameters":[{"name":"q","in":"query","required":true,"description":"Words, a name or a code","schema":{"type":"string","maxLength":200}},{"name":"apps","in":"query","required":false,"description":"Comma-separated app ids","schema":{"type":"string"}},{"name":"kinds","in":"query","required":false,"description":"Comma-separated kinds","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"1 to 50","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/items/{id}":{"get":{"operationId":"item","tags":["datasteg"],"summary":"Read one item","description":"One item by the id search returned (app:kind:key): readable text, metadata and the page to cite.","parameters":[{"name":"id","in":"path","required":true,"description":"Such as trade-flow:chain:semiconductors","schema":{"type":"string"}},{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/economies":{"get":{"operationId":"economies","tags":["datasteg"],"summary":"Economies","description":"Every economy code the apps cover, with names and links.","parameters":[{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/economies/{iso3}":{"get":{"operationId":"economyProfile","tags":["datasteg"],"summary":"One economy across the apps","description":"Each app's summary, headline numbers with periods and links for one economy.","parameters":[{"name":"iso3","in":"path","required":true,"description":"ISO 3166-1 alpha-3 code, or an English name","schema":{"type":"string"}},{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/money-flow/board":{"get":{"operationId":"moneyFlow_board","tags":["money-flow"],"summary":"The Signal Board for one quarter, funding vulnerability against bank and bond flows for 36 borrowing economies.","description":"The Signal Board for one quarter, funding vulnerability against bank and bond flows for 36 borrowing economies. Also the MCP tool money_flow_board.","parameters":[{"name":"quarter","in":"query","required":false,"description":"Board quarter as 2026-06-30 or 2026-Q2; default the quarter the World page shows (the newest)","schema":{"type":"string","pattern":"^\\d{4}-(\\d{2}-\\d{2}|Q[1-4])$"}},{"name":"release","in":"query","required":false,"description":"A kept release tag such as 20261109.1; default the latest","schema":{"type":"string","pattern":"^\\d{8}\\.\\d+$"}},{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}},{"name":"format","in":"query","required":false,"description":"csv for CSV (or send Accept: text/csv)","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/money-flow/economies":{"get":{"operationId":"moneyFlow_economies","tags":["money-flow"],"summary":"The 179 economies with a money-flow page, with code, name, region and page.","description":"The 179 economies with a money-flow page, with code, name, region and page.","parameters":[{"name":"release","in":"query","required":false,"description":"A kept release tag; default the latest","schema":{"type":"string","pattern":"^\\d{8}\\.\\d+$"}},{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/money-flow/economies/{iso3}":{"get":{"operationId":"moneyFlow_economy","tags":["money-flow"],"summary":"One economy's page, one part at a time, the headline figures and marks, the money ladder in and out, its indicators or its data checks.","description":"One economy's page, one part at a time, the headline figures and marks, the money ladder in and out, its indicators or its data checks. Also the MCP tool money_flow_economy.","parameters":[{"name":"iso3","in":"path","required":true,"description":"ISO 3166-1 alpha-3 code, such as KOR (EMU for the euro area)","schema":{"type":"string","pattern":"^[A-Za-z]{3}$"}},{"name":"part","in":"query","required":false,"description":"Which part of the page: summary (headline figures, Signal Board mark, sovereign signals), ladder (who holds claims on it and what it holds, by channel), indicators (the series the page draws, newest values), checks","schema":{"type":"string","enum":["summary","ladder","indicators","checks"],"default":"summary"}},{"name":"release","in":"query","required":false,"description":"A kept release tag; default the latest","schema":{"type":"string","pattern":"^\\d{8}\\.\\d+$"}},{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/money-flow/economies/{iso3}/indicators/{id}":{"get":{"operationId":"moneyFlow_indicator","tags":["money-flow"],"summary":"One indicator of an economy page as points (reserves, money, IIP and BOP items, bank claims in dollars), in USD bn.","description":"One indicator of an economy page as points (reserves, money, IIP and BOP items, bank claims in dollars), in USD bn.","parameters":[{"name":"iso3","in":"path","required":true,"description":"ISO 3166-1 alpha-3 code, such as KOR","schema":{"type":"string","pattern":"^[A-Za-z]{3}$"}},{"name":"id","in":"path","required":true,"description":"Indicator id from part=indicators, such as fx_reserves, broad_money, iip_net, iip_liabilities_total, bop_assets_portfolio","schema":{"type":"string","pattern":"^[a-z0-9_]{1,40}$"}},{"name":"last","in":"query","required":false,"description":"How many of the newest points","schema":{"type":"integer","minimum":1,"maximum":400,"default":40}},{"name":"release","in":"query","required":false,"description":"A kept release tag; default the latest","schema":{"type":"string","pattern":"^\\d{8}\\.\\d+$"}},{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}},{"name":"format","in":"query","required":false,"description":"csv for CSV (or send Accept: text/csv)","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/money-flow/markets/{market}":{"get":{"operationId":"moneyFlow_market","tags":["money-flow"],"summary":"One market's holder by destination matrix, one cell, a debtor's largest holders or a creditor's largest holdings (at most 25).","description":"One market's holder by destination matrix, one cell, a debtor's largest holders or a creditor's largest holdings (at most 25).","parameters":[{"name":"market","in":"path","required":true,"description":"equity, bonds (portfolio debt), bank (loans and deposits) or fdi (direct investment)","schema":{"type":"string","enum":["equity","bonds","bank","fdi"]}},{"name":"creditor","in":"query","required":false,"description":"Holder (row), ISO alpha-3; with debtor, one cell","schema":{"type":"string","pattern":"^[A-Za-z]{3}$"}},{"name":"debtor","in":"query","required":false,"description":"Destination (column), ISO alpha-3; alone, its largest holders","schema":{"type":"string","pattern":"^[A-Za-z]{3}$"}},{"name":"limit","in":"query","required":false,"description":"Rows at most","schema":{"type":"integer","minimum":1,"maximum":25,"default":10}},{"name":"release","in":"query","required":false,"description":"A kept release tag; default the latest","schema":{"type":"string","pattern":"^\\d{8}\\.\\d+$"}},{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}},{"name":"format","in":"query","required":false,"description":"csv for CSV (or send Accept: text/csv)","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/money-flow/markets/bank/lender-cut":{"get":{"operationId":"moneyFlow_lender_cut","tags":["money-flow"],"summary":"Cut a lender (rule R21), the first-round loss if one banking system cut its loans and deposits to a Signal Board economy, against net reserves.","description":"Cut a lender (rule R21), the first-round loss if one banking system cut its loans and deposits to a Signal Board economy, against net reserves. Also the MCP tool money_flow_bank_lenders.","parameters":[{"name":"debtor","in":"query","required":false,"description":"Borrowing economy (one of the 36 board economies), ISO alpha-3; default the largest borrower","schema":{"type":"string","pattern":"^[A-Za-z]{3}$"}},{"name":"lender","in":"query","required":false,"description":"Lending banking system, ISO alpha-3; without debtor, every debtor it lends to","schema":{"type":"string","pattern":"^[A-Za-z]{3}$"}},{"name":"cut_pct","in":"query","required":false,"description":"The cut in per cent, 10 to 50 in steps of 5","schema":{"type":"integer","minimum":10,"maximum":50,"default":30}},{"name":"release","in":"query","required":false,"description":"A kept release tag; default the latest","schema":{"type":"string","pattern":"^\\d{8}\\.\\d+$"}},{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}},{"name":"format","in":"query","required":false,"description":"csv for CSV (or send Accept: text/csv)","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/money-flow/sovereign":{"get":{"operationId":"moneyFlow_sovereign","tags":["money-flow"],"summary":"The Sovereign page's seven stress rules (R22-R28) for one economy, with yearly counts and IMF projections, or the 36 economies' current signals.","description":"The Sovereign page's seven stress rules (R22-R28) for one economy, with yearly counts and IMF projections, or the 36 economies' current signals. Also the MCP tool money_flow_sovereign.","parameters":[{"name":"economy","in":"query","required":false,"description":"One of the 36 Sovereign economies, ISO alpha-3; leave out for all of them","schema":{"type":"string","pattern":"^[A-Za-z]{3}$"}},{"name":"release","in":"query","required":false,"description":"A kept release tag; default the latest","schema":{"type":"string","pattern":"^\\d{8}\\.\\d+$"}},{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}},{"name":"format","in":"query","required":false,"description":"csv for CSV (or send Accept: text/csv)","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/money-flow/pulse":{"get":{"operationId":"moneyFlow_pulse","tags":["money-flow"],"summary":"The World pulse, Fed swap lines, Treasuries in custody for foreign officials, the broad dollar index (52 weeks) and TIC net purchases.","description":"The World pulse, Fed swap lines, Treasuries in custody for foreign officials, the broad dollar index (52 weeks) and TIC net purchases.","parameters":[{"name":"release","in":"query","required":false,"description":"A kept release tag; default the latest","schema":{"type":"string","pattern":"^\\d{8}\\.\\d+$"}},{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}},{"name":"format","in":"query","required":false,"description":"csv for CSV (or send Accept: text/csv)","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/money-flow/releases":{"get":{"operationId":"moneyFlow_releases","tags":["money-flow"],"summary":"The kept releases of money-flow's data, newest first, with method, checks and files changed.","description":"The kept releases of money-flow's data, newest first, with method, checks and files changed.","parameters":[{"name":"limit","in":"query","required":false,"description":"Releases per answer","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"cursor","in":"query","required":false,"description":"The cursor a previous answer gave","schema":{"type":"string"}},{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}},{"name":"format","in":"query","required":false,"description":"csv for CSV (or send Accept: text/csv)","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/money-flow/releases/{tag}":{"get":{"operationId":"moneyFlow_release","tags":["money-flow"],"summary":"One release's manifest, previous release, method, build time, source vintages, checks and the files that changed.","description":"One release's manifest, previous release, method, build time, source vintages, checks and the files that changed.","parameters":[{"name":"tag","in":"path","required":true,"description":"Release tag, such as 20261109.1","schema":{"type":"string","pattern":"^\\d{8}\\.\\d+$"}},{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}},{"name":"format","in":"query","required":false,"description":"csv for CSV (or send Accept: text/csv)","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/trade-flow/economies/{iso3}":{"get":{"operationId":"tradeFlow_economy","tags":["trade-flow"],"summary":"One economy's largest partners (shares of its exports or imports, ranks, mirror ratios) and largest HS chapters, as the explorer's economy card shows them.","description":"One economy's largest partners (shares of its exports or imports, ranks, mirror ratios) and largest HS chapters, as the explorer's economy card shows them. Also the MCP tool trade_flow_economy.","parameters":[{"name":"iso3","in":"path","required":true,"description":"ISO 3166-1 alpha-3 code, such as KOR","schema":{"type":"string","pattern":"^[A-Za-z0-9_]{3}$"}},{"name":"period","in":"query","required":false,"description":"YYYY-MM: the 12-month window ending in that month (default: the latest the site shows); YYYY: the year","schema":{"type":"string","pattern":"^[0-9]{4}(-[0-9]{2})?$"}},{"name":"product","in":"query","required":false,"description":"TOTAL (all goods), a basket such as B:semiconductors or a chain stage such as C:batteries:cells; HS chapters such as HS:85 are annual only","schema":{"type":"string","maxLength":64,"default":"TOTAL"}},{"name":"direction","in":"query","required":false,"description":"Partners as destinations of its exports or suppliers of its imports","schema":{"type":"string","enum":["exports","imports"],"default":"exports"}},{"name":"limit","in":"query","required":false,"description":"How many partners","schema":{"type":"integer","minimum":1,"maximum":25,"default":10}},{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}},{"name":"format","in":"query","required":false,"description":"csv for CSV (or send Accept: text/csv)","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/trade-flow/flows/{a}/{b}":{"get":{"operationId":"tradeFlow_bilateral","tags":["trade-flow"],"summary":"Trade between two economies in both directions - shares of world trade and of each side's trade, ranks, the mirror ratio, ten years of window shares and the largest HS chapters - as the explorer's flow card shows it.","description":"Trade between two economies in both directions - shares of world trade and of each side's trade, ranks, the mirror ratio, ten years of window shares and the largest HS chapters - as the explorer's flow card shows it. Also the MCP tool trade_flow_bilateral.","parameters":[{"name":"a","in":"path","required":true,"description":"First economy, ISO3, such as KOR","schema":{"type":"string","pattern":"^[A-Za-z0-9_]{3}$"}},{"name":"b","in":"path","required":true,"description":"Second economy, ISO3, such as USA","schema":{"type":"string","pattern":"^[A-Za-z0-9_]{3}$"}},{"name":"product","in":"query","required":false,"description":"TOTAL, a basket, a chain stage or (annual) an HS chapter","schema":{"type":"string","maxLength":64,"default":"TOTAL"}},{"name":"period","in":"query","required":false,"description":"YYYY-MM (12-month window) or YYYY (year); default the latest window the site shows","schema":{"type":"string","pattern":"^[0-9]{4}(-[0-9]{2})?$"}},{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}},{"name":"format","in":"query","required":false,"description":"csv for CSV (or send Accept: text/csv)","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/trade-flow/products":{"get":{"operationId":"tradeFlow_products","tags":["trade-flow"],"summary":"The products trade-flow draws - all goods, HS chapters, baskets and chain stages - with names, codes and the years and windows on offer.","description":"The products trade-flow draws - all goods, HS chapters, baskets and chain stages - with names, codes and the years and windows on offer.","parameters":[{"name":"kind","in":"query","required":false,"description":"Only one kind","schema":{"type":"string","enum":["total","chapter","basket","stage"]}},{"name":"limit","in":"query","required":false,"description":"How many per page","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"cursor","in":"query","required":false,"description":"The cursor a previous answer returned","schema":{"type":"string","maxLength":8}},{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/trade-flow/products/{id}":{"get":{"operationId":"tradeFlow_product","tags":["trade-flow"],"summary":"One product's world picture - exporters, top exporter and top-five shares, HHI, the largest exporters and importers - as the explorer's overview shows it.","description":"One product's world picture - exporters, top exporter and top-five shares, HHI, the largest exporters and importers - as the explorer's overview shows it.","parameters":[{"name":"id","in":"path","required":true,"description":"Product id such as TOTAL, HS:85, B:semiconductors or C:batteries:cells (or its slug, HS-85)","schema":{"type":"string","pattern":"^[A-Za-z0-9:_-]{1,64}$"}},{"name":"period","in":"query","required":false,"description":"YYYY-MM (12-month window) or YYYY (year); default the latest the site shows","schema":{"type":"string","pattern":"^[0-9]{4}(-[0-9]{2})?$"}},{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}},{"name":"format","in":"query","required":false,"description":"csv for CSV (or send Accept: text/csv)","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/trade-flow/chains":{"get":{"operationId":"tradeFlow_chains","tags":["trade-flow"],"summary":"The ten product chains, ore to product, with their stages, chokepoint stage and most two-way stage in the last complete year.","description":"The ten product chains, ore to product, with their stages, chokepoint stage and most two-way stage in the last complete year.","parameters":[{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/trade-flow/chains/{chain}":{"get":{"operationId":"tradeFlow_chain","tags":["trade-flow"],"summary":"One chain's stages - exporter HHI, the largest exporters, importers and flows as shares, chokepoints above HHI 0.25 - and, with economy, that economy's place at every stage, as the chain page shows it.","description":"One chain's stages - exporter HHI, the largest exporters, importers and flows as shares, chokepoints above HHI 0.25 - and, with economy, that economy's place at every stage, as the chain page shows it. Also the MCP tool trade_flow_chain.","parameters":[{"name":"chain","in":"path","required":true,"description":"Chain id, such as semiconductors or batteries","schema":{"type":"string","pattern":"^[a-z_]{2,32}$"}},{"name":"economy","in":"query","required":false,"description":"ISO3 of an economy to place at every stage, such as KOR","schema":{"type":"string","pattern":"^[A-Za-z0-9_]{3}$"}},{"name":"year","in":"query","required":false,"description":"A year of the chain (default the last complete year)","schema":{"type":"integer","minimum":1995,"maximum":2100}},{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}},{"name":"format","in":"query","required":false,"description":"csv for CSV (or send Accept: text/csv)","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/trade-flow/events":{"get":{"operationId":"tradeFlow_events","tags":["trade-flow"],"summary":"The fourteen economic events trade-flow reads in the trade data, with dates, products and economies.","description":"The fourteen economic events trade-flow reads in the trade data, with dates, products and economies.","parameters":[{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/trade-flow/events/{id}":{"get":{"operationId":"tradeFlow_event","tags":["trade-flow"],"summary":"One event as its page shows it - timeline, who gained and lost share, the named economies' changes, the reading of the numbers and the dated sources.","description":"One event as its page shows it - timeline, who gained and lost share, the named economies' changes, the reading of the numbers and the dated sources.","parameters":[{"name":"id","in":"path","required":true,"description":"Event id, such as covid-2020 or iran-war-2026","schema":{"type":"string","pattern":"^[a-z0-9-]{2,64}$"}},{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/trade-flow/cases":{"get":{"operationId":"tradeFlow_cases","tags":["trade-flow"],"summary":"The nine case studies - a question from the literature read against the trade network.","description":"The nine case studies - a question from the literature read against the trade network.","parameters":[{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/trade-flow/cases/{id}":{"get":{"operationId":"tradeFlow_case","tags":["trade-flow"],"summary":"One case study as its page shows it - papers with verified quotes, the measures as shares and changes, the scenario, Korea and the limits.","description":"One case study as its page shows it - papers with verified quotes, the measures as shares and changes, the scenario, Korea and the limits.","parameters":[{"name":"id","in":"path","required":true,"description":"Case id, such as chips or hormuz","schema":{"type":"string","pattern":"^[a-z0-9-]{2,64}$"}},{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/trade-flow/tools/cut-supplier":{"get":{"operationId":"tradeFlow_supplier_cut","tags":["trade-flow"],"summary":"The cut-a-supplier scenario on any chain stage - who loses what share of their imports, who could fill the gap and what passes one stage down - as the tool page computes it.","description":"The cut-a-supplier scenario on any chain stage - who loses what share of their imports, who could fill the gap and what passes one stage down - as the tool page computes it. Also the MCP tool trade_flow_supplier_cut.","parameters":[{"name":"stage","in":"query","required":false,"description":"Chain stage as <chain>/<stage>, such as semiconductors/ics (default: the first chain's chokepoint)","schema":{"type":"string","maxLength":64}},{"name":"exporter","in":"query","required":false,"description":"ISO3 of the exporter cut (default the stage's largest)","schema":{"type":"string","pattern":"^[A-Za-z0-9_]{3}$"}},{"name":"cut","in":"query","required":false,"description":"Share of its exports removed, in percent","schema":{"type":"integer","minimum":1,"maximum":100,"default":100}},{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}},{"name":"format","in":"query","required":false,"description":"csv for CSV (or send Accept: text/csv)","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/global-network/countries/{iso3}":{"get":{"operationId":"globalNetwork_country","tags":["global-network"],"summary":"One economy's country sheet - funding (V, F, A2, net IIP, bank lenders) at money-flow's board quarter and goods trade (12-month totals, partners, HS chapters, chokepoints) at its own window, with the stress strip.","description":"One economy's country sheet - funding (V, F, A2, net IIP, bank lenders) at money-flow's board quarter and goods trade (12-month totals, partners, HS chapters, chokepoints) at its own window, with the stress strip.","parameters":[{"name":"iso3","in":"path","required":true,"description":"ISO 3166-1 alpha-3 code of one of the 36 board economies or USA, such as KOR","schema":{"type":"string","pattern":"^[A-Z]{3}$"}},{"name":"part","in":"query","required":false,"description":"sheet: both sections; funding: adds V and F by quarter since 2005; trade: adds 12-month exports and imports by month since 2006","schema":{"type":"string","enum":["sheet","funding","trade"],"default":"sheet"}},{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}},{"name":"format","in":"query","required":false,"description":"csv for CSV (or send Accept: text/csv)","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/global-network/pairs/{a}/{b}":{"get":{"operationId":"globalNetwork_pair","tags":["global-network"],"summary":"Goods, bank claims, portfolio holdings and direct investment between two economies, both directions, each at its own period, and the finance-to-trade ratio; optionally one channel through time.","description":"Goods, bank claims, portfolio holdings and direct investment between two economies, both directions, each at its own period, and the finance-to-trade ratio; optionally one channel through time. Also the MCP tool global_network_pair.","parameters":[{"name":"a","in":"path","required":true,"description":"First economy, ISO alpha-3 (36 board economies or USA), such as KOR","schema":{"type":"string","pattern":"^[A-Z]{3}$"}},{"name":"b","in":"path","required":true,"description":"Second economy, ISO alpha-3, different from a, such as USA","schema":{"type":"string","pattern":"^[A-Z]{3}$"}},{"name":"history","in":"query","required":false,"description":"One lane of the pair's time chart as a table: goods (monthly 12-month windows), bank (quarterly), portfolio (half-yearly), fdi (annual), ratio (finance to trade, quarterly)","schema":{"type":"string","enum":["none","goods","bank","portfolio","fdi","ratio"],"default":"none"}},{"name":"since","in":"query","required":false,"description":"First year of the history lane","schema":{"type":"integer","minimum":2006,"maximum":2100,"default":2006}},{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}},{"name":"format","in":"query","required":false,"description":"csv for CSV (or send Accept: text/csv)","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/global-network/shocks":{"get":{"operationId":"globalNetwork_shocks","tags":["global-network"],"summary":"The shock replays (COVID-19 2020, the Iran war 2026, the 2008 crisis, Russia-Ukraine 2022) with their shock months.","description":"The shock replays (COVID-19 2020, the Iran war 2026, the 2008 crisis, Russia-Ukraine 2022) with their shock months.","parameters":[{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}},{"name":"format","in":"query","required":false,"description":"csv for CSV (or send Accept: text/csv)","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/global-network/shocks/{id}":{"get":{"operationId":"globalNetwork_shock","tags":["global-network"],"summary":"One shock replay - three waves of trade falls month by month, who was hit and whether funding cushioned it, medians by how economies earn, the stress count before; or its network, or the dollar strips.","description":"One shock replay - three waves of trade falls month by month, who was hit and whether funding cushioned it, medians by how economies earn, the stress count before; or its network, or the dollar strips. Also the MCP tool global_network_shock.","parameters":[{"name":"id","in":"path","required":true,"description":"Replay id: covid-2020, iran-war-2026, gfc-2008 or russia-ukraine-2022 (GET /shocks lists them)","schema":{"type":"string","pattern":"^[a-z0-9-]{1,40}$"}},{"name":"economy","in":"query","required":false,"description":"Optional ISO alpha-3 code: focus the summary or the network on one economy","schema":{"type":"string","pattern":"^[A-Z]{3}$"}},{"name":"part","in":"query","required":false,"description":"summary: waves and the who-was-hit table; network: the economies and trade links the map draws, monthly; dollar: the weekly broad dollar index and Fed swap lines","schema":{"type":"string","enum":["summary","network","dollar"],"default":"summary"}},{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}},{"name":"format","in":"query","required":false,"description":"csv for CSV (or send Accept: text/csv)","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/global-network/stress":{"get":{"operationId":"globalNetwork_stress","tags":["global-network"],"summary":"The seven stress signals J1-J7 (each a funding quantity against a trade quantity) for one economy by quarter since 2005, or for all 36 board economies at one quarter; no composite under rule G19.","description":"The seven stress signals J1-J7 (each a funding quantity against a trade quantity) for one economy by quarter since 2005, or for all 36 board economies at one quarter; no composite under rule G19. Also the MCP tool global_network_stress.","parameters":[{"name":"economy","in":"query","required":false,"description":"Optional ISO alpha-3 code of a board economy, such as KOR; without it, the board of 36 economies","schema":{"type":"string","pattern":"^[A-Z]{3}$"}},{"name":"quarter","in":"query","required":false,"description":"Optional quarter, 2026-Q2 or 2026-06-30 (default: the latest)","schema":{"type":"string","pattern":"^\\d{4}-(Q[1-4]|\\d{2}-\\d{2})$"}},{"name":"inputs","in":"query","required":false,"description":"With economy: add each signal's money and trade input to the quarterly table","schema":{"type":"boolean","default":false}},{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}},{"name":"format","in":"query","required":false,"description":"csv for CSV (or send Accept: text/csv)","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/articles":{"get":{"operationId":"articles_articles","tags":["articles"],"summary":"The published articles, newest first, by topic, country or type.","description":"The published articles, newest first, by topic, country or type. Also the MCP tool articles_list.","parameters":[{"name":"topic","in":"query","required":false,"description":"A topic id such as exchange-rates or monetary-policy (the topics view lists them)","schema":{"type":"string","pattern":"^[a-z0-9-]{1,60}$"}},{"name":"country","in":"query","required":false,"description":"An economy the article covers: ISO 3166-1 alpha-2 (KR) or alpha-3 (KOR); EA or EMU for the euro area, EU for the European Union","schema":{"type":"string","pattern":"^[A-Za-z0-9]{2,4}$"}},{"name":"type","in":"query","required":false,"description":"The article type","schema":{"type":"string","enum":["explainer","deep-dive","data-brief","paper-digest","speech-roundup"]}},{"name":"limit","in":"query","required":false,"description":"How many articles to return","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"cursor","in":"query","required":false,"description":"The cursor a previous answer returned, for the next page","schema":{"type":"string","maxLength":12}},{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}},{"name":"format","in":"query","required":false,"description":"csv for CSV (or send Accept: text/csv)","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/articles/{slug}":{"get":{"operationId":"articles_article","tags":["articles"],"summary":"One article for reading in the asked edition, with its sources, terms and citation.","description":"One article for reading in the asked edition, with its sources, terms and citation.","parameters":[{"name":"slug","in":"path","required":true,"description":"The article's slug, such as won-after-rate-hold","schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,99}$"}},{"name":"section","in":"query","required":false,"description":"One section id, to read only that section (the whole article when left out)","schema":{"type":"string","pattern":"^[a-z0-9-]{1,60}$"}},{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/articles/{slug}/facts":{"get":{"operationId":"articles_facts","tags":["articles"],"summary":"An article's numbered facts with unit, period and source, and with chart= that chart's data and metadata.","description":"An article's numbered facts with unit, period and source, and with chart= that chart's data and metadata. Also the MCP tool article_numbers.","parameters":[{"name":"slug","in":"path","required":true,"description":"The article's slug, such as won-after-rate-hold","schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,99}$"}},{"name":"chart","in":"query","required":false,"description":"A chart id of the article (its charts are listed in the article view), to add that chart's data and metadata","schema":{"type":"string","pattern":"^[a-z0-9-]{1,60}$"}},{"name":"limit","in":"query","required":false,"description":"How many facts to return","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"cursor","in":"query","required":false,"description":"The cursor a previous answer returned, for the next facts","schema":{"type":"string","maxLength":12}},{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}},{"name":"format","in":"query","required":false,"description":"csv for CSV (or send Accept: text/csv)","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/articles/{slug}/charts/{chart}":{"get":{"operationId":"articles_chart","tags":["articles"],"summary":"One chart's data as a table (the rows of the CSV the page offers) with its metadata.","description":"One chart's data as a table (the rows of the CSV the page offers) with its metadata.","parameters":[{"name":"slug","in":"path","required":true,"description":"The article's slug, such as won-after-rate-hold","schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,99}$"}},{"name":"chart","in":"path","required":true,"description":"The chart id, such as won-2026","schema":{"type":"string","pattern":"^[a-z0-9-]{1,60}$"}},{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}},{"name":"format","in":"query","required":false,"description":"csv for CSV (or send Accept: text/csv)","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/articles/glossary":{"get":{"operationId":"articles_glossary","tags":["articles"],"summary":"The glossary's terms in plain words, each with its definition, topics and the articles that use it.","description":"The glossary's terms in plain words, each with its definition, topics and the articles that use it.","parameters":[{"name":"topic","in":"query","required":false,"description":"Only the terms of one topic","schema":{"type":"string","pattern":"^[a-z0-9-]{1,60}$"}},{"name":"article","in":"query","required":false,"description":"Only the terms one article uses (its slug)","schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,99}$"}},{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}},{"name":"format","in":"query","required":false,"description":"csv for CSV (or send Accept: text/csv)","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/articles/topics":{"get":{"operationId":"articles_topics","tags":["articles"],"summary":"The topics in their groups, each with its articles and glossary terms.","description":"The topics in their groups, each with its articles and glossary terms.","parameters":[{"name":"lang","in":"query","required":false,"description":"Language of names and page links. Summaries are English.","schema":{"type":"string","enum":["en","ko"],"default":"en"}},{"name":"format","in":"query","required":false,"description":"csv for CSV (or send Accept: text/csv)","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"A parameter is missing, unknown or out of range","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"No such item","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Too many calls; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The app is not answering at the moment","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}}},"components":{"schemas":{"Answer":{"type":"object","required":["data","meta","links"],"properties":{"data":{"description":"The view's data, in its documented schema"},"table":{"type":"object","properties":{"columns":{"type":"array","items":{"type":"object"}},"rows":{"type":"array","items":{"type":"array"}}}},"meta":{"type":"object","properties":{"app":{"type":"string"},"view":{"type":"string"},"release":{"type":"string"},"built":{"type":"string"},"summary":{"type":"string"},"cite":{"type":"string","format":"uri"},"sources":{"type":"array","items":{"type":"object"}}}},"links":{"type":"object","properties":{"self":{"type":"string"},"page":{"type":"string"}}}}},"Problem":{"type":"object","required":["type","title","status"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"description":"RFC 9457 problem details. Types: bad-parameter, not-found, unknown-economy, rate-limited, app-unavailable, busy, not-acceptable, invalid-key"}}}}