최신·선택 날짜 기준 국채 금리 데이터 조회

REST와 MCP를 통해 9개 국가 및 지역의 국채 수익률 곡선을 조회합니다. 소수 형식의 백분율 문자열로 단일 출처 날짜의 데이터 또는 페이지로 나뉜 과거 데이터를 조회합니다.

요청

GET /v1/economics/{country}/yield-curve

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/GBR/yield-curve?date=2026-09-10&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

미국 요청

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/yield-curve?date=2026-09-10&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

독일 요청

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/DEU/yield-curve?date=2026-09-10&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

일본 요청

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/JPN/yield-curve?date=2026-09-10&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

캐나다 요청

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/CAN/yield-curve?date=2026-09-10&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

스웨덴 요청

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/SWE/yield-curve?date=2026-09-10&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

노르웨이 요청

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/NOR/yield-curve?date=2026-09-10&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

호주 요청

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/AUS/yield-curve?date=2026-09-10&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

유로 지역 요청

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/EMU/yield-curve?date=2026-09-10&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

REST and MCP use the same Bearer key, response schema and credit balance. MCP tool: economics_get_yield_curve.

매개변수

이름	유형	필수	의미
`country`	경로 · ISO alpha-3	예	지원하는 국가 코드: USA, GBR, DEU, JPN, CAN, SWE, NOR, AUS, EMU. 미국: 명목 액면 수익률(미국 재무부). 영국: 연속복리 명목 무이표채 수익률(영란은행). 독일: 스벤손 현물 수익률(독일 연방은행). 일본: 고정 만기 일본 국채 만기수익률(일본 재무성). 캐나다: 무이표채(할인) 수익률(캐나다 은행). 스웨덴: 국채 단기물 및 장기물 벤치마크 수익률(스웨덴 릭스방크). 노르웨이: 국채 무이표채 수익률(노르웨이 중앙은행). 호주: 국채 만기수익률(호주 중앙은행). 유로 지역: AAA 등급 국채 현물 금리(유럽중앙은행).
`date`	YYYY-MM-DD 문자열	아니요	생략하면 반영된 최신 관측값을 반환합니다. 값을 지정하면 정확히 해당 기간을 선택하며, 제공되지 않는 기간은 404를 반환합니다.
`version_id`	UUID 문자열	아니요	선택 사항인 불변 게시 버전입니다. 생략하면 현재 반영된 곡선을 조회합니다.
`curve_type`	문자열	아니요	선택 사항인 curve_type은 두 경로 모두에서 곡선을 지정하며, 곡선을 각각 두 개 제공하는 NOR, AUS, EMU에만 사용합니다. 생략하면 첫 번째 곡선이 적용되며, 응답의 curve_type에 그 이름이 표시됩니다. 해당 국가가 제공하지 않는 곡선을 지정하면 400 오류가 발생합니다.
`maturity`	쉼표로 구분된 문자열	아니요	두 경로 모두에서 선택 사항입니다. 생략하면 사용 가능한 전체 곡선을 반환합니다. USA: 1m, 1.5m, 2m, 3m, 4m, 6m, 1y, 2y, 3y, 5y, 7y, 10y, 20y, 30y. GBR: 0.5y, 1y, 1.5y, 2y, 2.5y, 3y, 3.5y, 4y, 4.5y, 5y, 5.5y, 6y, 6.5y, 7y, 7.5y, 8y, 8.5y, 9y, 9.5y, 10y, 10.5y, 11y, 11.5y, 12y, 12.5y, 13y, 13.5y, 14y, 14.5y, 15y, 15.5y, 16y, 16.5y, 17y, 17.5y, 18y, 18.5y, 19y, 19.5y, 20y, 20.5y, 21y, 21.5y, 22y, 22.5y, 23y, 23.5y, 24y, 24.5y, 25y, 25.5y, 26y, 26.5y, 27y, 27.5y, 28y, 28.5y, 29y, 29.5y, 30y, 30.5y, 31y, 31.5y, 32y, 32.5y, 33y, 33.5y, 34y, 34.5y, 35y, 35.5y, 36y, 36.5y, 37y, 37.5y, 38y, 38.5y, 39y, 39.5y, 40y. DEU: 1y, 2y, 3y, 4y, 5y, 6y, 7y, 8y, 9y, 10y, 11y, 12y, 13y, 14y, 15y, 16y, 17y, 18y, 19y, 20y, 21y, 22y, 23y, 24y, 25y, 26y, 27y, 28y, 29y, 30y. JPN: 1y, 2y, 3y, 4y, 5y, 6y, 7y, 8y, 9y, 10y, 15y, 20y, 25y, 30y, 40y. CAN: 0.25y, 0.5y, 0.75y, 1y, 1.25y, 1.5y, 1.75y, 2y, 2.25y, 2.5y, 2.75y, 3y, 3.25y, 3.5y, 3.75y, 4y, 4.25y, 4.5y, 4.75y, 5y, 5.25y, 5.5y, 5.75y, 6y, 6.25y, 6.5y, 6.75y, 7y, 7.25y, 7.5y, 7.75y, 8y, 8.25y, 8.5y, 8.75y, 9y, 9.25y, 9.5y, 9.75y, 10y, 10.25y, 10.5y, 10.75y, 11y, 11.25y, 11.5y, 11.75y, 12y, 12.25y, 12.5y, 12.75y, 13y, 13.25y, 13.5y, 13.75y, 14y, 14.25y, 14.5y, 14.75y, 15y, 15.25y, 15.5y, 15.75y, 16y, 16.25y, 16.5y, 16.75y, 17y, 17.25y, 17.5y, 17.75y, 18y, 18.25y, 18.5y, 18.75y, 19y, 19.25y, 19.5y, 19.75y, 20y, 20.25y, 20.5y, 20.75y, 21y, 21.25y, 21.5y, 21.75y, 22y, 22.25y, 22.5y, 22.75y, 23y, 23.25y, 23.5y, 23.75y, 24y, 24.25y, 24.5y, 24.75y, 25y, 25.25y, 25.5y, 25.75y, 26y, 26.25y, 26.5y, 26.75y, 27y, 27.25y, 27.5y, 27.75y, 28y, 28.25y, 28.5y, 28.75y, 29y, 29.25y, 29.5y, 29.75y, 30y. SWE: 1m, 3m, 6m, 2y, 5y, 7y, 10y. NOR: 6m, 9m, 1y, 2y, 3y, 4y, 5y, 6y, 7y, 8y, 9y, 10y. AUS: 2y, 3y, 5y, 10y. EMU: 3m, 6m, 9m, 1y, 2y, 3y, 4y, 5y, 6y, 7y, 8y, 9y, 10y, 11y, 12y, 13y, 14y, 15y, 16y, 17y, 18y, 19y, 20y, 21y, 22y, 23y, 24y, 25y, 26y, 27y, 28y, 29y, 30y. 중복은 제거되고 만기는 정렬됩니다. 지원하지 않는 레이블은 400을 반환합니다.

