활용 사례
각 페이지는 올바른 영업일을 정하거나 임대료를 인플레이션에 맞춰 조정하는 것처럼 하나의 작업을 다루고, 그 작업을 수행하는 Narwhal 요청과 실제 응답을 보여 줍니다.
캘린더와 발표
데이터와 결정이 나오는 시점을 파악합니다.
| 활용 사례 | 다루는 내용 |
|---|---|
| 경제 캘린더 API로 내 앱 안에 캘린더 보여주기 | 경제 캘린더 API로 제품에 캘린더를 넣으세요. 사용자별 국가 필터, 보는 사람의 시간대로 표시한 발표 시각, 국가별 캐시, 일정이 바뀐 발표 처리를 다룹니다. |
| 발표 전에 경제지표 발표 일정, 대상 기간, 직전 값 확인하기 | 경제지표 발표 일정을 캘린더 API로 확인합니다. 한 나라의 다음 주요 발표를 UTC와 현지 발표 시간, 대상 기간, 직전 값과 함께 발표 전에 찾아볼 수 있습니다. |
| 트레이딩 데스크와 온콜 팀에 경제지표 발표 알림 보내기 | 트레이딩 데스크와 온콜 팀을 위한 경제지표 발표 알림을 만듭니다. 각 메시지에는 UTC 시각, 데스크 현지 시각, 대상 기간, 이전 값이 담깁니다. |
| 기사에 쓸 경제지표 발표 일정과 최신 수치 찾기 | 경제지표 발표 일정과 인플레이션, 실업률, GDP 최신 수치를 기준 기간·발표일과 함께 가져옵니다. 이번 주 발표 지표를 기사에 정확한 기준 월로 쓸 수 있습니다. |
| 중앙은행 기준금리와 시장이 반영한 금리 경로 추적하기 | 여러 나라 중앙은행의 현재 기준금리와 금리 이력을 읽고, 앞으로 열릴 회의의 시장 인하·동결·인상 확률을 더해 시장이 반영한 금리 경로까지 추적합니다. |
공휴일과 영업일
휴장일을 고려해 계획합니다.
| 활용 사례 | 다루는 내용 |
|---|---|
| 영업일 계산으로 두 나라 공휴일이 다른 국경 간 거래의 결제일 구하기 | 영업일 계산으로 두 나라의 공휴일이 다른 국경 간 거래의 결제일을 구합니다. 거래 목록을 양국의 공휴일 목록에 대조해 날짜가 달라진 거래를 표시합니다. |
| 급여 계산을 위해 국가와 연도별 공휴일 나열하기 | 급여 계산을 위해 국가별 공휴일을 연도 단위로 가져오고, 각 항목의 scope와 하위 지역 코드로 전국 공휴일과 지역 공휴일을 구분합니다. 한 번의 호출로 급여용 목록을 받습니다. |
| 배송일 계산 API로 두 나라에 걸친 체크아웃 배송일 약속하기 | 배송일 계산 API로 주문 마감 시각, 택배 소요일, 출고 국가와 배송 국가의 공휴일을 반영한 배송일을 장바구니에 표시하고, 체크아웃에서 약속합니다. |
| 국가별 공휴일 일정을 피해 회의와 릴리스 일정 잡기 | 국가별 공휴일 일정을 공휴일 캘린더 API로 확인해, 여러 나라의 공휴일과 겹치지 않는 회의, 릴리스, 점검 시간대의 날짜를 찾아 일정을 잡습니다. |
| SLA 영업일 계산으로 서비스 수준 계약 위반 타이머 운영하기 | SLA 영업일 계산으로 서비스 데스크에 위반 타이머를 만드는 방법입니다. 계약에서 정해야 할 것과 계약 국가의 Narwhal 공휴일이 타이머에 반영되는 방식을 설명합니다. |
| 해외 공휴일 여행: 공휴일과 히즈라력을 고려해 계획 세우기 | 해외 공휴일 여행을 Narwhal API로 계획합니다. 각 나라의 공휴일, 연휴, 히즈라력 날짜를 바탕으로 여행과 예약을 준비하며, 예약이나 가격 데이터는 담겨 있지 않습니다. |
예측시장
시장 확률(오즈)을 제품이나 연구에 활용합니다.
| 활용 사례 | 다루는 내용 |
|---|---|
| 고객과 딜러에게 금리 인하·동결·인상 확률 보여주기 | 금리 인하, 동결, 인상의 시장 확률을 고객 화면이나 딜링 데스크에 표시하는 방법입니다. 문구 작성, 반올림, 시각 표기, Narwhal에서 새로 받아오는 방법을 다룹니다. |
| 거시경제 예측시장 대시보드: 이벤트별 시장 확률 보기 | Narwhal 예측의 토픽과 이벤트 엔드포인트로 CPI, 고용, 실업률, 경기 침체, 금리 결정에 대한 시장 확률을 보여 주는 거시경제 예측시장 대시보드를 만듭니다. |
| 예측시장 아비트라지: 같은 이벤트의 두 시장 가격 차이 스크리닝 | 예측시장 아비트라지를 위해 Kalshi와 Polymarket을 보는 데스크는 Narwhal 호출 한 번으로 두 호가, 규칙 문구, 정산 출처를 받아 가격 차이를 지급 조건과 대조합니다. |
| 예측시장 과거 데이터: 연구용 확률 이력과 정산 결과 가져오기 | 예측시장 과거 데이터가 필요할 때, Narwhal API에서 예측시장의 확률 이력과 정산된 이벤트의 결과를 가져옵니다. 응답의 as_of, stale, final 값을 읽어 연구에 쓸 수 있습니다. |
| 예측시장 트레이딩 신호: 예상 변동폭의 변화 측정하기 | Narwhal 정책금리 경로를 폴링해 중앙은행 결정에 대한 시장 확률을 읽고, 두 번의 조회 사이에서 예상 변동폭의 변화를 베이시스포인트로 계산합니다. 예측시장을 트레이딩 신호로 활용하는 방법입니다. |
인플레이션, 금리, 거시경제
공식 통계로 조정, 비교, 모니터링합니다.
| 활용 사례 | 다루는 내용 |
|---|---|
| 물가 상승 반영해 과거 예산과 계약 금액을 현재 가격으로 환산하기 | 보고서에 쓸 과거 예산과 계약 금액을 현재 화폐 가치로 환산해 물가 상승을 반영합니다. 기준월과 지수를 고르고, API의 CPI로 수치에 표기를 붙입니다. |
| 하한과 상한을 둔 CPI 임대료 인상률 계산하기 | 임대료 인상률 계산을 하한과 상한을 적용해 합니다. Narwhal API의 CPI 관측값 두 개로 연간 인상률을 구하는 과정을, 직접 실행할 수 있는 Python 스크립트로 보여 줍니다. |
| 실질 임금 계산으로 연봉 인상이 두 나라 물가를 따라가는지 확인하기 | 실질 임금 계산으로 연봉 인상이 물가를 따라가는지 확인합니다. 두 나라의 CPI 전년 대비 물가 상승률을 Narwhal 인플레이션 엔드포인트로 비교해 봅니다. |
| 수익률곡선 모니터링: 스프레드를 매일 기록하고 임계값과 비교하기 | 수익률곡선 모니터링을 위한 리스크 팀용 일일 점검입니다. 히스토리 경로에서 스프레드를 저장하고 임계값과 비교해 표시하며, 실행마다 원본 날짜와 함께 기록합니다. |
| 국가별 주식 위험 프리미엄과 자본비용 입력값 구하기 | 대상 국가의 주식 위험 프리미엄을 성숙시장 프리미엄과 국가 위험 프리미엄으로 나누어 구하고, 이를 자기자본비용과 WACC 계산에 사용하는 방법을 설명합니다. |
| 신흥국 경제 지표로 인플레이션, 정책금리, 성장률 비교하기 | 신흥국 경제 지표를 하나의 API로 비교합니다. 인도네시아, 브라질, 멕시코, 인도 등의 인플레이션, 정책금리, GDP 성장률을 보고 데이터가 없는 나라는 연간 계열로 대체합니다. |
| 실시간 공식 데이터로 경제학 수업 연습문제 만들기 | 실질금리와 GDP 속 물가 상승분을 주제로 경제학 수업 연습문제를 만듭니다. 공식 출처의 실시간 인플레이션, 정책금리, GDP 데이터를 쓰며 요청 예시와 Python 계산까지 확인할 수 있습니다. |
이 활용 사례 소개
각 활용 사례는 작업을 밝히고, 실제 요청과 응답을 보여 주며, 자세한 내용은 사용법 가이드와 API 페이지로 연결합니다.
모든 예시는 같은 무료 API 키를 사용하며, 이 키에는 처음 12개월 동안 매달 $10의 무료 크레딧이 제공됩니다.
이 데이터를 API로 받기
요청 시험해 보기.
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
"https://api.narwhalapi.com/v1/calendars/holidays/IDN/on/2026-08-17"무료 키로 시작하세요
12개월 동안 매달 10달러 상당의 무료 크레딧을 드립니다. 카드는 필요하지 않습니다.매달 10달러 상당의 무료 크레딧. 카드는 필요하지 않습니다.