Skip to content

Reference

Macro Education

FXMacroData vs KOSIS API: Korean Macro Data for KRW Traders

KOSIS, Korea's official statistics portal, offers a free OpenAPI with deep tables, including CPI and labour data. FXMacroData carries seven KRW series (GDP, BOK surveys, household credit, house prices, 2-year KTB, KOFR) with publication timestamps in one schema across 22 currencies. Here is how to choose.

Editorial standards and corrections

Share article X LinkedIn Email
Pip, the FXMacroData robot mascot, sorts small monthly cards into a slotted wooden rack with one brightly lit slot, beside thick official binders.
KOSIS is the free, official source of Korean statistics. FXMacroData files each Korean release by the moment it was published, ready for USD/KRW workflows.

This comparison is for KRW traders, quant developers, and analysts deciding whether to build Korean macro data straight from KOSIS, the Korean Statistical Information Service, or to use FXMacroData as the data layer for USD/KRW research. KOSIS is the official national statistics portal run by Korea's Ministry of Data and Statistics (Statistics Korea until October 2025), and its OpenAPI is free once you register for a key. FXMacroData is a paid FX macro API that reads official Korean releases from the Bank of Korea and the Korea Real Estate Board and packages them for trading workflows.

The core finding: KOSIS wins on depth, authority, and cost. It exposes hundreds of thousands of official tables, statistical metadata, and an SDMX option at no charge, including the consumer price, labour, and industrial tables that FXMacroData does not yet list for KRW. FXMacroData's KRW catalogue is deliberately narrow: seven series covering GDP, business and consumer sentiment, household credit, house prices, the 2-year Korea Treasury Bond (KTB) yield, and the KOFR overnight repo rate. It wins when those series feed a currency decision: one schema across 22 currencies, a publication timestamp on release-scheduled rows, a release calendar, pair dashboards, and MCP access for AI assistants. Many KRW desks will use both: KOSIS for prices, jobs, and the deep tables, and FXMacroData for the timed cross-currency layer.

Decision snapshot

Choose KOSIS OpenAPI when

You need Korean CPI, employment, industrial output, or trade, the full official table with every sub-item and regional split, survey metadata, or a long research history, and you are comfortable working with Korean-language documentation.

Choose FXMacroData when

You trade KRW against other currencies and want Korean GDP, sentiment, credit, housing, and short-rate series in the same JSON shape as the US, Japan, and 19 other currencies, with a calendar and pair context.

Quick answer

KOSIS is free and authoritative for Korean statistics. FXMacroData costs $50/month (Individual), carries seven KRW series today, and is built for trading workflows that need publication timestamps and cross-currency consistency.

Takeaway: the split is a deep source of record versus a narrower trading workflow layer, not good data versus bad data.

Pricing And Access

KOSIS is not a commercial vendor, so the price comparison is lopsided by design. The KOSIS OpenAPI terms state that information is provided free of charge in principle, with fees only if a user asks for delivery outside the standard service. Access needs a KOSIS membership and an approved usage application, which issues the API key passed as the apiKey parameter on each request. The Bank of Korea runs a separate free, key-based API for its own statistics database (ECOS), covered in our Bank of Korea and KRW analysis.

FXMacroData publishes self-serve pricing. The Always Free tier needs no key, covers USD data only, allows 100 requests a day, and delays USD announcements by 15 minutes. Korean data starts with the Individual plan at $50/month or $500/year, with a 14-day trial, 1,000,000 requests a month, and bursts of 300 a minute. Business is $250/month or $2,500/year for companies and teams of up to 10 people, with the same monthly allowance and priority support. Enterprise is by custom agreement.

KOSIS OpenAPI

Free, key required*

Membership plus usage application. Up to 200 calls a minute and 40,000 cells per request on the standard services.*

FXMacroData Individual

$50/month

KRW plus 21 other currencies, 14-day trial, 1,000,000 requests a month, dashboards, exports, and MCP.

FXMacroData Always Free

$0, no key

USD data only, 100 requests a day, announcements delayed 15 minutes. Useful for testing the schema before paying.

