문서
API 레퍼런스사이트
전체 문서 탐색

변경 로그

Narwhal API의 제품 및 문서 업데이트입니다.

공개 웹사이트, 문서 및 API 이용 가능 여부의 변경 사항을 확인하세요.

경제 데이터 페이지

  • 국가별 페이지와 각 국가의 지표 페이지를 추가했습니다. 과거 추이 차트, CSV 다운로드, 임베드를 제공합니다.
  • 각 지표의 국가별 보기, 국가 및 월별 경제 캘린더, 수익률 곡선을 추가했습니다.
  • 영문 국가별 데이터 범위 페이지가 이제 각 국가의 데이터 페이지로 리디렉션됩니다.

이벤트와 웹훅

  • 재생 커서와 함께 GET /v1/events 및 /v1/events/stream WebSocket을 추가했습니다.
  • 웹훅 수신 대상을 추가했습니다. 서명된 최소 한 번 전달, 전달 이력, 재생을 지원합니다.
  • predictions 계열에 prediction.event.closed와 prediction.event.settled를 추가했습니다.

FX 지원 통화가 144개로 확대

  • 환율, 과거 데이터, 환산에 113개 통화를 추가했습니다.
  • 기존 31개 통화에 대한 요청은 그대로 유지됩니다.

금속 및 FX 가격 이력

  • 금, 은, 백금, 팔라듐용 GET /v1/commodities/spot/{commodity}/{currency}/bars 및 commodities_get_price_history를 추가했습니다.
  • 한 통화의 USD 대비 데이터를 위한 GET /v1/fx/rates/{base}/bars 및 fx_get_rate_bars를 추가했습니다.
  • 바 간격은 1m, 5m, 15m, 1h, 4h, 1d입니다. 분 단위 바는 최근 30일을 제공하며, 시간 및 일 단위 바는 무기한 보관됩니다. 이용 범위는 요금제의 과거 데이터 조회 기간으로 제한됩니다.

정산된 예측 이벤트에 결과 추가

  • REST와 MCP의 예측 이벤트, 이벤트 목록, 토픽 응답에 결과 필드를 추가했습니다. 이벤트가 정산될 때까지 생략됩니다.
  • 각 거래 플랫폼은 final, settled_at, amended_at, unavailable을 반환합니다. 이벤트 페이지에는 각 시장의 결과와 값도 포함됩니다.
  • Free는 다음 날(일 마감, 00:00 UTC)부터 결과를 볼 수 있습니다. Basic과 Pro는 Narwhal이 확보하는 즉시 볼 수 있습니다.
  • X-Narwhal-Results: unavailable 헤더는 저장된 결과를 읽을 수 없었다는 뜻이며 이로 인해 result가 생략됩니다. 나중에 다시 시도하세요.
  • 스트림과 웹훅은 여전히 상태만 전달합니다.

월간 원자재 기준 가격과 가격 이력

  • 기존 실물 시계열 엔드포인트에 월간 기준 가격을 추가하여 검색, 상세 정보, 최신 가격, 관측값 조회를 지원합니다. REST와 MCP는 동일한 시계열 ID를 사용합니다.
  • 소프트 원자재, 유지 및 유지종자, 금속, 곡물, 에너지, 비료, 임산물, 축산물 및 유제품을 다룹니다. 모든 가격은 USD이며 발표된 단위와 수량을 유지합니다.
  • 이용 가능한 최신 월은 2026년 9월입니다. 일부 시계열은 늦게 시작하거나 종료되었습니다. 각 시계열은 고유한 제공 기간을 표시합니다.
  • 원자재 가격 이력 API 페이지, 구리 응답 예시, 월간 기준 가격의 전체 제공 범위 목록을 추가했습니다.

미국 휘발유 및 경유 소매 가격

  • /v1/commodities/physical/series 아래에 시계열 검색, 시계열 상세 정보, 최신 가격, 관측값을 위한 REST 및 MCP 작업 4개를 추가했습니다.
  • 일반 휘발유와 도로용 2호 경유의 주간 시계열 20개를 추가했습니다. 각각 미국 평균과 9개 지역을 다루며 가격은 미국 갤런당 USD입니다.
  • 이력에는 2026년 7월 20일부터 10월 5일까지 12주가 포함됩니다. 매주 월요일 조사 후 업데이트됩니다. 응답은 날짜, 소수 문자열 형식의 가격, null이 가능한 발표일, 개정 정보, 출처 표시를 유지합니다.