응답

응답 예시 저장된 원본 샘플 · 실시간 요청이 아닙니다

{
  "country": "GBR",
  "curve_type": "nominal_zero_coupon",
  "date": "2026-09-10",
  "yields": [
    {
      "maturity": "2y",
      "tenor": "P2Y",
      "yield_percent": "4.6509003413966044"
    },
    {
      "maturity": "10y",
      "tenor": "P10Y",
      "yield_percent": "5.3572243604351168"
    }
  ]
}

필드	유형	의미
`country`	ISO alpha-3 문자열	요청한 국가 또는 지역입니다.
`curve_type`	"nominal_par" \| "nominal_zero_coupon" \| "spot_svensson" \| "constant_maturity_ytm" \| "zero_coupon" \| "constant_maturity_benchmark" \| "spot_svensson_aaa"	미국: 명목 액면 수익률(미국 재무부). 영국: 연속복리 명목 무이표채 수익률(영란은행). 독일: 스벤손 현물 수익률(독일 연방은행). 일본: 고정 만기 일본 국채 만기수익률(일본 재무성). 캐나다: 무이표채(할인) 수익률(캐나다 은행). 스웨덴: 국채 단기물 및 장기물 벤치마크 수익률(스웨덴 릭스방크). 노르웨이: 국채 무이표채 수익률(노르웨이 중앙은행). 호주: 국채 만기수익률(호주 중앙은행). 유로 지역: AAA 등급 국채 현물 금리(유럽중앙은행).
`date`	YYYY-MM-DD 문자열	이 곡선의 모든 지점이 공유하는 원천 날짜입니다.
`yields`	배열	사용 가능한 만기이며, 짧은 만기부터 긴 만기 순으로 정렬됩니다. 만기가 하나뿐이어도 배열로 반환됩니다.
`yields[].maturity`	문자열	지원하는 만기 레이블 중 하나입니다.
`yields[].tenor`	문자열	`tenor`는 만기를 표준 기간 표기로 나타냅니다. 그래서 출처가 6m으로 쓰든 0.5y로 쓰든 6개월은 모든 나라에서 P6M입니다.
`yields[].yield_percent`	십진수 문자열	퍼센트 단위의 수익률이며, 원천 데이터의 소수 자릿수를 그대로 유지합니다.

값은 소수 문자열 그대로 유지됩니다. 원본 타임스탬프나 발행일을 임의로 만들어 넣지 않습니다. Request IDs, cost and balance are returned in headers.

API 오류 코드와 크레딧

상태	의미
`400`	국가 형식, 날짜, 연도, 범위, 만기, limit 또는 커서가 올바르지 않습니다.
`401`	API 키가 없거나 거부되었습니다.
`404`	지정한 날짜, 연도, 범위 또는 선택한 만기와 일치하는 관측값이 없습니다.
`429`	요청 한도에 도달했습니다.
`503`	승인된 데이터를 안전하게 제공할 수 없습니다.

A successful response costs one call, including an empty history result. Errors cost nothing. 공통 오류와 헤더 →

범위와 최신성

