{
  "serviceId": "kr-rates-fx-v1",
  "displayName": "Korean Rates and FX",
  "description": "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.",
  "category": "finance",
  "resourceUrl": "https://test.agent.pocket.network/v1/kr-rates-fx-v1",
  "priceUsd": "0.005000",
  "priceVersion": 1,
  "rails": [
    {
      "id": "base",
      "network": "eip155:84532",
      "chainId": 84532,
      "tokenAddress": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
      "tokenDecimals": 6,
      "payToAddress": "0xF732ea490c5766071785a2310523f7fA2CEbB829"
    }
  ],
  "paymentNetworks": [
    "eip155:84532"
  ],
  "paymentProtocols": [
    "x402"
  ],
  "protocols": [
    "rest"
  ],
  "inputSchema": {
    "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."
      }
    }
  },
  "outputSchema": {
    "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."
  },
  "methods": {
    "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"
  },
  "example": {
    "method": "POST",
    "path": "/v1/query",
    "request": {
      "question": "국고채 3년 금리"
    },
    "response": {
      "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"
        }
      }
    },
    "capturedAt": "2026-10-15T12:12:55.786Z"
  },
  "firstParty": true,
  "networks": [
    "eip155:84532"
  ],
  "serving": true,
  "page": "https://test.agent.pocket.network/services/kr-rates-fx-v1",
  "descriptor": "https://test.agent.pocket.network/services/kr-rates-fx-v1/descriptor.json"
}