TypeScript 금리 데이터를 SDK로 가져오는 방법

TypeScript 금리 데이터를 SDK 호출로 가져오는 방법을 소개합니다. 단기 국채 수익률과 시장이 반영한 정책 경로를 조회하며, 공식 정책금리는 제공하지 않습니다.

클라이언트 설정

Node 22 이상을 사용하고 서버 환경에 NARWHAL_API_KEY를 설정하세요. API 키는 절대 브라우저 코드에 넣지 마세요. 패키지를 설치하고 클라이언트를 만드세요. 빠른 시작을 참고하세요.

설치 및 클라이언트 생성
// npm install narwhalapi
import { Narwhal } from "narwhalapi";

// Reads NARWHAL_API_KEY from the server environment.
const nw = new Narwhal();

단기 수익률로 시장 금리 가져오기

단기 국채 수익률을 시장 금리로 요청합니다. 3개월 수익률은 출처가 발표하는 경우에 제공됩니다. 제공되는 만기는 국가와 날짜에 따라 다르며, 없는 만기는 응답에서 빠집니다. 십진수 값은 정확한 문자열로 전달되며, 십진수 입력값으로 숫자는 쓸 수 없습니다.

영국 3개월, 2년 수익률
const short = await nw.economics.yieldCurve("GBR", { maturity: ["3m", "2y"] }); for (const point of short.yields) { console.log(point.maturity, point.yield_percent); }

시장 내재 정책 경로 읽기

영국은행의 시장 내재 정책금리 경로를 요청합니다. 각 회의에는 확률 문자열인 p_cut, p_hold, p_hike와 함께 expected_change_bps, cumulative_change_bps, resolves_at이 포함됩니다. 이 값은 공식 전망이 아니라 예측 시장 확률입니다.

영국은행의 시장 내재 금리 경로
const path = await nw.predictions.policyPath("bank-of-england"); for (const meeting of path.meetings) { console.log(meeting.resolves_at, meeting.p_cut, meeting.p_hold, meeting.p_hike); }

자주 묻는 질문

중앙은행의 현재 정책금리를 가져올 수 있나요?

아니요. Narwhal에는 현재 공식 정책금리를 제공하는 엔드포인트가 없습니다. 단기 국채 수익률과 향후 정책 회의에 대한 시장 내재 확률은 가져올 수 있습니다.

3개월 수익률이 왜 없나요?

제공되는 만기는 국가의 데이터 출처와 요청한 날짜에 따라 다릅니다. 없는 만기는 응답에서 빠지므로, 3개월 수익률은 출처가 발표하는 경우에만 반환됩니다.

조회할 수 있는 다른 정책 기관은 무엇인가요?

그 밖에 bank-of-canada, bank-of-japan, bank-indonesia 등의 기관이 있습니다. 이들의 정책 경로는 공식 전망이 아니라 예측 시장 확률을 반영합니다.

게시일: . 최종 검토일: .

정확한 레퍼런스로 이동