API documentation

The Standard API provides eleven source-verified reported financial metrics and five separately calculated key metrics from DART filings. It also includes company identity, reporting periods, coverage, statement lines, and filing links. Coverage is limited to Core 300 plus AI Value Chain companies, retaining the latest eight reporting slots. Access is currently a manually approved pilot for server-side integrations.

Public subscriptions are coming soon; checkout is not available yet. Get an API launch notification. Existing pilot users can find access dates and billing details in Plan & billing.

Send your API key in one of the accepted request headers. Keep keys server-side and rotate any key that is no longer tied to an active integration.

Authorization: Bearer <api-key>
x-api-key: <api-key>

Store your active key in the server environment as KOREANTICKERS_API_KEY. This example requests Samsung Electronics (005930); fundamentals is the compact starting point for most integrations. The JavaScript example runs on your server, not in a browser.

curl https://www.koreantickers.com/v1/companies/005930/fundamentals \
  -H "Authorization: Bearer $KOREANTICKERS_API_KEY" \
  -H "Accept: application/json"

const response = await fetch(
  "https://www.koreantickers.com/v1/companies/005930/fundamentals",
  {
    headers: {
      Authorization: `Bearer ${process.env.KOREANTICKERS_API_KEY}`,
      Accept: "application/json"
    }
  }
);

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error?.code ?? "koreantickers_error");
}

const data = await response.json();
const revenue = data.financials.metrics.revenue;
if (revenue.available) console.log(revenue.amount);

GET /v1/companies returns the full Core 300 plus AI Value Chain membership list. It is included in the same Standard plan, uses the same authentication and shared quota, and takes no query parameters or pagination.

curl https://www.koreantickers.com/v1/companies \
  -H "Authorization: Bearer $KOREANTICKERS_API_KEY" \
  -H "Accept: application/json"

This is a versioned coverage snapshot, not a continuously ranked list. Companies in both groups appear once. The website may show additional companies that are not available through the API; use this directory before scheduling a data refresh.

After choosing a ticker from the company directory, use these 7 company-level GET endpoints. All are included in Standard and share the same access grant and quota.

Successful responses include apiVersion, generatedAt, and requestId. Company-level endpoints also identify the selected ticker and Standard product. The fundamentals example below is abbreviated; use the OpenAPI schema for each endpoint's full shape.

The company directory uses standard-universe.v1 and returns coverage metadata with companies[], rather than a single ticker or product object. Calculated indicators use dart-key-financials.v1; the other company-level endpoints use dart-fundamentals.v0.2.

Abbreviated historical example, not a current-data quote. The full response retains all eleven metric keys.

{
  "apiVersion": "dart-fundamentals.v0.2",
  "dataContract": "dart-reported-financials.v1",
  "generatedAt": "2026-06-05T04:24:44.473Z",
  "requestId": "7f98db8b-...",
  "product": {
    "key": "standard_fundamentals",
    "label": "Standard API",
    "requiresContext": false
  },
  "ticker": "005930",
  "company": {
    "ticker": "005930",
    "corpCode": "00126380",
    "companyName": "Samsung Electronics Co., Ltd.",
    "listedNameKo": "삼성전자",
    "market": "KOSPI",
    "marketCapKrw": null,
    "marketCapAsOf": null,
    "marketCapSource": null,
    "marketCapCollectedAt": null
  },
  "financials": {
    "latestPeriod": {
      "fiscalYear": 2026,
      "fiscalQuarter": 1,
      "reportCode": "11013",
      "reportName": "1Q Report (2026)",
      "fsDiv": "CFS",
      "fsName": "Consolidated financial statements",
      "periodEnd": "2026-03-31",
      "rceptNo": "20260515002181",
      "filingDate": "20260515",
      "sourceEndpoint": "xbrlIfrsFastPath",
      "currency": "KRW"
    },
    "dataCompleteness": {
      "accountIdCoveragePct": 72.1,
      "latestCoreMetricCoveragePct": 95.8,
      "latestHardMetricCoveragePct": 100,
      "missingHardMetrics": []
    },
    "metrics": {
      "revenue": {
        "metricKey": "revenue",
        "available": true,
        "amount": 133873444000000,
        "currency": "KRW",
        "unit": "currency",
        "valueSource": "reported",
        "sourceAccountId": "ifrs-full_Revenue",
        "sourceAccountName": "Revenue",
        "missingReason": null,
        "missingReasonDetail": null
      }
    }
  }
}

