모든 API

국가별 금리 API

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

정상 운영 중99.94% uptime, last 30일378 ms 일반 응답 시간

첫 요청

수익률 곡선 가져오기

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"

엔드포인트

GET국채 수익률 곡선/v1/economics/{country}/yield-curve

한 국가의 관측값 하나로, 최신 값 또는 요청한 정확한 출처 날짜의 값입니다.

매개변수

country필수
세 글자 코드: USA, GBR, DEU, JPN, CAN, SWE, NOR, AUS, EMU.
date선택
생략하면 반영된 최신 관측값을 반환합니다. 값을 지정하면 정확히 해당 기간을 선택하며, 제공되지 않는 기간은 404를 반환합니다.
version_id선택
선택 사항인 불변 게시 버전입니다. 생략하면 현재 반영된 곡선을 조회합니다.
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을 반환합니다.

응답 필드

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

전체 레퍼런스 →

GET국채 수익률 곡선 과거 데이터/v1/economics/{country}/yield-curve/history

범위 내 모든 관측값을 오래된 순으로, 페이지당 최대 1,000개. null이 될 때까지 next_cursor를 따라갑니다.

매개변수

country필수
세 글자 코드: USA, GBR, DEU, JPN, CAN, SWE, NOR, AUS, EMU.
start선택
하한값이며 해당 값을 포함합니다. 생략하면 사용 가능한 첫 기간부터 시작합니다.
end선택
상한값이며 해당 값을 포함합니다. start보다 앞설 수 없습니다. 생략하면 사용 가능한 마지막 기간까지 포함합니다.
limit선택
기본값은 100입니다. 개별 수익률 지점이 아니라 날짜 또는 연도의 수를 셉니다.
cursor선택
next_cursor를 변경하지 않고 동일한 국가, 필터, limit과 함께 전달합니다. 커서는 24시간 후에 만료됩니다.
as_of선택
이 UTC 날짜가 끝나는 시점까지 게시된 상태의 곡선을 반환합니다.
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을 반환합니다.

응답 필드

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