Korean Rates and FX

finance

Serving

Official Korean interest rates and won exchange rates: Bank of Korea base, call, KOFR, CD, CP and the KTB curve 1y-50y (ECOS); KRW deal basis, TTB and TTS (Export-Import Bank of Korea); weekly customs FX; indicative conversion. Each value is dated and sourced, no forecasts. GET /v1/rates, /v1/rate, /v1/fx, /v1/convert, /v1/customs-fx or POST /v1/query.

Endpoint: POST https://test.agent.pocket.network/v1/kr-rates-fx-v1/v1/query
Price per call: $0.005 USD
Networks payable on: Base Sepolia (eip155:84532)
Protocol: rest

Calling it

The first call returns 402 Payment Required with the terms. Sign for those terms and retry the same request with the payment attached.

Example request

A real, working call — the request the service card verifies against.

curl -X POST https://test.agent.pocket.network/v1/kr-rates-fx-v1/v1/query \
  -H 'content-type: application/json' \
  -d '{"question":"국고채 3년 금리"}'

Example response

The response this call returned, captured 2026-10-15 12:12:55 UTC.

{
  "portal": {
    "provenance": "third-party-supplier",
    "serviceId": "kr-rates-fx-v1",
    "schemaCheck": "unchecked"
  },
  "data": {
    "schema": "kr-rates-fx-answer/v1",
    "service": "kr-rates-fx-v1",
    "intent": "RATES",
    "question": "국고채 3년 금리",
    "status": "OK",
    "focus": {
      "id": "ktb3y",
      "name_ko": "국고채(3년)",
      "name_en": "KTB 3-year",
      "unit": "% per year",
      "source": "Bank of Korea ECOS 817Y002/010200000",
      "status": "OK",
      "date": "2026-10-15",
      "value": 3.867,
      "prev_date": "2026-10-14",
      "prev_value": 3.883,
      "change_bp": -1.6
    },
    "data": {
      "schema": "kr-rates/v1",
      "service": "kr-rates-fx-v1",
      "as_of_request": "2026-10-15",
      "latest_observation": "2026-10-15",
      "series": {
        "base": {
          "id": "base",
          "name_ko": "한국은행 기준금리",
          "name_en": "BoK base rate",
          "unit": "% per year",
          "source": "Bank of Korea ECOS 722Y001/0101000",
          "status": "OK",
          "date": "2026-10-08",
          "value": 3,
          "prev_date": "2026-10-07",
          "prev_value": 3,
          "change_bp": 0
        },
        "call": {
          "id": "call",
          "name_ko": "콜금리(1일)",
          "name_en": "Call rate, overnight",
          "unit": "% per year",
          "source": "Bank of Korea ECOS 817Y002/010101000",
          "status": "OK",
          "date": "2026-10-14",
          "value": 3.041,
          "prev_date": "2026-10-13",
          "prev_value": 3.06,
          "change_bp": -1.9
        },
        "kofr": {
          "id": "kofr",
          "name_ko": "KOFR",
          "name_en": "KOFR (Korea overnight financing repo rate)",
          "unit": "% per year",
          "source": "Bank of Korea ECOS 817Y002/010901000",
          "status": "OK",
          "date": "2026-10-14",
          "value": 3.043,
          "prev_date": "2026-10-13",
          "prev_value": 3.066,
          "change_bp": -2.3
        },
        "cd91": {
          "id": "cd91",
          "name_ko": "CD(91일)",
          "name_en": "CD 91-day",
          "unit": "% per year",
          "source": "Bank of Korea ECOS 817Y002/010502000",
          "status": "OK",
          "date": "2026-10-15",
          "value": 3.25,
          "prev_date": "2026-10-14",
          "prev_value": 3.25,
          "change_bp": 0
        },
        "cp91": {
          "id": "cp91",
          "name_ko": "CP(91일)",
          "name_en": "CP 91-day",
          "unit": "% per year",
          "source": "Bank of Korea ECOS 817Y002/010503000",
          "status": "OK",
          "date": "2026-10-15",
          "value": 3.69,
          "prev_date": "2026-10-14",
          "prev_value": 3.66,
          "change_bp": 3
        },
        "msb91d": {
          "id": "msb91d",
          "name_ko": "통안증권(91일)",
          "name_en": "MSB 91-day",
          "unit": "% per year",
          "source": "Bank of Korea ECOS 817Y002/010400000",
          "status": "OK",
          "date": "2026-10-15",
          "value": 3.163,
          "prev_date": "2026-10-14",
          "prev_value": 3.165,
          "change_bp": -0.2
        },
        "msb1y": {
          "id": "msb1y",
          "name_ko": "통안증권(1년)",
          "name_en": "MSB 1-year",
          "unit": "% per year",
          "source": "Bank of Korea ECOS 817Y002/010400001",
          "status": "OK",
          "date": "2026-10-15",
          "value": 3.54,
          "prev_date": "2026-10-14",
          "prev_value": 3.54,
          "change_bp": 0
        },
        "msb2y": {
          "id": "msb2y",
          "name_ko": "통안증권(2년)",
          "name_en": "MSB 2-year",
          "unit": "% per year",
          "source": "Bank of Korea ECOS 817Y002/010400002",
          "status": "OK",
          "date": "2026-10-15",
          "value": 3.847,
          "prev_date": "2026-10-14",
          "prev_value": 3.85,
          "change_bp": -0.3
        },
        "ktb1y": {
          "id": "ktb1y",
          "name_ko": "국고채(1년)",
          "name_en": "KTB 1-year",
          "unit": "% per year",
          "source": "Bank of Korea ECOS 817Y002/010190000",
          "status": "OK",
          "date": "2026-10-15",
          "value": 3.7,
          "prev_date": "2026-10-14",
          "prev_value": 3.705,
          "change_bp": -0.5
        },
        "ktb2y": {
          "id": "ktb2y",
          "name_ko": "국고채(2년)",
          "name_en": "KTB 2-year",
          "unit": "% per year",
          "source": "Bank of Korea ECOS 817Y002/010195000",
          "status": "OK",
          "date": "2026-10-15",
          "value": 3.825,
          "prev_date": "2026-10-14",
          "prev_value": 3.833,
          "change_bp": -0.8
        },
        "ktb3y": {
          "id": "ktb3y",
          "name_ko": "국고채(3년)",
          "name_en": "KTB 3-year",
          "unit": "% per year",
          "source": "Bank of Korea ECOS 817Y002/010200000",
          "status": "OK",
          "date": "2026-10-15",
          "value": 3.867,
          "prev_date": "2026-10-14",
          "prev_value": 3.883,
          "change_bp": -1.6
        },
        "ktb5y": {
          "id": "ktb5y",
          "name_ko": "국고채(5년)",
          "name_en": "KTB 5-year",
          "unit": "% per year",
          "source": "Bank of Korea ECOS 817Y002/010200001",
          "status": "OK",
          "date": "2026-10-15",
          "value": 4.007,
          "prev_date": "2026-10-14",
          "prev_value": 4.047,
          "change_bp": -4
        },
        "ktb10y": {
          "id": "ktb10y",
          "name_ko": "국고채(10년)",
          "name_en": "KTB 10-year",
          "unit": "% per year",
          "source": "Bank of Korea ECOS 817Y002/010210000",
          "status": "OK",
          "date": "2026-10-15",
          "value": 4.193,
          "prev_date": "2026-10-14",
          "prev_value": 4.261,
          "change_bp": -6.8
        },
        "ktb20y": {
          "id": "ktb20y",
          "name_ko": "국고채(20년)",
          "name_en": "KTB 20-year",
          "unit": "% per year",
          "source": "Bank of Korea ECOS 817Y002/010220000",
          "status": "OK",
          "date": "2026-10-15",
          "value": 4.237,
          "prev_date": "2026-10-14",
          "prev_value": 4.296,
          "change_bp": -5.9
        },
        "ktb30y": {
          "id": "ktb30y",
          "name_ko": "국고채(30년)",
          "name_en": "KTB 30-year",
          "unit": "% per year",
          "source": "Bank of Korea ECOS 817Y002/010230000",
          "status": "OK",
          "date": "2026-10-15",
          "value": 4.289,
          "prev_date": "2026-10-14",
          "prev_value": 4.338,
          "change_bp": -4.9
        },
        "ktb50y": {
          "id": "ktb50y",
          "name_ko": "국고채(50년)",
          "name_en": "KTB 50-year",
          "unit": "% per year",
          "source": "Bank of Korea ECOS 817Y002/010240000",
          "status": "OK",
          "date": "2026-10-15",
          "value": 4.315,
          "prev_date": "2026-10-14",
          "prev_value": 4.366,
          "change_bp": -5.1
        },
        "corp3y_aa": {
          "id": "corp3y_aa",
          "name_ko": "회사채(3년, AA-)",
          "name_en": "Corporate 3-year AA-",
          "unit": "% per year",
          "source": "Bank of Korea ECOS 817Y002/010300000",
          "status": "OK",
          "date": "2026-10-15",
          "value": 4.559,
          "prev_date": "2026-10-14",
          "prev_value": 4.57,
          "change_bp": -1.1
        },
        "corp3y_bbb": {
          "id": "corp3y_bbb",
          "name_ko": "회사채(3년, BBB-)",
          "name_en": "Corporate 3-year BBB-",
          "unit": "% per year",
          "source": "Bank of Korea ECOS 817Y002/010320000",
          "status": "OK",
          "date": "2026-10-15",
          "value": 10.358,
          "prev_date": "2026-10-14",
          "prev_value": 10.375,
          "change_bp": -1.7
        }
      },
      "spreads_bp": {
        "ktb10y_ktb3y": 32.6,
        "ktb3y_base": 86.7,
        "corp3y_aa_ktb3y": 69.2,
        "corp3y_bbb_corp3y_aa": 579.9,
        "cd91_base": 25
      },
      "notes": "Each series carries its own last observation date (markets are closed on weekends and Korean holidays). base is the policy rate in force on that date; market rates are end-of-day as published on ECOS.",
      "generated_at": "2026-10-15T12:12:57+00:00"
    }
  }
}

