BOK

BOK ECOS Economic Statistics

Official API of the BOK Economic Statistics System (ECOS) for statistical time series, table lists, and key indicators. Provides macro indicators such as the base rate, exchange rates, GDP, and consumer prices.

What agents get

Time series for the base rate, call rate, KORIBOR, CD yields, exchange rates (KRW/USD and more), GDP growth, consumer price index (CPI), industrial production, retail sales, housing price index, and other economic statistics
Economic analysis, investment decisions, tracking rate and price trends, macro reporting, and exchange-rate analysis

Use cases

Look up base-rate change history
Exchange-rate time-series analysis
Check consumer-price inflation
Track GDP growth
Search statistical tables and check key indicators

Registered APIs (3)

Statistical Time-Series Lookup StatisticSearch

Look up time-series data by statistical table code, cycle, and period

stat_code Required — Statistical table code e.g. 901Y009
cycle Required — Cycle (A=annual, Q=quarterly, M=monthly, D=daily) e.g. D
start_dt Required — Search start date e.g. 20260101
end_dt Required — Search end date e.g. 20261010

Returns: STAT_CODE (table code), STAT_NAME, ITEM_CODE1/2/3 (item codes), ITEM_NAME1/2/3, TIME (point in time), DATA_VALUE (value)

Rate limit: 10,000 calls/day (Per the ECOS portal)

Statistical Table List Lookup StatisticTableList

Search statistical tables and find their codes

Returns: Statistical table list (STAT_CODE, STAT_NAME, cycle, category, and more)

Rate limit: 10,000 calls/day

Top-100 Key Indicators KeyStatisticList

View core economic indicators such as the base rate, exchange rates, and GDP at a glance

Returns: Top-100 key economic indicators (indicator name, value, change, and more)

Rate limit: 10,000 calls/day

Auth · pricing · terms

Auth	API key — Issued free at the ECOS portal. Stored only on the proxy server.
Pricing	Free
License	Public data: attribution required
Redistribution	Allowed (attribution required)
Terms checked	2026-10-10
Apply	Sign up at the ECOS portal -> Apply for an OpenAPI key (auto-approved) Portal
Status	Coming soon (opens after key registration)
Last checked	2026-10-10

How agents call

Call through our proxy. Start with the keyless quick API shown above (no token needed). For the keyed proxy, send X-Agent-Token to POST /agencatalog/api/call with ('service', 'endpoint', 'params'). The full service list is at /agencatalog/api/services.json.

Example: POST /agencatalog/api/call {service:'ecos-bok', endpoint:'StatisticSearch', params:{stat_code:'901Y009', cycle:'D', start_dt:'20260101', end_dt:'20261010'}}

Machine-readable JSON schema

{
  "service": "ecos-bok",
  "name": "BOK ECOS Economic Statistics",
  "provider": "BOK",
  "apis": [
    {
      "id": "StatisticSearch",
      "name": "Statistical Time-Series Lookup",
      "params": [
        {
          "name": "stat_code",
          "required": true,
          "example": "901Y009",
          "desc": "Statistical table code"
        },
        {
          "name": "cycle",
          "required": true,
          "example": "D",
          "desc": "Cycle (A=annual, Q=quarterly, M=monthly, D=daily)"
        },
        {
          "name": "start_dt",
          "required": true,
          "example": "20260101",
          "desc": "Search start date"
        },
        {
          "name": "end_dt",
          "required": true,
          "example": "20261010",
          "desc": "Search end date"
        }
      ]
    },
    {
      "id": "StatisticTableList",
      "name": "Statistical Table List Lookup",
      "params": []
    },
    {
      "id": "KeyStatisticList",
      "name": "Top-100 Key Indicators",
      "params": []
    }
  ],
  "proxy_call": "POST /agencatalog/api/call",
  "attribution": "Source: BOK Economic Statistics System ECOS (ecos.bok.or.kr)"
}

Notes

API keys live only on the server. Clients asking for keys directly cannot use this route.
Each provider has a daily quota. Over-quota calls return 429 and are blocked.
Provider outages or over-quota errors are passed through. Check the error field before retrying.
Attribution: Source: BOK Economic Statistics System ECOS (ecos.bok.or.kr)

Last checked: 2026-10-10

AI Crawler · Collection Records