미국 국채 수익률로 장단기 금리차 역전 확인하기

API 사용 방법

긴 만기 수익률에서 짧은 만기 수익률을 뺍니다. 일반적인 판단에서는 순서를 10년물 빼기 2년물로 유지하세요. 결과가 음수이면 2년물 수익률이 더 높다는 뜻입니다. Python 스크립트는 10년물 빼기 3개월물 스프레드도 계산하므로 같은 곡선에서 두 비교를 모두 읽을 수 있습니다.

미국 곡선에는 만기 1m, 1.5m, 2m, 3m, 4m, 6m, 1y, 2y, 3y, 5y, 7y, 10y, 20y, 30y가 포함됩니다. 계산에 사용할 수익률은 만기 레이블로 선택하세요. 응답에는 일반적인 역전 판단에 쓰이는 짧은 만기와 긴 만기가 모두 들어 있으며, 미국 곡선의 다른 지점도 함께 제공됩니다.

1. API 키 받기 무료 키를 발급받아 환경 변수 NARWHAL_API_KEY에 저장하세요. 요청에는 Authorization: Bearer YOUR_KEY를 사용하며, REST와 MCP가 같은 키를 공유합니다.
2. 미국 곡선을 가져와 스프레드 계산하기 GET /v1/economics/USA/yield-curve로 곡선의 date, curve_type, yields를 읽습니다. 스크립트는 각 maturity와 yield_percent를 읽은 뒤 날짜, 베이시스포인트로 나타낸 두 스프레드, 그리고 2년물과 10년물 수익률을 비교한 결과를 출력합니다.
   Python으로 구하는 10년물 빼기 2년물 스프레드

   import os
   import requests
   
   curve = requests.get(
       "https://api.narwhalapi.com/v1/economics/USA/yield-curve",
       headers={"Authorization": f"Bearer {os.environ['NARWHAL_API_KEY']}"},
       timeout=10,
   ).json()
   y = {row["maturity"]: float(row["yield_percent"]) for row in curve["yields"]}
   print("curve date", curve["date"])
   print("10y - 2y  =", round((y["10y"] - y["2y"]) * 100), "bp")
   print("10y - 3m  =", round((y["10y"] - y["3m"]) * 100), "bp")
   print("inverted (2y > 10y):", y["2y"] > y["10y"])

3. 날짜와 함께 부호 읽기 스프레드가 0보다 작으면 선택한 조합은 역전된 것입니다. 출력된 곡선 날짜를 결과와 함께 보관하고, 설명할 때는 비교한 만기를 밝히세요. 마지막 줄은 2y > 10y를 사용하는데, 이는 10년물 빼기 2년물 스프레드가 음수라는 조건과 같습니다.
4. 날짜나 만기를 선택해야 할 때 date로 특정 날짜를 선택하거나, 선택 사항인 maturity 필터로 만기 하나만 반환하세요. 스크립트처럼 두 수익률을 한 응답에 함께 받으려면 만기 필터를 빼세요. 미국 응답에서는 curve_type이 nominal_par로 설정됩니다. 과거 구간은 필요한 각 만기를 지정해 이력 엔드포인트를 사용하세요. 모든 계정이 전체 이력을 조회할 수 있습니다.

스프레드시트 또는 코드 없이 계산

Narwhal 채권 수익률 페이지에는 곡선과 스프레드가 표시됩니다. 페이지로 이동하려면 경제 데이터를 열고, 수익률을 직접 빼 보고 싶다면 스프레드시트를 사용하세요. 복사한 값에는 곡선 날짜를 함께 남겨 결과가 발표된 특정 날을 가리키도록 하세요.

10년물 수익률을 B10에, 2년물 수익률을 B8에 API가 반환한 수치 그대로 입력합니다. 아래 수식으로 뺍니다. 결과의 단위는 퍼센트포인트이며, 베이시스포인트로 나타내려면 여기에 100을 곱하세요. 값을 다른 셀로 옮길 때도 뺄셈 순서를 유지하세요.

=B10-B8

상황별 계산 방법

이력은 GET /v1/economics/USA/yield-curve/history?start=...&end=...&maturity=...를 사용하며, 모든 계정에서 전체 이력을 제공합니다.

어떤 스프레드가 역전 판단 기준인가요?

일반적인 판단 기준은 10년물 빼기 2년물과 10년물 빼기 3개월물이며, 서로 결과가 다를 수 있습니다. "곡선이 역전됐다"라는 표현만으로는 짧은 만기가 특정되지 않으므로 결과와 함께 어떤 조합인지 밝히세요. 각 판단은 10년물 수익률을 각자의 짧은 만기와 비교합니다.

2026년 10월 23일 미국의 10년물 빼기 2년물 스프레드는 +31 bp, 10년물 빼기 3개월물 스프레드는 +78 bp로 둘 다 양수였습니다. 다른 나라는 만기가 다릅니다. 영국 곡선은 0.5y에서 시작해 반년 단위로 이어지므로, 요청한 국가가 반환하는 만기 레이블을 확인하세요.

수익률 곡선은 얼마나 최신인가요?

응답의 date는 발표된 가장 최근 날짜이며, 주말과 공휴일에는 새 곡선이 나오지 않습니다. 미국 예시의 날짜는 2026년 10월 23일 금요일입니다. 스프레드에 레이블을 붙일 때는 응답의 날짜를 사용하세요. 데이터를 요청한 날은 곡선의 발표일과 다를 수 있습니다.

베이시스포인트는 퍼센트포인트의 100분의 1인가요?

네, 1베이시스포인트는 1퍼센트포인트의 100분의 1입니다. 퍼센트로 나타낸 수익률을 빼면 퍼센트포인트 차이가 나옵니다. 그 차이에 100을 곱하면 베이시스포인트가 되며 부호는 그대로 유지됩니다. 2026년 10월 23일 미국의 10년물 빼기 2년물 차이 0.31퍼센트포인트는 31 bp였습니다.

계산 예시: 2026년 10월 23일

2026년 10월 23일 미국 곡선에서 10년물 수익률은 5.00%, 2년물은 4.69%, 3개월물은 4.22%였습니다. 두 뺄셈 모두 10년물 수익률에서 시작합니다. 일반적인 판단에는 2년물 수익률을 쓰고, 또 다른 일반적인 비교를 위해 3개월물 수익률로 반복하세요.

2026년 10월 23일에 대해 5.00%에서 4.69%를 빼면 0.31퍼센트포인트입니다. 0.31에 100을 곱하면 31 bp입니다. 양수 부호는 10년물 수익률이 2년물 수익률보다 높았다는 뜻이므로 이 조합은 역전되지 않았습니다. 같은 날짜에 5.00%에서 4.22%를 빼면 0.78퍼센트포인트이고, 100을 곱하면 10년물 빼기 3개월물 스프레드는 78 bp입니다.

2026년 10월 23일 미국 20년물 수익률은 5.37%, 30년물은 5.33%였습니다. 이 만기들도 반환된 곡선에 포함됩니다. 여기서의 계산은 일반적인 역전 판단을 위해 10년물 수익률을 2년물 및 3개월물 수익률과 함께 사용합니다.