WTI, 브렌트, 구리 기준 가격

  • GET /v1/commodities/spot/{commodity}/{currency} 및 commodities_get_spot_price에 배럴당 USD로 표시되는 WTI와 BRENT, 파운드당 USD로 표시되는 XCU를 추가했습니다.
  • 이 가격은 선물 시장에서 도출한 기준 가격이며, 실물 화물의 현물 가격이 아닙니다. 응답 필드와 stale 플래그는 변경되지 않았습니다.
  • WTI와 BRENT의 가격 이력은 금속과 동일한 간격 및 규칙으로 GET /v1/commodities/spot/{commodity}/USD/bars 및 commodities_get_price_history를 통해 조회할 수 있습니다. 구리는 최신 가격만 지원합니다.

백금 및 팔라듐 현물 가격 추가

  • REST와 MCP를 통해 USD로 표시한 XPT 및 XPD 현물 가격을 추가했습니다.
  • 금과 은은 변경되지 않았습니다. 금은 31개 통화, 은은 USD로 표시됩니다.

현물 가격의 bid 및 ask 필드 제거

  • 현물 가격 응답에서 bid와 ask를 제거했습니다. 남은 필드: symbol, price, currency, unit, timestamp, stale.

경제 발표 지표의 값 유형 확대

  • 모든 지표에 annualization을 추가하고 항상 annualized 또는 not_annualized로 설정하도록 했습니다.
  • 기존 index, percent, thousands에 currency, ratio, balance 단위를 추가하고, 금액에만 currency(ISO 4217 코드)와 scale(units, thousands, millions, hundred_millions, billions)을 포함했습니다.
  • 기존 level, month_over_month, year_over_year에 quarter_over_quarter, three_month_on_three_month, change 변환을 추가했습니다.
  • reference_period와 값의 기간에 기존 월(YYYY-MM)과 분기(YYYY-Qn)에 더해 주 종료일(YYYY-MM-DD)과 이동 3개월 기간(YYYY-MM/YYYY-MM)을 사용할 수 있도록 했습니다.
  • 이 필드에 향후 열거형 값이 추가될 수 있으며, 클라이언트는 파싱에 실패하는 대신 알 수 없는 값을 허용해야 한다는 점을 명확히 했습니다.

과거 환율 관측값 제공 시작

  • GET /v1/fx/rates/{base}/observations 및 fx_get_rate_history를 추가했습니다.
  • 전체 과거 데이터를 소급 수집할 수 있도록 시작일과 종료일을 모두 포함하는 날짜 범위, 날짜 수가 제한된 페이지, 필터에 종속된 불투명 커서를 추가했습니다.
  • 주말, 공휴일 또는 통화별 누락값을 이전 값으로 채우지 않고 실제 관측 날짜를 보존했습니다.

경제 데이터 API에서 네덜란드 데이터 제공 시작

  • 9개의 공개 경제 데이터 REST 작업과 해당 MCP 도구 모두에 NLD를 추가했습니다.
  • Statistics Netherlands (CBS)의 월별 CPI·노동·상품 무역 데이터와 분기별 GDP를 공개했습니다.
  • 네덜란드 데이터 범위, 출처별 방법론, API 문서 및 기계가 읽을 수 있는 검색 정보를 추가했습니다.

과거 경제 데이터 및 네덜란드 데이터 지원

  • REST와 MCP를 통해 페이지네이션을 지원하는 과거 관측값 조회 작업 9개를 추가했습니다.
  • CBS의 네덜란드 공식 인플레이션, 노동, GDP 및 상품 무역 데이터를 추가했습니다.
  • 공개 경제 데이터 API를 10개 국가와 18개 작업으로 확장했습니다.

경제 데이터 공개 베타

  • REST와 MCP를 통해 국가 경제 데이터 작업 9개를 공개했습니다.
  • AUS, CAN, DEU, FRA, GBR, JPN, MYS, SGP 및 USA의 현재 공식 데이터를 출시했습니다.
  • 경제 데이터 빠른 시작과 기계 판독 가능한 검색 기능을 게시했습니다.