Takeaway: if budget is the only constraint, KOSIS is the answer. The $50 buys the engineering you would otherwise do yourself for the series it carries: normalisation, release timing, and cross-currency consistency.

* KOSIS access terms and limits retrieved from the KOSIS OpenAPI service-introduction and terms-of-use pages in October 2026. KOSIS publishes no paid tier.

Side-By-Side Comparison

Attribute FXMacroData KOSIS OpenAPI
Core job FX macro API: release-timed indicator rows, calendar, pair dashboards, exports, MCP. Official national statistics portal: tables, metadata, survey descriptions, key indicators.
Entry pricing Individual $50/month or $500/year; Business $250/month for up to 10 people. Free; fees only for non-standard delivery requests.*
Free tier Always Free: USD only, no key, 100 requests/day, 15-minute delay on USD announcements. KRW needs a paid plan. The whole service is free after membership and key approval.*
Coverage 22 currencies, 700+ series. KRW currently covers seven series: real GDP, the BSI business survey, the CCSI consumer survey, household credit, the house purchase price index, the 2-year KTB yield, and KOFR. No KRW CPI, labour, trade, or policy-rate series is listed yet. Korea only, but very deep: the portal lists 290,552 statistical tables (count dated June 2023), 1,529 survey descriptions, and 1,469 key indicators.*
Release timing announcement_datetime (epoch seconds) on release-scheduled rows, with a status and precision flag; month-end market series such as the 2-year KTB and KOFR carry no publication time. Releases are typically available within seconds of official publication, measured publicly. Data rows carry the period and a last-changed date (LST_CHN_DE), not a publication timestamp.*
API format REST JSON with OpenAPI, header auth (X-API-Key), SSE streaming, GraphQL, Python/JS SDKs. REST over HTTPS with key as a query parameter; JSON, SDMX, XML, or XLS depending on the service.*
Rate limits 1,000,000 requests/month; bursts of 300/minute and 5,000/hour; 20 concurrent. 200 calls per minute; 40,000 cells per request (200,000 for bulk XLS).*
History Varies by series: KRW GDP from 1960, CCSI from 2008, BSI from 2009, the 2-year KTB from 2021. Each response reports its earliest_available_date. Full published history of each table, back to the start of the series.
Language English docs and field names. OpenAPI portal and guide in Korean; responses include English labels (ITM_NM_ENG, UNIT_NM_ENG).*
AI / MCP Official MCP server for Claude, ChatGPT, Cursor, and other clients. No MCP server listed on the OpenAPI portal.
Licence for programmatic / commercial use Plans cover internal use; showing data to outside users needs the self-serve Commercial Redistribution add-on ($10/month per block of up to 100 users). Commercial use allowed, with source attribution required; reselling the raw data without your own service platform is prohibited.*
Best fit Multi-currency traders who want Korean growth, sentiment, credit, housing, and short rates alongside other currencies; dashboards, alerting, AI agents. Korean CPI, labour, and industrial data; Korea economists, academic research, sub-item and regional analysis, official citation.

* Competitor terms and limits retrieved from the KOSIS OpenAPI service-introduction, developer-guide, and terms-of-use pages in October 2026.

What KOSIS Covers And How It Works

KOSIS is Korea's national statistics database, bringing together official statistics from the Ministry of Data and Statistics and other producing agencies, the Bank of Korea included. The OpenAPI offers seven services: statistics lists, statistical data, bulk statistical data, survey descriptions, table descriptions, integrated search, and key indicators. All of them use REST over HTTPS. The portal ended plain-HTTP access and announced per-minute call limits in a February 2026 notice, then followed up with a July 2026 notice that added statistical symbols to the data services.

Requests are built around table IDs and classification codes. A data call names the organisation (orgId), the table (tblId), up to eight classification levels (objL1 to objL8), the item (itmId), the period type (prdSe), and either a date range or a count of recent periods. Alternatively, you can register a table in the portal and call it by a user statistics ID. The developer guide is in Korean, but responses include English labels for items, classifications, and units, so an English-speaking developer can get started with some help from a translator.

