국가별 정책금리 비교 방법

API 사용 방법

Free를 포함한 모든 요금제에서 실시간 정책금리를 이용할 수 있습니다. 각 요청은 한 국가의 UTC 기준 오늘 또는 그 이전의 최신 원본 관측값을 반환합니다. 비교에는 USA, CAN, AUS, SWE, NOR, BRA, CZE, MYS 및 DEU를 사용합니다. DEU는 ECB 예금금리를 나타냅니다.

1. API 키 설정 셸에서 export NARWHAL_API_KEY="your_api_key"로 NARWHAL_API_KEY 환경 변수를 설정하세요. python -m pip install requests pandas로 Python 의존성을 설치하세요. 스크립트는 환경 변수에서 키를 읽어 Authorization 헤더로 보냅니다.
2. 국가별 최신 금리 요청 하나의 requests.Session을 사용하여 대문자 국가 코드를 순회하세요. 코드마다 /v1/economics/{country}/central-bank/policy-rate를 한 번 호출하세요. 각 금리에 통화, 금리 지표, 날짜가 연결된 상태를 유지하도록 응답 필드를 함께 보관하세요.
3. 비교용 단일 값 계산 단일 금리 응답에서는 rate를 읽으세요. 범위 응답에서는 십진 연산으로 (lower_bound + upper_bound) / 2를 계산하세요. 이 중간값은 직접 계산한 값입니다. Narwhal API는 발표된 경곗값을 반환하며 중간값을 계산하지 않습니다. 값은 연율 백분율을 나타내는 소수 문자열입니다.
4. 표 생성과 정렬 country, currency, instrument, rate, date로 pandas DataFrame을 만드세요. 날짜는 effective_on 또는 observed_on에서 가져오세요. 각 응답에는 둘 중 정확히 하나만 있습니다. 계산한 금리를 기준으로 정렬하세요. Decimal 값을 유지하면 제공된 문자열의 정밀도를 보존할 수 있습니다.
5. 전체 스크립트 실행 이 코드를 compare_rates.py로 저장하고 공개 이용이 시작된 후 python compare_rates.py를 실행하세요. 금리를 낮은 순서부터 높은 순서로 출력합니다. HTTP 오류가 발생하면 raise_for_status()로 스크립트가 중단되므로, 이용할 수 없는 국가가 비교에서 조용히 빠지지 않습니다.
   정책금리 조회와 비교

   복사

   import os
   from decimal import Decimal
   
   import pandas as pd
   import requests
   
   api_key = os.environ["NARWHAL_API_KEY"]
   base_url = "https://api.narwhalapi.com"
   countries = ["USA", "CAN", "AUS", "SWE", "NOR", "BRA", "CZE", "MYS", "DEU"]
   rows = []
   
   with requests.Session() as session:
       session.headers.update({"Authorization": f"Bearer {api_key}"})
   
       for country in countries:
           response = session.get(
               f"{base_url}/v1/economics/{country}/central-bank/policy-rate",
               timeout=10,
           )
           response.raise_for_status()
           observation = response.json()
   
           if observation["rate_type"] == "point":
               rate = Decimal(observation["rate"])
           elif observation["rate_type"] == "range":
               rate = (
                   Decimal(observation["lower_bound"])
                   + Decimal(observation["upper_bound"])
               ) / Decimal("2")
           else:
               raise ValueError(f"Unexpected rate_type for {country}")
   
           date = (
               observation["effective_on"]
               if "effective_on" in observation
               else observation["observed_on"]
           )
           rows.append({
               "country": observation["country"],
               "currency": observation["currency"],
               "instrument": observation["instrument"],
               "rate": rate,
               "date": date,
           })
   
   comparison = pd.DataFrame(
       rows,
       columns=["country", "currency", "instrument", "rate", "date"],
   ).sort_values("rate")
   
   print(comparison.to_string(index=False))
   

각 국가의 금리는 무엇을 나타내나요?

