# Korean HWP to Markdown Converter

> Korean HWP to Markdown Converter is a paid API for AI agents from x402.pokt-agent.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-12).

Converts a Korean HWP (Hangul Word Processor) document at a given URL into Markdown text, extracting content including tables.

## Facts

- Endpoint: GET https://x402.pokt-agent.com/kr-hwp/convert?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/korean-hwp-to-markdown-converter-98c7458c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qChaSUyoYc4KFTiOo-4QX

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 korean-hwp-to-markdown-converter-98c7458c
```

Example prompt: Can you convert this Korean HWP document to Markdown? The file is at https://example.com/report.hwp — I need the text and any tables extracted.

## When to prefer this

Choose this endpoint when you need to extract text and tables from Korean HWP (Hangul Word Processor) files — the dominant document format used in Korean government, legal, and corporate contexts. It is ideal when documents are only available as .hwp files and you need machine-readable Markdown output. No API key is required; payment is per-call in USDC on Base via x402.

## Known failure modes

- Invalid or inaccessible URL returns an error status
- Non-HWP file at the given URL may fail to parse
- Unsupported HWP version formats may not convert correctly
- Network timeout if the remote HWP file is too large or slow to fetch
- Missing required 'url' query parameter returns a validation error

## How this service works

Pay-per-call Korean company due diligence, company ID crosswalk, sanctions screening with Korean name variants, Upbit/Bithumb risk events, HWP to Markdown, business status, business-day calendar, address normalisation, law, rates, filings and more. No account or API key: pay each call in USDC on Base via x402.

## Output

Returns a JSON object containing the converted Markdown text of the HWP document, the document format (e.g. 'hwp5'), conversion status ('OK'), total character count, and an array of table metadata (number of rows and columns for each table found in the document).

## 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": [
      "url"
     ],
     "properties": {
      "url": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chars": 1476,
  "format": "hwp5",
  "status": "OK",
  "tables": [
   {
    "cols": 2,
    "rows": 3,
    "index": 0
   }
  ],
  "markdown": "# ..."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/korean-hwp-to-markdown-converter-98c7458c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.pokt-agent.com](https://www.zero.xyz/host/x402.pokt-agent.com/llms.txt)