미국 · USA, 영국 · GBR, 독일 · DEU, 일본 · JPN, 캐나다 · CAN, 스웨덴 · SWE, 노르웨이 · NOR, 호주 · AUS, 유로 지역 · EMU · 미국: 1990년 1월 2일 이후 · 영국: 1979년 1월 2일 이후 · 독일: 1997년 8월 7일 이후 · 일본: 1974년 이후 · 캐나다: 1986년 1월 2일 이후 · 스웨덴: 1983년 1월 3일 이후 · 노르웨이: 2015년 1월 2일 이후 · 호주: 2013년 5월 20일 이후 · 유로 지역: 2004년 9월 6일 이후. 미국 재무부 곡선은 매일 게시되는 일정을 따릅니다. 영란은행은 다음 영업일 런던 시간 정오까지 게시하는 것을 목표로 합니다. 독일 연방은행은 곡선을 매일 게시합니다. 일본 재무성은 다음 영업일 일본 시간 09:30에 게시합니다. 캐나다 은행은 곡선을 대략 일주일에 한 번, 관측일로부터 약 2~3주 후에 게시합니다. 따라서 최신 곡선은 보통 2~3주 전 데이터입니다. 스웨덴 릭스방크는 영업일마다 게시합니다. 노르웨이 중앙은행도 영업일마다 게시합니다. 호주 중앙은행은 F2 표를 영업일에 게시하며, 보통 이틀 이내에 게시됩니다. 유럽중앙은행은 다음 영업일에 곡선을 게시합니다. 주말과 공휴일에는 새 곡선이 없을 수 있습니다. 원천 값은 수정될 수 있습니다. 원천 확인이 새 관측값의 존재를 보장하지는 않습니다.

없는 만기는 생략됩니다. Narwhal은 누락된 원천 지점을 채우거나 이전 곡선으로 대체하거나 값을 임의로 만들어내지 않습니다.

미국: 명목 액면수익률. 일별 이력 제공 시작: 1990년 1월 2일. 만기: 1개월~30년.

출처: 미국 재무부

영국: 연속복리 명목 무이표채 수익률. 일별 이력 제공 시작: 1979년 1월 2일. 만기: 0.5년~40년, 0.5년 간격.

출처: 영란은행

독일: 스벤손 모형 현물 수익률. 일별 이력 제공 시작: 1997년 8월 7일. 만기: 1년~30년, 1년 간격.

출처: 독일 연방은행

일본: 고정 만기 일본 국채 만기수익률. 일별 이력 제공 시작: 1974. 만기: 1~10년, 이후 15년, 20년, 25년, 30년, 40년.

출처: 일본 재무성

일본의 수익률 데이터는 공공데이터 라이선스 1.0에 따라 재사용됩니다. Narwhal은 API에 맞게 원천 데이터를 가공합니다. 이 버전은 일본 재무성이 작성한 것이 아닙니다. 원본 데이터 라이선스

캐나다: 무이표채(할인채) 수익률. 일별 이력 제공 시작: 1986년 1월 2일. 만기: 0.25년~30년, 0.25년 간격(1991년 이전에는 최대 25년).

출처: 캐나다은행

스웨덴: 단기국채 및 국채 벤치마크 수익률. 일별 이력 제공 시작: 1983년 1월 3일. 만기: 만기 1, 3, 6개월 단기국채와 만기 2, 5, 7, 10년 국채. 국채 시계열은 1985년부터 1987년 사이에 시작.

출처: 스웨덴 중앙은행

출처: 스웨덴 중앙은행. 데이터 날짜는 데이터와 함께 표시됩니다. Narwhal은 스웨덴 중앙은행과 공식적인 협력 또는 제휴 관계가 없습니다. 원본 데이터 라이선스

노르웨이: 정부증권 무이표 수익률. 일별 이력 제공 시작: 2015년 1월 2일. 만기: 6개월과 9개월, 이후 1년부터 10년까지 1년 간격.

출처: 노르웨이 중앙은행

출처: 노르웨이 중앙은행. 값은 발표된 그대로 표시됩니다. 원본 데이터 라이선스

호주: 국채 만기수익률. 일별 이력 제공 시작: 2013년 5월 20일. 만기: 2, 3, 5, 10년이며, 10년 시계열은 2013년 5월에, 나머지는 2013년 9월에 시작됩니다.

출처: 호주준비은행

출처 호주준비은행 2026. RBA는 이 데이터를 rba.gov.au에서 무료로 공개하며 Narwhal을 보증하지 않습니다. 원본 데이터 라이선스

유로 지역: AAA 등급 국채 현물 금리. 일별 이력 제공 시작: 2004년 9월 6일. 만기: 3, 6, 9개월, 이후 1년부터 30년까지 1년 간격.

출처: 유럽중앙은행

출처: ECB. ECB는 이 데이터를 ecb.europa.eu에서 무료로 공개하며, 값은 발표된 그대로 표시됩니다. 원본 데이터 라이선스

데이터셋 개요 →

이 페이지가 도움이 되었나요?