krw-jpy-ratelisted

# krw-jpy-rate ウォン・円の為替レートを、韓国の公式な無料APIから取得するスキル。2つの独立ソースを持ち、片方が落ちても代替できる。 - ソースA: 韓国輸出入銀行(KEXIM) 現在環율API — 旅行・両替の実務で標準的に使われる。JPY(100)を直接返す。 - ソースB: 韓国銀行(BOK) ECOS API — 国家の公式統計。2026-09-09 にサンプルキーで実データ取得を実測確認(원/엔(100엔) 매매기준율 871.54)。 どちらも無料キーが必要。発行はどちらも即時・無料。 ## キーの取得 - **KEXIM**: 韓国輸出入銀行サイトで会員登録後、オープンAPI認証キーを即時発行。公共データポータルにも登録済み: https://www.data.go.kr/data/3068846/openapi.do - **ECOS**: https://ecos.bok.or.kr/ で会員登録後、オープンAPI認証キーを即時発行。 ## ソースA: KEXIM 現在환율API ```bash curl -s "https://www.koreaexim.go.kr/site/program/financial/exchangeJSON?authkey={KEXIM_KEY}&searchdate=${RATE_DATE}&data=AP01" ``` - `searchdate`: 調べたい日付(YYYYMMDD)。当日11時前は前営業日のデータになる。土日・韓国の祝日はデータなし(直前営業日を指定する)。 - `data=AP01`: 現在환율(全通貨)。 - レスポンスは配列。JPYの行は `cur_unit` が `"JPY(100)"`(100円あたりのウォン)。 - `deal_bas_r`: 매매기준율(仲値)。「1万ウォンは何円?」の概算にはこれを使う。 - `ttb` / `tts`: 電信買相場/売相場。両替・送金の方向に応じて使い分ける。 - 計算例: `deal_bas_r` が 871.54 なら 100円 = 871.54ウォン。1万ウォン ≒ 10000 ÷ 871.54 × 100 ≒ 1,147円。 **レスポンス例**: `examples/kexim-exchangejson.sample.json`(KEXIMは海外IPを遮断するため構造を再現した記述例) / `examples/ecos-key-statistic-list.sample.json`(2026-09-10にサンプルキーで実測取得した実データ)。 ## ソースB: ECOS(韓国銀行) 主要統計100の一覧に円レートが含まれる。手軽に検証できるのが利点。 ```bash curl -s "https://ecos.bok.or.kr/api/KeyStatisticList/{ECOS_KEY}/json/kr/1/10" ``` - レスポンスの `KeyStatisticList.row` 配列に `원/엔(100엔) 환율(매매기준율)` と `원/달러 환율(종가)` が入る。`DATA_VALUE` が値、`TIME` が基準日。 - 時系列が必要なら `StatisticSearch` を使う(統計表・項目コードはECOSサイトで確認する)。 ## どちらを使うか - 両替・送金の実務寄りの相場(ttb/tts)が要る → KEXIM。 - 国家統計として