skills.rest
NomaDamas
NomaDamasOFFICIAL
Explore all skills by this author →
WebsiteGitHub

bok-ecos-stats

Query Bank of Korea ECOS Open API for macroeconomic statistics time series.

7.4k|904|Updated Mar 24, 2026
Search Tags:#time series#exchange rate#interest rate#Query#bank of korea#ecos api#economic statistics
One-click install
npx skills add https://github.com/NomaDamas/k-skill --skill bok-ecos-stats
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bok-ecos-stats
Source: https://github.com/NomaDamas/k-skill/tree/main/bok-ecos-stats
Command: npx skills add https://github.com/NomaDamas/k-skill --skill bok-ecos-stats

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Looking up official Korean macroeconomic statistics like the base interest rate, exchange rates, CPI, and M2 money supply normally requires navigating the Bank of Korea ECOS portal manually. This Skill queries the ECOS Open API directly and returns structured time series data without registration.

Core Features & Use Cases

  • Time Series Search: Retrieve series by statistic code or built-in aliases such as 기준금리, 원달러환율, 소비자물가지수, M2, and 국고채3년 with daily, monthly, quarterly, or annual cycles.
  • Catalog Exploration: List statistical tables, inspect items within a table, fetch the 100 key headline indicators, and search the statistics glossary.
  • Use Case: Ask for the recent KRW/USD exchange rate trend and receive dated values sourced directly from ecos.bok.or.kr, with the statistical reference time always shown.

Quick Start

Ask the AI to show the Bank of Korea base interest rate trend for the past six months using the bok-ecos-stats skill.

Frequently Asked Questions about bok-ecos-stats

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I query Bank of Korea economic statistics from the command line?▼

Run the bok_ecos.py helper with the search subcommand and an alias like 기준금리 or 원달러환율 plus start and end dates. It calls the ECOS Open API and prints text or structured JSON with time, value, and unit fields.

What is the ECOS Open API and what data does it provide?▼

ECOS is the Bank of Korea's economic statistics system exposing official Korean macro data: interest rates, exchange rates, consumer price index, money supply, and government bond yields. It also offers a table catalog, item lists, 100 key indicators, and a statistics glossary.

Do I need an API key to use the ECOS Open API?▼

No key is required for basic use because the published demo key 'sample' works without registration, but it caps each call at 10 rows. For larger result sets, register at ecos.bok.or.kr and set KSKILL_BOK_ECOS_API_KEY.

Why does my ECOS query return only 10 rows or an ERROR-301?▼

ERROR-301 means the demo key's 10-row limit was exceeded. Issue a free personal API key from the ECOS portal and set it via the KSKILL_BOK_ECOS_API_KEY environment variable or the k-skill secrets file.

When should I not use ECOS statistics for financial data?▼

ECOS provides official reference statistics, not real-time trading data. For stock quotes use a Korean stock search tool, and for general KOSIS statistics like population or employment use a KOSIS-specific source instead.

Related Skills

Explore More Data & Analytics Skills→
dsa110dsa110

Light Curve Skill

Compute Eta, V-index, and sigma-deviation variability metrics from time-series photometry data.

Official
Advanced
SPIRAL-EDWINSPIRAL-EDWIN

arima-forecaster

Automates ARIMA/SARIMA time-series forecasting with statsmodels and pmdarima, outputting predictions and diagnostics.

Community
Advanced
peterbamuhigirepeterbamuhigire
1

country-context-tanzania

Consolidate Tanzania economic indicators, regulatory frameworks, and labour statistics for business planning.

Community
Basic
mousecomouseco
8

kosis-stats

Retrieve KOSIS Open API statistics table metadata and data cells.

Community
Intermediate