# Korea DART Financial Ratios

> Korea DART Financial Ratios is a paid API for AI agents from payai.agentstools.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Retrieves computed key financial ratios (margins, returns, liquidity, leverage, growth) for Korean-listed companies from DART filings, with source account citations and anomaly flags.

## Facts

- Endpoint: GET https://payai.agentstools.dev/korea/ratios
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/korea-dart-financial-ratios-08db7b08
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cRD02OLGVsHLHolxWX-BB

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability korea-dart-financial-ratios-08db7b08
```

Example prompt: Pull the key financial ratios for Samsung Electronics (ticker 005930) for fiscal year 2023 on a consolidated basis — I want margins, returns, liquidity, leverage, and growth, and flag anything that looks anomalous.

## When to prefer this

Use this endpoint when you need structured, ratio-level financial analysis for South Korean listed companies sourced directly from official DART regulatory filings. It is preferable over raw balance sheet endpoints when you need computed metrics with source citations rather than raw line items, and over generic financial data APIs when DART-specific accuracy and anomaly detection matter.

## Known failure modes

- Company not found in DART — invalid ticker, corp code, or name returns an error
- Year before 2015 minimum is rejected
- DART filing not yet available for the requested year/period
- No consolidated statements available — may need to switch to separate basis
- Ambiguous company name matching multiple DART entries

## How this service works

Key financial ratios computed from Korea DART filings: margins, returns, liquidity, leverage and growth. Give a ticker, corp code or name plus a year and get ratios, each number citing the source accounts it was derived from, plus simple anomaly flags.

## Output

A structured object containing computed financial ratios grouped by category (margins, returns, liquidity, leverage, growth), each ratio annotated with the source DART accounting line items used to derive it, plus simple anomaly flags highlighting metrics that fall outside expected ranges.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "year"
     ],
     "properties": {
      "name": {
       "type": "string",
       "description": "Company name in English or Korean"
      },
      "year": {
       "type": "integer",
       "minimum": 2015,
       "description": "Business (fiscal) year, 2015 or later"
      },
      "basis": {
       "enum": [
        "consolidated",
        "separate"
       ],
       "type": "string",
       "description": "Statement basis, default consolidated"
      },
      "report": {
       "enum": [
        "annual",
        "half",
        "q1",
        "q3"
       ],
       "type": "string",
       "description": "Report period, default annual"
      },
      "ticker": {
       "type": "string",
       "description": "6-digit Korean stock code, e.g. 005930"
      },
      "corp_code": {
       "type": "string",
       "description": "8-digit DART corp code, e.g. 00126380"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/korea-dart-financial-ratios-08db7b08/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from payai.agentstools.dev](https://www.zero.xyz/host/payai.agentstools.dev/llms.txt)