Bank of Korea ECOS — English Economic Time Series

Fetch official Bank of Korea statistics from ECOS (Economic Statistics System) as clean, English-labelled, typed rows — no Korean account or API key needed.

• Interest rates (BOK base rate, call rate, KORIBOR, bond yields), KRW exchange rates, CPI / PPI, GDP, money supply, deposits & loans, balance of payments, business surveys and ~600 more tables
• ISO periods (2024, 2024-H1, 2024-Q3, 2024-01, 2024-01-S1, 2024-01-02), numeric values, explicit missing / unparseable flags — nothing silently dropped
• Every row carries a stable series_id and attribution to the Bank of Korea
• Automatic paging (up to 100,000 rows per run)

Typical searches this actor answers: Bank of Korea base rate history · KRW/USD exchange rate history · Korea GDP data · Korea money supply (M2) · Korean government bond yields · ECOS API in English.

Use cases

• Rates — BOK base rate, call rate, KORIBOR and Korean government bond yields (daily or monthly).
• FX — KRW exchange rates (e.g. KRW/USD) as clean daily or monthly series.
• Macro — GDP, CPI / PPI, money supply, deposits & loans, balance of payments.
• Dashboards — keyStatistics mode returns ~100 headline indicators in one run.
• AI agents & research assistants — English rows with Bank of Korea attribution, ready to cite.

Modes

mode	what you get	input
series (default)	observations of one table	statCode, frequency, startPeriod, endPeriod, optional itemCode1..4
keyStatistics	~100 headline indicators, latest values	nothing else
items	item codes, frequencies and date ranges of a table	statCode

Leave itemCode1 empty to get every item of a table. Not sure about codes? Run items first.

Quick start

CPI, monthly, 2024:

{"statCode": "901Y009", "frequency": "M", "startPeriod": "202401", "endPeriod": "202412", "itemCode1": "0"}

BOK base rate, daily:

{"statCode": "722Y001", "frequency": "D", "startPeriod": "20260901", "endPeriod": "20261010", "itemCode1": "0101000"}

Headline dashboard: {"mode": "keyStatistics"}

Use it from an AI agent (MCP)

Apify's MCP server (https://mcp.apify.com) lets MCP clients such as Claude Desktop, Claude Code, Cursor or VS Code call public Store actors. Add the server to your client, then ask, for example:

Use the Apify actor kdata-hub/ecos-korea-stats to get the Bank of Korea base rate (statCode 722Y001, itemCode1 0101000, frequency D) from 2026-01-01 to today and list each change.

Not sure about codes? Ask the agent to run the actor in items mode for a table first.

Output (series)

{
  "series_id": "901Y009.M.0",
  "stat_code": "901Y009",
  "stat_name_en": "Consumer Price indices",
  "items": [{"level": 1, "code": "0", "name_en": "Total item"}],
  "item_path_en": "Total item",
  "unit_en": "2020=100",
  "frequency": "M",
  "period": "2024-01",
  "value": 113.17,
  "value_status": "ok",
  "attribution": {"source": "Bank of Korea, Economic Statistics System (ECOS)", "stat_code": "901Y009", "retrieved_at": "2026-10-13", "url": "https://ecos.bok.or.kr/"}
}

Period formats for input: A = YYYY, S = YYYYS1, Q = YYYYQ1, M = YYYYMM, SM = YYYYMMS1, D = YYYYMMDD.

Pricing

Pay per result: $0.002 per row ($2 per 1,000 rows). keyStatistics is ~100 rows (about $0.20). A run that returns no rows produces no result charges.

FAQ

Do I need a Korean account or an ECOS API key? No. The actor uses built-in access by default; you can supply your own free ECOS key in apiKey.

Is the data official? Yes — values come from the Bank of Korea's Economic Statistics System (ECOS) and every row carries attribution. This actor is not affiliated with the Bank of Korea.

How do I find a table code? Run items mode with a statCode, or start from keyStatistics and the codes shown there.

Notes

• Source: Bank of Korea, Economic Statistics System (ECOS). This actor is not affiliated with the Bank of Korea.
• Optional: bring your own free ECOS key (apiKey). It is used only for your run and never logged.
• An empty result means ECOS has no data for that table / period / item combination.