미국 국채 수익률로 장단기 금리차 역전 확인하기
두 수익률을 비교해 스프레드를 베이시스포인트로 읽습니다.
가이드 읽기 →모든 API
국채 수익률곡선 API
REST와 MCP를 통해 9개 국가 및 지역의 국채 수익률 곡선을 조회합니다. 소수 형식의 백분율 문자열로 단일 출처 날짜의 데이터 또는 페이지로 나뉜 과거 데이터를 조회합니다.
첫 요청
Get the United Kingdom 수익률 곡선
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 the United States 수익률 곡선
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"Get the Germany 수익률 곡선
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"Get the Japan 수익률 곡선
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"Get the Canada 수익률 곡선
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"Get the Sweden 수익률 곡선
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"Get the Norway 수익률 곡선
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"Get the Australia 수익률 곡선
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"Get the Euro area 수익률 곡선
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"과거 데이터 조회
curl --request GET \
--url "https://api.narwhalapi.com/v1/economics/GBR/yield-curve/history?start=2026-09-09&end=2026-09-10&limit=100&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이면 다음 페이지가 없습니다.
전체 레퍼런스 →
활용 사례
데이터 범위
- 미국명목 액면 수익률(par yield)입니다. 1990년 1월 2일부터 일간 제공됩니다.
- 영국연속복리 명목 무이표채 수익률입니다. 1979년 1월 2일부터 일간 제공됩니다.
- 독일스벤손(Svensson) 현물 수익률입니다. 1997년 8월 7일부터 일간 제공됩니다.
- 일본정기 만기(constant-maturity) 일본 국채(JGB) 만기수익률입니다. 1974년부터 일간 제공됩니다.
- 캐나다무이표채(할인채) 수익률입니다. 1986년 1월 2일부터 일간 제공됩니다.
- 스웨덴정부 단기채 및 국채 벤치마크 수익률입니다. 1983년 1월 3일부터 일간 제공됩니다.
- 노르웨이정부 증권 무이표채 수익률입니다. 2015년 1월 2일부터 일간 제공됩니다.
- 호주국채 만기수익률입니다. 2013년 5월 20일부터 일간 제공됩니다.
- 유로 지역AAA 등급 국채 현물 금리입니다. 2004년 9월 6일부터 일간 제공됩니다.
출처
Japan's yield data is reused under Public Data License 1.0. Narwhal formats the source data for the API. This version was not created by the Ministry of Finance, Japan. Source licence
Source: Sveriges Riksbank. The data date is shown alongside the data. Narwhal has no official collaboration or partnership with the Riksbank.
Source: Norges Bank. Values are shown as published.
Source Reserve Bank of Australia 2026. The RBA publishes this data free of charge at rba.gov.au and does not endorse Narwhal.
Source: ECB. The ECB publishes this data free of charge at ecb.europa.eu, and values are shown as published.
관련 API
자주 묻는 질문
데이터는 얼마나 자주 업데이트되나요?
미국 재무부 곡선은 매일 게시되는 일정을 따릅니다. 영란은행은 다음 영업일 런던 시간 정오까지 게시하는 것을 목표로 합니다. 독일 연방은행은 곡선을 매일 게시합니다. 일본 재무성은 다음 영업일 일본 시간 09:30에 게시합니다. 캐나다 은행은 곡선을 대략 일주일에 한 번, 관측일로부터 약 2~3주 후에 게시합니다. 따라서 최신 곡선은 보통 2~3주 전 데이터입니다. 스웨덴 릭스방크는 영업일마다 게시합니다. 노르웨이 중앙은행도 영업일마다 게시합니다. 호주 중앙은행은 F2 표를 영업일에 게시하며, 보통 이틀 이내에 게시됩니다. 유럽중앙은행은 다음 영업일에 곡선을 게시합니다. 주말과 공휴일에는 새 곡선이 없을 수 있습니다. 원천 값은 수정될 수 있습니다. 원천 확인이 새 관측값의 존재를 보장하지는 않습니다.
값이 없으면 어떻게 되나요?
없는 만기는 생략됩니다. Narwhal은 누락된 원천 지점을 채우거나 이전 곡선으로 대체하거나 값을 임의로 만들어내지 않습니다.
국가마다 수익률 곡선이 다른 이유는 무엇인가요?
곡선 측정 방식은 국가마다 다릅니다. 각 값과 함께 출처, 곡선 유형, 만기를 유지합니다.
국가에서 두 번째 곡선을 제공하나요?
Norway: Use curve_type=constant_maturity_benchmark for Norges Bank generic rates: Treasury bills at 3, 6 and 12 months and government bonds at 3, 5, 7 and 10 years. 과거 데이터는 2019년 1월 2일부터 제공됩니다. Australia: Use curve_type=zero_coupon for RBA table F17 zero-coupon yields, from 0.25 to 10 years in quarter-year steps. 과거 데이터는 2017년 1월 3일부터 제공되며, RBA는 각 행의 날짜로부터 약 1개월 후에 해당 행을 추가합니다. Euro area: Use curve_type=spot_svensson_all_issuers for the ECB curve covering all euro area central government issuers: 3, 6 and 9 months, then 1 to 30 years in yearly steps, with daily history from 6 September 2004.
이력을 페이지 단위로 가져오려면 어떻게 하나요?
시작일과 종료일을 포함하여 선택합니다. 응답은 오래된 순이며 페이지당 최대 1,000개의 출처 날짜를 제공합니다. next_cursor가 null이 될 때까지 같은 필터와 limit으로 따라갑니다. 커서는 발행 스냅샷을 최대 24시간 유지하며, 만료되었거나 철회된 스냅샷은 409를 반환하므로 커서 없이 다시 시작합니다.
무료 키로 시작하세요
12개월 동안 매달 10달러 상당의 무료 크레딧을 드립니다. 카드는 필요하지 않습니다.매달 10달러 상당의 무료 크레딧. 카드는 필요하지 않습니다.