중앙은행 금리 API

조회 가능한 데이터

아래에 나열된 10개 중앙은행의 공식 정책금리를 제공합니다. 각 관측값에는 국가, 담당 기관, 통화, 금리 수단이 명시됩니다. 금리는 연 이율의 백분율을 나타내는 소수 문자열이며 음수도 허용됩니다. 단일 금리 관측값에는 rate와 qualifier가 있고, 금리 범위에는 lower_bound와 upper_bound가 있습니다.

중앙은행 및 금리 수단

지원되는 유로 도입국 코드는 DEU, FRA, IRL, NLD, PRT, SVN, EST, LVA, LTU, HRV입니다. 각 코드는 동일한 ECB 금리 수단을 반환하며, 과거 데이터는 해당 국가의 유로 도입일부터 제공됩니다. 국가 코드는 대문자로 전송합니다.

현재 금리 조회

date를 생략하면 UTC 기준 오늘 또는 그 이전의 최신 원천 관측값을 요청합니다. 향후 적용될 금리가 현재 금리를 미리 대체하는 일은 없습니다. 다음 요청은 공개 예정인 계약을 설명합니다.

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/economics/USA/central-bank/policy-rate"

USA 응답 예시는 11 December 2025부터 적용되는 저장된 금리 범위 예시를 사용합니다. 캐나다 예시는 단일 금리 응답을 보여주며, 값과 날짜는 설명용입니다.

{
  "country": "USA",
  "authority": "federal_reserve",
  "currency": "USD",
  "instrument": "federal_funds_target_range",
  "rate_type": "range",
  "lower_bound": "3.50",
  "upper_bound": "3.75",
  "unit": "percent",
  "effective_on": "2025-12-11"
}

{
  "country": "CAN",
  "authority": "bank_of_canada",
  "currency": "CAD",
  "instrument": "overnight_rate_target",
  "rate_type": "point",
  "rate": "2.00",
  "qualifier": "exact",
  "unit": "percent",
  "observed_on": "2025-12-11"
}

과거 날짜의 금리 조회

date=YYYY-MM-DD를 전달하면 해당 날짜 또는 그 이전의 최신 관측값을 조회합니다. 데이터가 없는 날짜의 관측값을 임의로 생성하지 않습니다. 모든 관측값에는 effective_on 또는 observed_on 중 정확히 하나가 있으며, announced_on이 추가로 있을 수 있습니다. 국가를 비교하거나 금리 변동을 기록할 때 이 구분을 유지합니다.

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/economics/USA/central-bank/policy-rate?date=2025-12-11"

과거 데이터 조회

과거 데이터 경로에서 start, end, limit를 사용합니다. 기본 조회 개수는 100이며 허용 범위는 1부터 1000까지입니다. 응답에는 country, 오래된 순으로 정렬된 observations, next_cursor가 포함됩니다. 다음 페이지를 조회하려면 반환된 커서를 cursor로 전달합니다.

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/economics/USA/central-bank/policy-rate/history?start=2025-12-11&end=2026-10-27&limit=100"

커서는 24시간 동안 게시 데이터 버전을 고정합니다. 커서가 만료되거나 데이터 제공 권한이 철회되면 409를 반환합니다. 잘못된 입력은 400, 제공할 수 없는 데이터는 404, 안전하게 제공할 수 없는 원천 데이터는 503을 반환합니다. 요청마다 사용량 1단위를 차감합니다. 오류 처리 방법은 오류 문서를 참조합니다.

공적 준비자산

제공 예정인 준비자산 경로는 /v1/economics/{country}/central-bank/reserves이며, period=YYYY-MM을 선택적으로 지정할 수 있습니다. 제공 범위에는 AUS, MYS와 ECB 시계열을 통한 위의 유로 도입국 10개국 및 CZE가 포함됩니다. 호주는 AUD, 말레이시아는 MYR, ECB 시계열은 EUR로 보고합니다. 응답은 발표된 통화와 units 또는 millions인 scale을 유지하며, 값을 변환하지 않습니다. 데이터가 없는 월은 그대로 누락됩니다. released_on은 게시 기관의 파일 갱신일입니다.

출처

Narwhal은 캐나다 중앙은행의 데이터 형식을 정규화했습니다. ECB 데이터의 변경은 형식에 한정됩니다. 값은 발표된 그대로 제공됩니다. 이는 어느 중앙은행의 보증도 의미하지 않습니다.

• Source: Bank of Canada. This information is available free of charge on the Bank of Canada website: https://www.bankofcanada.ca.
• Source: European Central Bank (ECB). This information is available free of charge on the ECB website: https://www.ecb.europa.eu.
• Source: Reserve Bank of Australia 2026. This information is available free of charge on the RBA website: https://www.rba.gov.au.
• Source: Board of Governors of the Federal Reserve System
• 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
• Source: Sveriges Riksbank, with the date of the data.
• Source: the CNB
• Source: Norges Bank
• Source: Danmarks Nationalbank
• Source: Statistics Denmark - StatBank.dk/dnrentd
• Source: Banco Central do Brasil (SGS 432), Open Data Commons Open Database License (ODbL).

정책금리란 무엇인가요?

중앙은행은 단기금리를 유도하기 위해 정책금리를 정합니다. 금리 수단은 중앙은행마다 다릅니다. ECB 스트림은 예금금리를 보고하며, 미국 스트림은 연방기금 목표금리 범위를 보고합니다.

중앙은행 금리 데이터는 무료인가요?

Free를 포함한 모든 요금제에서 실시간 데이터를 이용할 수 있습니다. 요청마다 사용량 1단위가 차감됩니다. 원본 데이터는 위의 출처 이용 약관 및 고지 사항에 따라 각 중앙은행 웹사이트에서 무료로 이용할 수 있습니다.