Try it

Make one real paid call from your own wallet — about $0.005 on Base Sepolia (eip155:84532). The wallet signs; nothing here holds a key. You'll see exactly what the service answers.

No browser wallet found. Install MetaMask, Rabby, or Coinbase Wallet to try a call here.

EndpointRequest body

Supported methods

Methods the registry lists for this service. The portal forwards any call as sent; the supplier decides what it answers, and a delivered answer is settled.

Methods Korean Rates and FX accepts, and whether each reads or writes.
Method	Effect
`GET /v1/convert`	read
`GET /v1/customs-fx`	read
`GET /v1/fx`	read
`GET /v1/health`	read
`GET /v1/rate`	read
`GET /v1/rates`	read
`GET /v1/version`	read
`POST /v1/query`	read

Schemas

Published by the service itself. The example above is generated from these.

Request schema

{
  "type": "object",
  "description": "The body of POST /v1/query. The GET routes take query parameters, each with an optional date (KST, default today): /v1/rates takes none else; /v1/rate takes series (required, e.g. ktb3y, base, kofr) and days (default 30); /v1/fx takes ccy (comma-separated ISO codes, default USD); /v1/convert takes amount (required), from (default USD) and to (default KRW); /v1/customs-fx takes ccy and kind (import or export).",
  "properties": {
    "question": {
      "type": "string",
      "description": "A question in Korean or English, e.g. 국고채 3년 금리."
    },
    "date": {
      "type": "string",
      "description": "As-of date (KST), YYYY-MM-DD; default today."
    }
  }
}

Response schema

{
  "type": "object",
  "description": "A JSON object tagged with its own `schema` (kr-rates/v1, kr-rate-history/v1, kr-fx/v1, kr-convert/v1, kr-customs-fx/v1, kr-rates-fx-answer/v1). Every value carries its observation date and source; missing days are listed, never filled. Rates are % per year, FX is KRW per unit."
}