# Korean Financial Rates Query (kr-rates)

> Korean Financial Rates Query (kr-rates) is a paid API for AI agents from x402.pokt-agent.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-12).

Retrieves Korean financial rates (e.g. USD/KRW exchange rates) for a given date or natural-language question, sourced from KEXIM and other Korean financial authorities, with per-call USDC micropayment via x402.

## Facts

- Endpoint: POST https://x402.pokt-agent.com/kr-rates/query?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/korean-financial-rates-query-kr-rates-18137136
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_B3X3iEa4xJ3ti_nwLxO4h

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-financial-rates-query-kr-rates-18137136 -d '<json body>'
```

Example prompt: What was the official USD to KRW exchange rate on October 10, 2026 according to KEXIM?

## When to prefer this

Use this endpoint when you need official Korean exchange rates (especially USDKRW from KEXIM) for a specific date, whether for invoicing, accounting, compliance, or FX conversion. Prefer this over generic FX APIs when Korean regulatory or institutional sourcing is required, or when you need historical rates aligned with Korean business-day calendars. The x402 micropayment model means no API key or account setup is needed.

## Known failure modes

- Date falls on a Korean public holiday or non-business day — no rate available for that date
- Unsupported currency pair or rate series — empty or error response
- Ambiguous natural language question — may return unexpected series
- Payment failure via x402/USDC — call rejected before processing
- Date in the future beyond available forward data — no result

## 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 array of rate items, each containing a date string, a numeric rate value (e.g. 1380.5), a series identifier (e.g. 'USDKRW'), and the source institution (e.g. 'KEXIM'). Suitable for use in financial calculations, compliance documentation, or FX conversion.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "date": {
   "type": "string"
  },
  "question": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "date": "2026-10-10",
    "value": 1380.5,
    "series": "USDKRW",
    "source": "KEXIM"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/korean-financial-rates-query-kr-rates-18137136/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)