# Korea DART Financial Ratios

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

Computes key financial ratios (margins, returns, liquidity, leverage, growth) from Korea DART filings for a given company and fiscal year, with source account citations and anomaly flags.

## Facts

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

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-4af95ded
```

Example prompt: Pull the key financial ratios for Samsung Electronics (ticker 005930) from its 2022 annual consolidated DART filing — I want margins, returns, liquidity and leverage, and flag anything that looks anomalous.

## When to prefer this

Use this endpoint when you need pre-computed, citation-backed financial ratios derived directly from official Korean DART filings, especially when you want anomaly detection built in. Prefer this over raw DART data endpoints when you need ratios (not raw financials), and over generic financial data providers when you need traceability to source DART accounts for Korean-listed companies.

## Known failure modes

- Company not found in DART when name/ticker/corp_code is ambiguous or incorrect — returns 404 or empty match
- Requested fiscal year earlier than 2015 — rejected by schema validation
- DART filing not yet available for the requested year or report period — returns data-not-found error
- Separate statement not available for some companies — falls back or errors if basis=separate is forced
- Rate limit or payment failure for x402 micropayment — returns 402 Payment Required

## 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 (profit margins, return metrics, liquidity ratios, leverage ratios, growth rates), each annotated with the source DART filing accounts used in the calculation, plus simple anomaly flags for values 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-4af95ded/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentstools.dev](https://www.zero.xyz/host/api.agentstools.dev/llms.txt)