이 금리들은 대략적인 비교만 가능합니다. 익일물 목표금리, 레포금리, 예금금리는 서로 다른 금리 지표입니다. 각 금리는 물가상승률이 서로 다른 통화에 속하기도 합니다. 숫자 순위만으로 어느 국가의 통화정책이 더 긴축적인지 판단할 수 없습니다.

저장된 미국 예제의 연방기금금리 목표 범위는 3.50~3.75%이며, 적용일은 2025년 12월 11일입니다. 계산한 중간값은 (3.50 + 3.75) / 2 = 3.625%입니다. 이 수치는 예제에서 도출한 비교용 값이며, 발표된 단일 목표 금리나 오늘의 금리를 나타내는 수치가 아닙니다.

비교 결과를 보관한다면 원래의 경곗값도 보존하세요. 중간값 하나만 사용하면 출력된 표에서 목표 범위의 폭이 사라집니다. 브라질은 BRA에 대해 반환된 Selic 목표금리를 사용하세요.

이 관측값의 출처 표시는 다음과 같습니다.

• Source: Board of Governors of the Federal Reserve System
• 출처: 캐나다 중앙은행. 이 정보는 캐나다 중앙은행 웹사이트 https://www.bankofcanada.ca에서 무료로 이용할 수 있습니다. Narwhal은 형식을 표준화했습니다.
• Source: Reserve Bank of Australia 2026. This information is available free of charge on the RBA website: https://www.rba.gov.au. No endorsement is implied.
• Source: Sveriges Riksbank, with the date of the data.
• Source: Norges Bank
• Source: Banco Central do Brasil (SGS 432), Open Data Commons Open Database License (ODbL).
• Source: the CNB
• Source: Bank Negara Malaysia. Data and information are subject to Terms of Use for BNM Datasets. https://www.bnm.gov.my/terms-of-use-bnm-datasets
• 출처: 유럽중앙은행(ECB). 이 정보는 ECB 웹사이트 https://www.ecb.europa.eu에서 무료로 이용할 수 있습니다. Narwhal은 형식만 변경했습니다.

실질금리 비교 방법

간단한 실질금리 근삿값은 명목 정책금리에서 물가상승률을 뺀 값입니다. real rate ≈ policy rate − inflation. 뺄셈의 양쪽 값에 모두 백분율을 사용하세요. 목표 범위의 경우 명목금리 입력값이 직접 계산한 중간값임을 명시하세요.

물가상승률 경로가 있는 국가는 /v1/economics/{country}/inflation을 요청하고 year_over_year를 읽으세요. 해당 국가에는 USA, CAN, AUS, DEU가 포함됩니다. 404는 데이터가 없다는 뜻입니다. 물가상승률을 0으로 대체하지 말고 해당 국가의 실질금리 결과를 비워 두세요.

관측값들이 서로 다른 시점을 나타낼 수 있으므로 정책금리 날짜와 함께 물가상승률의 기준 기간을 유지하세요. 뺄셈은 실질금리 계산에서 설명합니다. 물가상승률을 조정한 후에도 기초 정책금리 지표 간 차이는 남습니다.

유로 지역은 왜 한 행인가요?

지원되는 유로 회원국 코드는 모두 같은 ECB 예금금리를 반환합니다. DEU를 한 번만 사용하면 비교에서 같은 금리 지표가 반복되지 않습니다. 이력 요청의 제공 범위는 각 회원국의 유로 도입일부터 시작하므로, 회원국 코드에 따라 이용 가능한 이력이 다를 수 있습니다.

국가마다 날짜가 다른 이유는 무엇인가요?

effective_on은 금리가 적용된 날짜입니다. observed_on은 원본에서 값을 기록한 날짜입니다. 출처별로 관측값을 발표하는 방식도 다르므로 최신 응답의 날짜가 같을 필요는 없습니다. 적용일이 미래인 금리는 현재 금리를 미리 대체하지 않습니다.

과거 시점을 비교하려면 모든 요청에 같은 date=YYYY-MM-DD를 추가하세요. 각 요청은 해당 날짜 또는 그 이전의 최신 원본 관측값을 반환합니다. 원본 관측값이 없는 날짜는 임의로 만들지 않으므로 반환된 날짜를 각각 유지하세요.