The response shape and eleven fundamentals keys stay fixed across issuers. metricProfile changes only the required readiness set, so banks, holding companies, and SPACs are not penalized for operating-company fields that are not meaningful to their profile. Calculated indicators do not determine basic-fact readiness.

A missing metric is not an API error. Metric keys stay present so customers can use one schema across companies. Check available before reading amount.

{
  "metricKey": "operating_cash_flow",
  "available": false,
  "amount": null,
  "missingReason": "source_not_reported",
  "missingReasonDetail": "The selected DART statement scope does not report this line item for the selected period.",
  "currency": null,
  "unit": null,
  "valueSource": null,
  "sourceAccountId": null,
  "formulaKey": null
}

Limits apply to an access grant and are shared by every linked key and endpoint, including the company directory. Response headers are authoritative for the current request and may differ from the default plan values. Daily windows reset at midnight Korea Standard Time; use headers to manage queues and retries.

Customer usage is counted globally in fixed-minute and KST-day windows. If the metering service is unavailable, requests return 503 rate_limit_store_unavailable with Retry-After instead of proceeding without metering. Reaching a limit does not trigger an automatic overage charge.

Quota is reserved after a credential and active grant pass authentication but before endpoint validation and data work. That authenticated attempt therefore counts even if later processing returns a 4xx or 5xx response. Requests rejected before reservation—such as 401, 403, an already exhausted 429, or metering-store 503—do not consume another slot. Use the returned rate-limit headers as the authoritative result.

x-ratelimit-limit: 120
x-ratelimit-remaining: 118
x-ratelimit-reset: 1780633564
x-ratelimit-daily-limit: 3000
x-ratelimit-daily-remaining: 2868
x-ratelimit-daily-reset: 1780671600
x-ratelimit-scope: global

Authenticated responses are delivered with cache-control: private, no-cache, no-store, max-age=0, must-revalidate and CDN no-store headers. Do not place raw responses in a shared intermediary cache. Approved pilot users may retain facts only for the use permitted by their pilot agreement and the Terms; raw bulk redistribution requires written permission.

Error responses use HTTP status for broad handling and a stable error.code for programmatic handling. The requestId should be included when reporting an issue.

{
  "error": {
    "code": "unauthorized",
    "message": "Send an API key with Authorization: Bearer <key> or x-api-key.",
    "requestId": "31bedab6-64ca-464a-8906-a5e07b6132af"
  },
  "generatedAt": "2026-06-05T04:25:01.972Z"
}

Standard API data is filing-backed. It updates after DART filings are collected and normalized, not on a quote-feed cadence, and the manual pilot has no guaranteed publication-to-API latency. generatedAt is the response time; numeric fetchedAt and updatedAt fields are Unix milliseconds when present. Use latestPeriod, rceptNo, sourceUrl, and the source timestamps to detect revisions.

Use /periods to discover the currently retained history window and /coverage to inspect ticker-scoped dataset counts and timestamp maxima before a scheduled refresh. A dataset row count is null when its serving table is unavailable, zero only when the table was checked and has no rows for that ticker, and never converted into an invented data value.

Standard retains up to the latest eight fiscal reporting quarter slots per ticker: Q1, Q2/H1, Q3/9M, and Q4/annual, with CFS and OFS sharing one slot. Source statements may be cumulative or annual, so this does not promise eight standalone quarterly statements. After a new complete slot is published and validated, older normalized rows roll out of the eight-slot window. Read retentionPolicy and historyWindow.logicalPeriodCount on /periods or /coverage; Standard is not a bulk or long-term archive.

Source lineage is period-aware. Reported values include DART account fields when available; derived values include a formula key and should be identified as Korean Tickers normalized calculations. Preserve the required source attribution and the receipt number or DART source URL supplied with period or row provenance when presenting a filing-derived number.

English-label precedence is explicit: exact official English OpenDART line, latest official English taxonomy label, canonical metric label, then account-ID/source fallback. Raw Korean statement, account, and detail labels stay in separate source fields. The API does not label machine-translated raw account text as an official source label.

Unit semantics are separate from currency. Monetary facts use unit=currency plus the source ISO currency code. Percentage-point and ratio-multiple facts use unit=pct or unit=ratio with currency=null. The API does not imply currency conversion.

Fundamentals returns 11 reported metrics for the selected period. Financial-facts returns the same 11 metrics across retained periods. Neither endpoint substitutes synthetic totals or calculated ratios for reported values.

The machine-readable catalog defines every metric label, category, statement family, unit, duration, allowed value sources, derivation formula, and source-label policy.

Standard API is a DART-derived fundamentals product. It is not a market-data, research-report, or advice product.