문서
API 레퍼런스사이트
전체 문서 탐색

정책금리 API 레퍼런스

원래의 정책금리 수단과 출처 날짜가 포함된 현재, 특정 시점 기준, 과거의 중앙은행 정책금리, 공식 준비자산, 대차대조표(총자산)를 조회합니다.

요청

GET /v1/economics/{country}/central-bank/policy-rate
GET /v1/economics/{country}/central-bank/policy-rate?date=2026-09-15
GET /v1/economics/{country}/central-bank/policy-rate/history?start=2008-01-01&limit=1000
GET /v1/economics/{country}/central-bank/reserves?period=2026-07
GET /v1/economics/{country}/central-bank/balance-sheet?period=2026-09

country에는 대문자 ISO alpha-3 코드를 사용합니다.

date가 없으면 UTC 기준 오늘 또는 그 이전의 최신 원본 관측값을 반환합니다. date가 있으면 요청한 날짜 또는 그 이전의 최신 관측값을 반환합니다. 관측값이 없는 날짜는 그대로 누락되며, 발효일이 미래인 금리가 현재 금리를 미리 대체하는 일은 없습니다.

MCP 도구는 economics_get_policy_rate, economics_get_policy_rate_history, economics_get_central_bank_reserves, economics_get_central_bank_balance_sheet입니다. REST와 MCP는 Bearer 키, 스키마, 쿼터를 공유하며, 각 요청은 1회 호출로 계산됩니다.

정책금리는 모든 플랜에서 실시간으로 제공됩니다. 최신 금리에는 과거 데이터 조회 제한이 없지만, date, 과거 조회 범위, 준비자산의 period 또는 대차대조표의 period를 지정한 요청에는 플랜별 조회 범위가 적용됩니다. Free는 12개월, Basic은 5년, Pro는 전체 기간입니다. 종료 시점이 조회 범위보다 이른 요청은 403 plan_upgrade_required를 반환합니다.

응답

예시는 응답 형식을 보여주기 위해 저장된 값을 사용합니다. 이 값은 실시간 데이터가 아닙니다.

단일 금리
{
  "country": "CAN",
  "authority": "bank_of_canada",
  "currency": "CAD",
  "instrument": "overnight_rate_target",
  "rate_type": "point",
  "rate": "2.25",
  "qualifier": "exact",
  "unit": "percent",
  "effective_on": null,
  "observed_on": "2025-12-10",
  "announced_on": null
}
범위
{
  "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",
  "observed_on": null,
  "announced_on": null
}

단일 금리에는 rate와 qualifier가 있고, 목표 범위에는 그 대신 lower_bound와 upper_bound가 있습니다. 값은 연간 백분율 단위의 십진수 문자열이며 음수 금리도 유효합니다.

필드의미
country요청한 ISO alpha-3 코드입니다.
authorityfederal_reserve와 같은 중앙은행 식별자입니다.
currency금리의 기준 통화입니다.
instrument중앙은행이 정한 정확한 정책 수단입니다. 이력에는 정책 수단의 변경 사항이 보존됩니다.
rate_typepoint 또는 range입니다.
rate, qualifierexact 한정자가 지정된 단일 금리입니다.
lower_bound, upper_bound목표 범위의 하한과 상한입니다.
unit항상 percent입니다.
effective_on, observed_on정확히 하나만 설정됩니다. effective_on은 변경 사항의 발효일을, observed_on은 금리 관측일을 기록합니다. 관측일에 금리가 바뀌지 않았을 수도 있습니다.
announced_on출처의 발표일이며, 제공되지 않으면 null입니다.

과거 데이터

  • start와 end: YYYY-MM-DD 형식의 날짜이며 양 끝 날짜를 포함합니다.
  • limit: 1~1000이며 기본값은 100입니다.
  • cursor: 이전 페이지의 next_cursor입니다.

결과는 오래된 순서로 정렬됩니다. 이후 각 페이지에서는 next_cursor가 null이 될 때까지 같은 필터와 한도를 유지하고 next_cursor를 cursor로 전송합니다. 커서는 24시간 동안 모든 페이지가 최초 조회 시의 발표본을 사용하도록 유지합니다. 커서가 더 오래되었거나 중앙은행 데이터가 철회되면 409 cursor_expired를 반환합니다. 커서 없이 다시 시작합니다.