For a KRW trader the important KOSIS tables are few: headline and core consumer prices, producer prices, the labour force survey, industrial activity, and retail sales. None of these is in FXMacroData's KRW catalogue today, so KOSIS is the practical API route to them. The challenge is locating the right table and item codes, then keeping them current when a table is rebased or reorganised. The portal's notice board regularly announces table changes, and the terms make watching those notices the user's responsibility.

Korean Short Rates In The FXMacroData Catalogue

Two of the seven KRW series are market rates sourced from the Bank of Korea: the 2-year KTB benchmark yield and KOFR, the overnight repo reference rate. FXMacroData stores each as a month-end observation (the last trading day of the month). Over the twelve months to August 2026 the 2-year yield rose from 2.35% to 3.70%, while KOFR stayed near 2.5% to 2.6% until mid-2026 and then moved up to 3.06% in August.

2-year KTB yield and KOFR, month-end (August 2025 to August 2026)

Percent, last trading day of each month, from the FXMacroData KRW gov_bond_2y and risk_free_rate series.

Takeaway: the 2-year yield went from below KOFR in August 2025 to about 1 percentage point above it in May and June 2026, then the gap narrowed to 0.64 points in August as the overnight rate rose. That is a market read on the Bank of Korea path, and it feeds USD/KRW rate spreads. These two series are the closest thing to a policy-rate signal in the current KRW catalogue.

Source: Bank of Korea ECOS via the FXMacroData API (/v1/announcements/krw/gov_bond_2y and /v1/announcements/krw/risk_free_rate), retrieved October 2026.

Release Timing: What Each API Records

Korean consumer prices, published by the Ministry of Data and Statistics at 08:00 KST, are a KOSIS story: FXMacroData does not list a KRW CPI series, so a trader who needs that print on release morning should build it from KOSIS or the ministry's own release. The Bank of Korea surveys that FXMacroData does carry come out even earlier. The September 2026 consumer survey (CCSI) was published at 06:00 KST on 23 September, and the September business survey (BSI) at 06:00 KST on 29 September. The second-quarter 2026 GDP estimate came out at 08:00 KST on 23 July. All of these land before USD/KRW onshore trading opens at 09:00 KST. The FX sessions view shows how that overlaps with the other markets.

KOSIS is not built to tell you those times. Its data rows carry the reference period and a date-level last-changed field. That is fine for research tables, but it does not let a backtest tell whether a number was known at 06:00 or late that afternoon. We have not measured how soon each KOSIS table updates after a release and make no claim about it. The point is narrower: the KOSIS API does not record a publication timestamp you can join to tick data.

FXMacroData adds announcement_datetime, the prior value, the change, and source metadata to each release-scheduled KRW row, along with a publication_time_status flag that marks whether the time was confirmed against the publisher's schedule. Recent BSI, CCSI, GDP, and household credit rows are confirmed to the minute; some older rows are flagged as unverified, and the house price index carries a date-level stamp. Releases are typically available within seconds of official publication, and the measured record by source is public on the release-speed page.

Korean release morning (KST)

06:00 BOK surveys

CCSI and BSI release days. FXMacroData stamps the row with the publication minute.

08:00 GDP and CPI

BOK GDP estimates (in FXMacroData) and MODS consumer prices (KOSIS only) are published.

FXMacroData row

Value, prior, change, source, and announcement_datetime, with measured pickup published.

KOSIS table

The table carries the new period with a date-level last-changed stamp, plus the full sub-item detail.

09:00 onshore open

USD/KRW onshore trading opens with the morning's prints already known.

Takeaway: for KRW event studies you need the publication moment. FXMacroData stores it on its release-scheduled KRW rows; KOSIS stores the statistics, including the CPI and labour data FXMacroData does not carry.

Rate Limits, Formats, And Licence Terms

The KOSIS service-introduction page lists the same limits for each service: up to 200 calls a minute and up to 40,000 cells per request. Bulk data has a higher ceiling of 200,000 cells in XLS format. Statistical data comes as SDMX or JSON, survey and table descriptions as XML or JSON, and integrated search as JSON. That is generous for a research pipeline that refreshes a few dozen tables, and tight only if you try to mirror large parts of the database.

