# Ralph KR Disclosures API

> Ralph KR Disclosures API is a paid API for AI agents from ralph-crypto-summary.simgokr.workers.dev, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-13).

Returns Korean stock market (KOSPI/KOSDAQ) regulatory disclosure events for a given date, categorized by event type such as share buybacks, filtered optionally by category.

## Facts

- Endpoint: GET https://ralph-crypto-summary.simgokr.workers.dev/api/kr-disclosures?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ralph-kr-disclosures-api-3ecdd700
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_21N3bB1wrr1DF_Kg01oLt

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 ralph-kr-disclosures-api-3ecdd700
```

Example prompt: What share buyback disclosures were filed on the Korean stock market today? Pull the DART filings for today's date in KST and filter by share_buyback category.

## When to prefer this

Use this endpoint when you need structured, categorized Korean stock market regulatory disclosure data (DART filings) for a specific date, particularly for corporate action categories like share buybacks. Prefer this over general web scraping of DART when you need clean JSON output with categorization. Best for monitoring Korean market corporate events on a daily or ad-hoc basis.

## Known failure modes

- No disclosures for a given date (e.g. weekend or holiday) — returns empty events array
- Invalid date format returns an error
- Unrecognized category key may return empty results rather than an error
- Payment failure via x402 if USDC balance is insufficient — 402 response before data is returned
- DART source unavailable causing stale or missing data

## How this service works

Pay-per-call crypto market and Base wallet summaries via x402 (USDC on Base).

## Output

A JSON object containing a list of disclosure events for the specified date, each with company name in Korean, stock code, market (KOSPI/KOSDAQ), category key and label, and a link to the DART source filing. Also includes total event count and a breakdown of counts by category.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "date": {
       "type": "string",
       "description": "Date YYYYMMDD in KST (default: today)"
      },
      "category": {
       "type": "string",
       "description": "Optional category key, e.g. share_buyback"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "events": [
   {
    "market": "KOSPI",
    "category": "share_buyback",
    "company_ko": "삼성전자",
    "source_url": "https://dart.fss.or.kr/dsaf001/main.do?rcpNo=...",
    "stock_code": "005930",
    "category_label": "Share buyback (treasury stock acquisition) decision"
   }
  ],
  "date_kst": "20260918",
  "event_count": 1,
  "counts_by_category": {
   "share_buyback": 1
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ralph-kr-disclosures-api-3ecdd700/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ralph-crypto-summary.simgokr.workers.dev](https://www.zero.xyz/host/ralph-crypto-summary.simgokr.workers.dev/llms.txt)