응답에는 country, observations, next_cursor가 포함됩니다. 각 관측값은 단일 금리 응답의 필드를 사용합니다.

과거 데이터 요청에서는 start가 플랜별 조회 범위의 시작 시점보다 이르면 해당 시점으로 조정됩니다. Free는 12개월, Basic은 5년, Pro는 전체 기간입니다. 미국, 호주, 체코, 캐나다, 말레이시아는 결정일만 기록하며, 조회 범위 이전의 금리를 범위 내로 이월하지 않습니다. 조회 범위 내에 결정이 없으면 응답의 observations 목록은 비어 있고([]), next_cursor는 null로 설정됩니다. date 없이 현재 금리를 요청하면 현재 적용 중인 금리를 반환하며, 모든 플랜에서 과거 데이터 조회 제한이 적용되지 않습니다.

관측값 2개가 포함된 이력
{
  "country": "USA",
  "observations": [
    {
      "country": "USA",
      "authority": "federal_reserve",
      "currency": "USD",
      "instrument": "federal_funds_target",
      "rate_type": "point",
      "rate": "1.00",
      "qualifier": "exact",
      "unit": "percent",
      "effective_on": "2008-10-29",
      "observed_on": null,
      "announced_on": null
    },
    {
      "country": "USA",
      "authority": "federal_reserve",
      "currency": "USD",
      "instrument": "federal_funds_target_range",
      "rate_type": "range",
      "lower_bound": "0.00",
      "upper_bound": "0.25",
      "unit": "percent",
      "effective_on": "2008-12-16",
      "observed_on": null,
      "announced_on": null
    }
  ],
  "next_cursor": "eyJhIjoiMjAwOC0xMi0xNiJ9"
}

외환보유액

중앙은행이 발표한 공식 준비자산 총액을 반환합니다. period에는 YYYY-MM을 사용하며, 생략하면 최신 월을 조회합니다.

외환보유액
{
  "country": "AUS",
  "period": "2026-07",
  "value": "145344",
  "currency": "AUD",
  "scale": "millions",
  "released_on": "2026-08-07"
}

value는 양의 십진수 문자열입니다. 중앙은행의 공표 단위에 따라 scale은 units 또는 millions로 정해지며, currency는 값의 통화를 나타냅니다. Narwhal은 배율이나 통화를 변환하지 않습니다. 기준 월은 period이며, released_on은 발표 기관이 파일을 마지막으로 갱신한 날짜입니다. 발표되지 않은 월은 그대로 누락되며 채워 넣지 않습니다.

외환보유액은 호주(RBA 표 A4), 말레이시아(말레이시아 중앙은행, 총국제준비자산), 그리고 ECB의 유로화 표시 준비자산 시계열을 통해 독일, 프랑스, 아일랜드, 네덜란드, 포르투갈, 슬로베니아, 에스토니아, 라트비아, 리투아니아, 크로아티아 및 체코에 대해 제공됩니다. 체코의 값은 ECB가 기록한 체코 중앙은행 수치입니다. 그 외 국가는 404 series_not_found를 반환합니다.

대차대조표

GET /v1/economics/{country}/central-bank/balance-sheet 또는 MCP 도구 economics_get_central_bank_balance_sheet를 통해 중앙은행의 월별 총자산(대차대조표 총액)을 조회합니다. 선택 매개변수인 period에 기준 월을 YYYY-MM 형식으로 지정하거나, 생략하여 최신 월을 조회합니다.

저장된 응답
{
  "country": "CAN",
  "period": "2026-09",
  "value": "242657",
  "currency": "CAD",
  "scale": "millions",
  "released_on": "2026-10-15"
}

period는 기준 월이며, released_on은 발표일을 기록합니다. 캐나다의 경우 캐나다은행 파일에 갱신일이 없으므로 released_on은 Narwhal이 수치를 수집한 날짜입니다. value는 발표된 그대로의 양수 십진수 문자열이며, currency와 scale(units 또는 millions)은 해당 은행이 발표한 단위를 나타냅니다. Narwhal은 이를 변환하지 않습니다.

