{"uid":"cap_mNpX17r3V8BpkitvwbMQT","slug":"1gateway-bank-of-korea-ecos-statistics-api-0fb41863","name":"1gateway Bank of Korea ECOS Statistics API","description":"Use when you need official Bank of Korea statistics (base rate, money supply, key indicators) as a time series. Input: stat (ECOS table code, e.g. 722Y001), cycle (A/S/Q/M/SM/D), start, end (period format of cycle), optional item (e.g. 0101000). Output: JSON series with English labels, units, observations [{period,value}] (max 1,000 rows) and source attribution. Only BOK-authored tables are served. Example: ?stat=722Y001&cycle=M&start=202401&end=202412&item=0101000","url":"https://1gateway.dev/v1/macro/ecos?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["stat","cycle","start","end"],"properties":{"end":{"type":"string","pattern":"^[0-9A-Z]{4,8}$","examples":["202412"],"description":"End period, same format as start"},"item":{"type":"string","pattern":"^[0-9A-Za-z?]+$","examples":["0101000"],"description":"Item code 1 (e.g. 0101000). Optional item2..item4 also accepted."},"stat":{"type":"string","pattern":"^[0-9A-Z]{7}$","examples":["722Y001"],"description":"ECOS statistic table code, e.g. 722Y001 (base rate). Non-BOK tables → 403 (not charged)."},"cycle":{"enum":["A","S","Q","M","SM","D"],"type":"string","examples":["M"],"description":"A annual, S semi-annual, Q quarterly, M monthly, SM semi-monthly, D daily"},"start":{"type":"string","pattern":"^[0-9A-Z]{4,8}$","examples":["202401"],"description":"Start period in ECOS format (A: YYYY, Q: YYYYQn, M: YYYYMM, D: YYYYMMDD)"}},"additionalProperties":true}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["statCode","statNameKo","statNameEn","cycle","cycleEn","series","totalRows","rowLimit","truncated","attribution","license","cache"],"properties":{"cache":{"type":"string"},"cycle":{"type":"string"},"series":{"type":"array","items":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"nameEn":{"type":"string"},"nameKo":{"type":"string"}}}},"unitEn":{"type":"string"},"unitKo":{"type":"string"},"weight":{"type":"null"},"observations":{"type":"array","items":{"type":"object","properties":{"value":{"type":"number"},"period":{"type":"string"},"periodRaw":{"type":"string"}}}}}}},"cycleEn":{"type":"string"},"license":{"type":"string"},"rowLimit":{"type":"integer"},"statCode":{"type":"string"},"totalRows":{"type":"integer"},"truncated":{"type":"boolean"},"statNameEn":{"type":"string"},"statNameKo":{"type":"string"},"attribution":{"type":"string"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0045","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0045/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0045","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0045","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_EjTXX9d9RJnCDfUFIN_9H","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0045","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches official Bank of Korea (BOK) time-series data from ECOS tables — including base rate, money supply, and key macro indicators — as clean JSON with English labels","exampleAgentPrompt":"Can you pull the Bank of Korea base rate data from ECOS table 722Y001 monthly from January 2024 to December 2024, item 0101000?","exampleUseCases":[{"title":"Korea monetary policy rate history","prompt":"Get me the Bank of Korea base interest rate as a monthly time series for all of 2024 — use ECOS table 722Y001, item 0101000."},{"title":"South Korea money supply trend analysis","prompt":"I need South Korea's M2 money supply data on a quarterly basis from 2020 to 2024 — can you pull the relevant ECOS table for me?"},{"title":"Korean macro dashboard data feed","prompt":"Fetch South Korea's key macro indicators from the Bank of Korea — I need annual GDP growth data from 2015 to 2023 for a dashboard I'm building."}],"resultDescription":"Returns a JSON object containing the ECOS stat code, Korean and English stat names, cycle type, a series array with item codes, English/Korean names, units, and an observations array of {period, value, periodRaw} objects (up to 1,000 rows), plus truncation flag, source attribution, license, and cache metadata.","failureModes":["Non-BOK ECOS table code returns 403 (not charged)","Invalid stat code format returns validation error","Invalid cycle/period combination returns error","Period format mismatch (e.g. monthly format with annual cycle) causes query failure","Result truncated at 1,000 rows if date range is too wide","Missing required parameters (stat, cycle, start, end) returns 400"],"whenToPreferThis":"Use this endpoint when you need official, BOK-authored macro time-series data from South Korea's ECOS database — specifically when you need English-labeled, normalized JSON output without having to interface with the raw ECOS API directly. Prefer this over general web scraping or third-party aggregators when data provenance and official sourcing matter. Best for base rate, money supply, trade, or any BOK-published statistical table.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T00:38:40.708Z","isFirstParty":false,"canonicalSlug":"1gateway-bank-of-korea-ecos-statistics-api-0fb41863"}