# Korea FX Rates (KR Rates)

> Korea FX Rates (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).

Returns official Korean won foreign exchange rates (TTB, TTS, deal basis) for a given currency and date from KEXIM.

## Facts

- Endpoint: GET https://x402.pokt-agent.com/kr-rates/fx?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/korea-fx-rates-kr-rates-c9d1e90c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4h9haYiXIPgEwW6zgCjvZ

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-fx-rates-kr-rates-c9d1e90c
```

Example prompt: What are the official Korean won exchange rates for USD today — including the buying rate (TTB), selling rate (TTS), and deal basis from KEXIM?

## When to prefer this

Choose this endpoint when you need official, authoritative Korean won exchange rates sourced directly from KEXIM (Korea Eximbank), especially for cross-border trade, compliance, or financial reporting involving KRW. Prefer this over generic FX APIs when Korean regulatory or official rate accuracy matters, or when you need historical KRW rates for a specific date.

## Known failure modes

- Missing or invalid 'ccy' parameter returns a validation error
- Unsupported currency codes not covered by KEXIM return no data or an error
- Requesting a date that falls on a Korean non-business day may return the nearest available rate or an error
- Payment failure via x402/USDC on Base results in 402 response and no data returned
- Future dates beyond available data return no results

## 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 with the currency code (ccy), the TTB (telegraphic transfer buying) rate, TTS (telegraphic transfer selling) rate, deal basis rate, the date of the rate, and the source (KEXIM). All rates are expressed in Korean won per unit of the requested currency.

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ccy": "USD",
  "ttb": 1366.7,
  "tts": 1394.3,
  "date": "2026-10-10",
  "source": "KEXIM",
  "deal_basis": 1380.5
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/korea-fx-rates-kr-rates-c9d1e90c/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)