캐나다(CAN, 캐나다은행, CAD)와 말레이시아(MYS, 말레이시아 중앙은행, MYR)의 월별 데이터는 모든 플랜에서 제공되며, 그 외 국가는 모두 404 series_not_found를 반환합니다. 명시적으로 지정한 period의 종료 시점이 플랜의 과거 데이터 조회 범위보다 이르면 403 plan_upgrade_required를 반환합니다. Free는 12개월, Basic은 5년, Pro는 전체 기간을 제공합니다.

데이터 범위

유로 지역은 하나의 정책금리를 사용합니다. 목록에 있는 각 유로 회원국 코드는 해당 국가의 유로 도입일부터 ECB 예금금리를 반환합니다.

국가중앙은행정책 수단기록 시작일날짜 필드
USA연방준비제도federal_funds_target, then federal_funds_target_range2003-06-25effective_on
CAN캐나다은행overnight_rate_target2009-04-21observed_on
AUS호주준비은행cash_rate_target, with cash_rate_target_range early1990-01-23effective_on
CZE체코 중앙은행two_week_repo_rate1995-12-08effective_on
MYS말레이시아 중앙은행overnight_policy_rate2004observed_on
SWE스웨덴 중앙은행policy_rate1994-06-01observed_on
NOR노르웨이 중앙은행sight_deposit_rate1991-01-01observed_on
DNK덴마크 중앙은행certificate_of_deposit_rate1992-04-01observed_on
BRABanco Central do Brasilselic_target1999-03-05observed_on
DEU, FRA, IRL, NLD, PRT유럽중앙은행deposit_facility_rate1999-01-01observed_on
SVN유럽중앙은행deposit_facility_rate2007-01-01observed_on
EST유럽중앙은행deposit_facility_rate2011-01-01observed_on
LVA유럽중앙은행deposit_facility_rate2014-01-01observed_on
LTU유럽중앙은행deposit_facility_rate2015-01-01observed_on
HRV유럽중앙은행deposit_facility_rate2023-01-01observed_on

미국, 호주, 체코, 캐나다, 말레이시아의 행에는 금리 결정일이 표시됩니다(변경 시에만). 스웨덴, 노르웨이, 덴마크, 브라질, 유로 사용국의 행에는 날짜별 관측값이 표시되며, 이전 금리가 반복될 수 있습니다.

스웨덴의 policy_rate는 8 June 2022까지 레포금리였습니다. 브라질은 정책금리만 제공하며, 아직 효력이 발생하지 않은 날짜는 제외됩니다.

출처 및 고지

캐나다 중앙은행, ECB, RBA는 웹사이트에 데이터를 무료로 공개합니다. Narwhal은 형식을 변경해 발표된 값을 반환합니다. 이들 기관은 Narwhal을 보증하지 않습니다.

  • 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.
  • 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).

이용 조건: 호주준비은행 · 체코 중앙은행 · 연방준비제도

오류

  • 400 invalid_query 국가, 날짜 또는 필터가 잘못되었습니다.
  • 400 invalid_cursor 커서 형식이 잘못되었거나 다른 필터에 대해 발급된 커서입니다.
  • 401 invalid_api_key Bearer 키가 없거나 거부되었습니다.
  • 403 plan_upgrade_required 요청한 날짜 또는 범위의 종료 시점이 요금제의 이력 조회 기간보다 이전입니다.
  • 404 series_not_found 요청과 일치하는 금리가 없거나 해당 국가는 제공 대상이 아닙니다.
  • 409 cursor_expired 커서가 발급된 지 24시간이 지났거나 해당 데이터가 철회되었습니다.
  • 429 rate_limit_exceeded 단기 요청 한도에 도달했습니다. Retry-After에 지정된 시간만큼 기다립니다.
  • 429 quota_exhausted 계정의 월간 할당량을 모두 사용했습니다.
  • 503 economics_unavailable 원본 데이터를 안전하게 제공할 수 없습니다.

오류 및 할당량 · 경제 데이터 API 레퍼런스 · 중앙은행 정책금리 API