Api Endpoint

korea-ratios

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.

Open interactive test console

Offering

Provider
payai.agentstools.dev
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Financial Analysis
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://payai.agentstools.dev/korea/ratios
MIME type
application/json
First seen
2026-10-16T02:01:07.550Z
Last seen
Tags
korea, dart, ratios, margins, Liquidity, leverage, growth, fundamentals, due-diligence, kospi, kosdaq, opendart

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.02 USDC
Atomic price: 20000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 2
0.02 USDC
Atomic price: 20000 · Network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "20000",
    "payTo": "0xF22e558a00D91Ee12A1F50C52186FecB8dDFf493"
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "20000",
    "payTo": "AytHnvc6bZx1ALTy7b5Px7hcavoSYszG9aeKvDcZ8R1u"
  }
]

Observed health

Status
Healthy
Latest latency
362 ms
Average latency
1052 ms
HTTP status
402
Last checked
Reachability
100% over 9 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET",
        "HEAD",
        "DELETE"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {
        "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"
        },
        "name": {
          "type": "string",
          "description": "Company name in English or Korean"
        },
        "year": {
          "type": "integer",
          "minimum": 2015,
          "description": "Business (fiscal) year, 2015 or later"
        },
        "report": {
          "type": "string",
          "enum": [
            "annual",
            "half",
            "q1",
            "q3"
          ],
          "description": "Report period, default annual"
        },
        "basis": {
          "type": "string",
          "enum": [
            "consolidated",
            "separate"
          ],
          "description": "Statement basis, default consolidated"
        }
      },
      "required": [
        "year"
      ]
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "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"
        }
      }
    }
  }
}