The terms of use are permissive and clear. Commercial use of the statistics is allowed, with exceptions announced on the site. Users must show the source and follow the statistics usage guidelines. Passing the received data unchanged to third parties for a fee without your own service platform is prohibited. The terms renew yearly. They also place responsibility on the user for checking notices about changes, and they let the provider pause or end the service for maintenance or replacement. For a production trading system, that last point means building your own monitoring.

FXMacroData's terms are commercial in the other direction: every plan covers your own and your team's internal use, and showing the data to outside users is handled by the self-serve Commercial Redistribution add-on at $10/month per block of up to 100 measured users, or up to 1,000 public-feed followers.

Why Korean Data Moves USD/KRW

The won is one of the most trade-sensitive major Asian currencies. Several Korean data streams feed a typical USD/KRW process. Inflation and the Bank of Korea base rate set the rate path against the Federal Reserve. Monthly trade and the balance of payments show dollar supply from exporters, and the Korea Customs Service publishes early export tallies for the first 10 and first 20 days of each month, which global investors read as a bellwether for the chip cycle. Growth, sentiment, household leverage, housing, and short-term rates complete the picture. FXMacroData covers that last group today; for CPI, jobs, and trade, use KOSIS, the Bank of Korea, or the customs service directly.

The useful view joins those Korean releases to US data, bond yields, and the pair itself. That is the work FXMacroData is built for. Korean GDP, the BSI and CCSI surveys, household credit, house prices, the 2-year KTB yield, and KOFR share one schema with US CPI and payrolls, so a single loop can compare the pair's two sides. The South Korea data hub lists the KRW series and their most recent releases.

Use-case storyboard: a USD/KRW release week

Plan

Pull the KRW and USD release calendar; flag the 06:00 KST Bank of Korea surveys and the next US CPI.

Capture

Store the KRW consumer or business survey row with its publication timestamp and prior value as it lands.

Deepen

Pull Korean CPI and the labour survey from KOSIS, down to the sub-item table if a print looks unusual.

Act

Feed the row to a model, alert, or MCP-connected assistant that compares it with US data and the USD/KRW move.

Takeaway: FXMacroData handles the timed, cross-currency part of the week for the series it carries; KOSIS supplies prices, jobs, and the detail behind each number.

API Example

FXMacroData sends the key in a header and uses the same path pattern for every currency. This request returns the Bank of Korea consumer sentiment (CCSI) announcement history:

curl -H "X-API-Key: YOUR_API_KEY" "https://api.fxmacrodata.com/v1/announcements/krw/consumer_confidence"

Example response (abridged to the September 2026 row):

{
  "currency": "KRW",
  "indicator": "consumer_confidence",
  "source": "Bank of Korea",
  "data": [
    {
      "date": "2026-09-30",
      "val": 53.3,
      "previous_value": 52.25,
      "previous_date": "2026-08-31",
      "change_from_previous": 1.05,
      "announcement_datetime": 1790110800,
      "announcement_datetime_local": "2026-09-23T06:00:00+09:00",
      "publication_time_status": "confirmed"
    }
  ]
}

The val is on FXMacroData's 0-100 normalised index scale. The full list of KRW indicator slugs comes from GET /v1/data_catalogue/krw, which also reports each series' history start and freshness.

FXMacroData row

  • announcement_datetime: the 06:00 KST publication, in epoch seconds.
  • val and previous_value: ready for surprise maths.
  • Same fields for USD, JPY, EUR, and every other currency.

KOSIS row

  • PRD_DE: the reference period, such as 202609.
  • DT: the value, returned as a string.
  • LST_CHN_DE: the last-changed date, with no time of day.

Takeaway: both rows describe an official Korean release. Only one of them records when it was published, which an intraday event study needs.

Where KOSIS Is Genuinely Stronger

For Korean statistics on their own terms, KOSIS is the better tool. It is the official portal, it is free, and the terms allow commercial use with attribution. It goes far deeper than any FX product: CPI by expenditure category and individual items, regional series, survey methodology, and table metadata that explains exactly what each number measures. Researchers who need a long, authoritative history or a precise citation should start there. SDMX output and English labels in the responses also make it workable for international data teams, despite the Korean-language portal.

KOSIS is also the right place for the data FXMacroData does not carry for KRW: consumer and producer prices, the labour force survey, industrial activity, and retail sales, each with the category detail that explains why a print moved.

Where FXMacroData Is Stronger

FXMacroData is stronger once Korea is one leg of a currency decision. You do not maintain table and item codes or watch a notice board for rebasing. Release-scheduled rows carry a publication time, flagged as confirmed or unverified, with a public speed record. Its seven KRW series share a schema with 21 other currencies, and the same key unlocks the calendar, FX spot rates, COT positioning, bond yields, central-bank press releases, and an MCP server that lets an AI trading assistant query it directly.

FXMacroData pros

  • Publication timestamps on release-scheduled rows, with a public speed record.
  • One schema across 22 currencies, including KRW and USD.
  • Calendar, pair dashboards, exports, and MCP in one plan.

FXMacroData tradeoffs

  • Paid plan required for KRW; the free tier is USD only.
  • Seven KRW series today; no Korean CPI, labour, trade, or policy-rate series yet.
  • Not the official publisher; cite the agency for official work.

KOSIS pros

  • Free, official, commercial use permitted with attribution.
  • Very deep table coverage and survey metadata.
  • SDMX and JSON output; English labels in responses.

KOSIS tradeoffs

  • Korean-language portal, guide, and application flow.
  • No publication timestamp on data rows.
  • Korea only; table codes to maintain; no FX or calendar layer.

Takeaway: KOSIS is the stronger statistics source. FXMacroData is the stronger choice when KRW data has to drive a timed, multi-currency trading process.

Decision Matrix

Reader Better fit Why
Korea economist or academic KOSIS Official tables, sub-items, regional detail, and metadata at no cost.
USD/KRW discretionary trader FXMacroData Calendar, pair dashboard, and timed KRW and USD releases in one place.
Quant building KRW event studies FXMacroData Publication timestamps on BOK survey, GDP, and credit rows make those releases joinable to tick data; CPI events still need KOSIS or the ministry release.
Asia multi-currency desk FXMacroData KRW, JPY, CNY, TWD, THB, MYR, and USD in one schema instead of six national APIs.
AI or automation builder FXMacroData MCP server, OpenAPI spec, and English docs reduce adapter work.
Research team working on Korean inflation or jobs KOSIS FXMacroData does not list KRW CPI or labour series; KOSIS has the headline and item-level tables.

Recommendation

Use KOSIS if your work is Korean statistics: you need CPI, labour, or industrial data, item-level detail, regional data, survey metadata, or an official citation, and you can live with a Korean-language portal and date-level update stamps. It is free, authoritative, and permits commercial use with attribution.

Use FXMacroData if Korean growth, sentiment, credit, housing, or short-rate data is an input to a currency decision. The Individual plan at $50/month (14-day trial) covers its seven KRW series alongside 21 other currencies, with publication timestamps, a calendar, pair dashboards, and MCP access. Check the KRW catalogue first to confirm the series you need are listed. Compare plans and pricing, review the API reference, and check the measured pickup times on the release-speed record before you commit.

Bottom line: KOSIS is the official, free, and deepest source of Korean statistics. FXMacroData carries a narrower set of Korean series and turns them into timestamped, cross-currency rows that a USD/KRW model, dashboard, or AI assistant can act on. Choose by the job: Korean prices, jobs, or a statistics project, KOSIS; a multi-currency workflow built on the series FXMacroData lists, FXMacroData.

Sources Checked

KOSIS OpenAPI service introduction

Services, formats, 200 calls/minute, 40,000 cells per request.

View source

KOSIS terms of use

Free provision, commercial use, attribution, and prohibited uses.

View source

KOSIS developer guide

Request parameters and response fields for statistical data.

View source

KOSIS OpenAPI home and notices

Table counts and 2026 notices on HTTPS and per-minute limits.

View source

FXMacroData KRW catalogue and API

KRW series list, history starts, and the rows used in the chart and example.

View KRW data

Bank of Korea ECOS Open API

Separate free, key-based API for Bank of Korea statistics.

View source

FXMacroData plans and docs

Plans, request limits, API reference, and MCP server.

View documentation

Takeaway: every KOSIS limit and term quoted here comes from the official portal pages above, and every FXMacroData KRW figure from the production API, checked in October 2026.

FXMacroData API data

Data endpoints used in this article

No FXMacroData API data endpoint is attributed to this article. Its evidence base is identified in the article and source links.

Explore the FXMacroData API reference

Frequently asked

Questions about this topic

Is the KOSIS OpenAPI free?

Yes. The KOSIS terms of use state that information is provided free of charge in principle. You need a KOSIS membership and an approved usage application to receive an API key. Fees apply only if you ask for delivery outside the standard service.

What are the KOSIS OpenAPI rate limits?

The KOSIS service-introduction page lists up to 200 calls per minute and up to 40,000 cells per request for each service. Bulk statistical data in XLS format allows up to 200,000 cells per request.

Can KOSIS data be used commercially?

The KOSIS terms allow commercial use of the statistics, with exceptions announced on the site. Users must display the source. Passing the received data unchanged to third parties for a fee without your own service platform is prohibited.

Which Korean series does FXMacroData cover?

FXMacroData's KRW catalogue currently lists seven series: real GDP, the Bank of Korea business survey (BSI) and consumer survey (CCSI), household credit, the house purchase price index, the 2-year Korea Treasury Bond yield, and the KOFR overnight repo rate. It does not yet list Korean CPI, labour, trade, or policy-rate series; for those, use KOSIS or the publishing agency.

Should a KRW trader use KOSIS or FXMacroData?

Use KOSIS for free, official Korean statistics, including CPI, labour, and industrial data, item-level detail, and research citation. Use FXMacroData when its KRW series (GDP, BOK surveys, household credit, house prices, 2-year KTB, KOFR) feed a USD/KRW or multi-currency workflow that needs publication timestamps, a calendar, one schema across 22 currencies, and MCP access. Many teams use both.

Does FXMacroData use the same Korean data as KOSIS?

FXMacroData reads official Korean sources directly: the Bank of Korea for GDP, the BSI and CCSI surveys, household credit, the 2-year KTB yield, and KOFR, and the Korea Real Estate Board for house prices. It adds publication timestamps where the release is scheduled, prior values, and source metadata to each row. It does not currently carry the Ministry of Data and Statistics CPI or labour series that KOSIS publishes.

Keep reading

Blogroll

AI Answer-Ready

Key Facts

Page
FXMacroData vs KOSIS API: Korean Macro Data for KRW Traders
Section
Articles
Canonical URL
https://fxmacrodata.com/articles/fxmacrodata-vs-kosis-api
Source
FXMacroData editorial and official publisher references
Last Updated
2026-10-05 22:59 UTC

Provenance And Trust

Cite the canonical URL and source field above. Where available, this page maps to official publisher releases and timestamped updates.

Quick Q&A

Is the KOSIS OpenAPI free? Yes. The KOSIS terms of use state that information is provided free of charge in principle. You need a KOSIS membership and an approved usage application to receive an API key. Fees apply only if you ask for delivery outside the standard service.

What are the KOSIS OpenAPI rate limits? The KOSIS service-introduction page lists up to 200 calls per minute and up to 40,000 cells per request for each service. Bulk statistical data in XLS format allows up to 200,000 cells per request.

Can KOSIS data be used commercially? The KOSIS terms allow commercial use of the statistics, with exceptions announced on the site. Users must display the source. Passing the received data unchanged to third parties for a fee without your own service platform is prohibited.

Which Korean series does FXMacroData cover? FXMacroData's KRW catalogue currently lists seven series: real GDP, the Bank of Korea business survey (BSI) and consumer survey (CCSI), household credit, the house purchase price index, the 2-year Korea Treasury Bond yield, and the KOFR overnight repo rate. It does not yet list Korean CPI, labour, trade, or policy-rate series; for those, use KOSIS or the publishing agency.

Prompt Packs

Use these in ChatGPT, Claude, Gemini, Mistral, Perplexity, or Grok for consistent source-aware outputs.