모든 API

경제 예측시장 API

경제지표 발표와 정책 결정에 대한 시장 내재 확률을 주제와 날짜별 이벤트로 조회하세요. 최신 확률, 분 단위부터 일 단위까지의 이력, 실시간 스트림을 이용할 수 있습니다.

무료 API 키 받기
문서 읽기 →
정상 운영 중100.00% uptime, last 30일288 ms 일반 응답 시간

첫 요청

주제 상세 보기

curl --request GET \
  --url "https://api.narwhalapi.com/v1/predictions/topics/usa-cpi-yoy" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
응답 예시
{
  "topic_id": "usa-cpi-yoy",
  "group": "us_prices",
  "title": "US CPI, 12-month change",
  "shape": "scalar",
  "unit": "percent",
  "venues": [
    "kalshi",
    "polymarket"
  ],
  "resolution_kind": "release",
  "events": [
    {
      "event_id": "usa-cpi-yoy-2026-09",
      "question": "US CPI, 12-month change, September 2026",
      "status": "trading",
      "closes_at": "2026-10-14T12:29:00Z",
      "resolves_at": "2026-10-14T12:30:00Z"
    }
  ]
}

엔드포인트

GET예측 주제 목록/v1/predictions/topics

Narwhal이 다루는 모든 주제와 유형, 단위, 플랫폼. 주제 ID를 찾을 때 사용합니다.

매개변수

  • group선택

    central_banks, us_prices, us_jobs, us_activity, global_activity, global_prices, metals 또는 energy.

목록의 각 주제

  • topic_id필드

    usa-cpi-yoy 같은 주제 ID.

  • group필드

    central_banks나 metals 같은 주제가 속한 그룹.

  • title필드

    주제 이름.

  • shape필드

    스칼라나 이진 등 확률의 구성 방식.

  • unit필드

    usd_per_barrel 같은 값의 단위. 없으면 생략됩니다.

  • venues필드

    호가를 제공하는 플랫폼: kalshi, polymarket 또는 둘 다.

  • resolution_kind필드

    release, price_fix, price_window 또는 occurrence.

  • calendar필드

    주제가 따르는 캘린더 발표 계열로, 국가와 계열이 포함됩니다. 따르는 것이 없으면 생략됩니다.

  • next_event_id필드

    주제에서 처음 열린 이벤트. 없으면 생략됩니다.

전체 레퍼런스 →
GET주제 상세 보기/v1/predictions/topics/{topic_id}

하나의 주제와 그 upcoming 및 trading 이벤트, 그리고 가장 최근의 다른 이벤트 5개.

매개변수

  • topic_id필수

    usa-cpi-yoy 같은 주제 ID.

응답 필드

  • topic_id필드

    usa-cpi-yoy 같은 주제 ID.

  • group필드

    central_banks나 metals 같은 주제가 속한 그룹.

  • title필드

    주제 이름.

  • shape필드

    스칼라나 이진 등 확률의 구성 방식.

  • unit필드

    usd_per_barrel 같은 값의 단위. 없으면 생략됩니다.

  • venues필드

    호가를 제공하는 플랫폼: kalshi, polymarket 또는 둘 다.

  • resolution_kind필드

    release, price_fix, price_window 또는 occurrence.

  • calendar필드

    주제가 따르는 캘린더 발표 계열로, 국가와 계열이 포함됩니다. 따르는 것이 없으면 생략됩니다.

  • events필드

    각 이벤트에는 event_id, question, status, closes_at, resolves_at, release_id, result가 있습니다.

전체 레퍼런스 →
GET날짜별 이벤트 목록/v1/predictions/events

주제를 가로지르는 날짜별 이벤트와 상태, 시각. 주제, 유형, 상태 또는 확정 시각으로 필터링합니다.

매개변수

  • topic선택

    이 주제 ID의 이벤트만.

  • shape선택

    이 유형의 이벤트만.

  • status선택

    upcoming, trading, closed, settled 또는 void.

  • release_id선택

    이 캘린더 발표로 확정되는 이벤트만.

  • from, to선택

    resolves_at을 필터링하는 UTC 시각. from은 to보다 앞이어야 합니다.

  • limit선택

    1에서 100. 기본값은 50입니다.

  • cursor선택

    이전 페이지의 next_cursor를 전달하면 다음 페이지를 읽습니다.

목록의 각 이벤트

  • event_id필드

    이벤트 ID.

  • question필드

    이벤트가 묻는 질문.

  • status필드

    upcoming, trading, closed, settled 또는 void.

  • closes_at, resolves_at필드

    마감 및 확정 시각, UTC 기준.

  • topic_id, shape필드

    주제와 그 확률의 유형.

  • release_id필드

    이벤트가 확정되는 캘린더 발표. 없으면 생략됩니다.

  • result필드

    확정 및 무효 이벤트에서 결과가 최종인지 여부와 확정 시각.

  • next_cursor필드

    다음 페이지의 커서입니다. 마지막 페이지에서는 Null입니다.

전체 레퍼런스 →
GET유형별 이벤트 확률 가져오기/v1/predictions/{shape}/{event_id}

하나의 이벤트에 대한 최신 확률로, 각 플랫폼의 호가와 혼합 확률이 포함됩니다.

매개변수

  • shape필수

    scalar, extreme, timing 또는 binary.

  • event_id필수

    usa-cpi-yoy-2026-09 같은 이벤트 ID.

  • at선택

    과거에 수집된 분으로, UTC 기준입니다.

응답 필드

  • event_id필드

    이벤트 ID.

  • topic_id필드

    이벤트가 속한 주제.

  • question필드

    이벤트가 묻는 질문.

  • status필드

    upcoming, trading, closed, settled 또는 void.

  • closes_at필드

    마감 시각, UTC 기준.

  • resolves_at필드

    확정 시각, UTC 기준.

  • as_of필드

    플랫폼을 마지막으로 확인한 시각.

  • stale필드

    마지막 플랫폼 확인이 3분 넘게 지났으면 true.

  • resolution필드

    이벤트가 어떻게 확정되는지 설명하는 텍스트.

  • resolves_with필드

    공식 값을 게시하는 Narwhal 엔드포인트. 없으면 생략됩니다.

  • venues필드

    플랫폼 시장당 한 레코드: 링크, 규칙, 확정 출처, 가중치, 거래량, 미결제약정.

  • result필드

    각 거래소의 결과로, 이벤트가 정산되거나 무효가 된 후에 제공됩니다.

  • outcomes스칼라

    각 결과에는 key, label, lower, upper, probability, quotes가 있습니다.

  • up, down극값

    구간 내에서 각 고점 또는 저점 수준에 도달할 가능성.

  • steps시점

    각 날짜 또는 회의까지 발생했을 가능성.

  • probability이진

    예(yes)가 될 가능성과 그 근거가 되는 호가.

  • quotes필드

    각 플랫폼의 확률과 그 근거가 되는 Kalshi 티커 또는 Polymarket 시장 ID.

전체 레퍼런스 →
GET이벤트의 과거 확률 가져오기/v1/predictions/{shape}/{event_id}/history

하나의 이벤트에 대한 시간별 확률, 바 형식.

매개변수

  • shape필수

    scalar, extreme, timing 또는 binary.

  • event_id필수

    usa-cpi-yoy-2026-09 같은 이벤트 ID.

  • interval선택

    1m, 5m, 1h(기본값) 또는 1d. 1m과 5m 바는 30일간 보관됩니다.

  • start필수

    시작 시각, UTC 기준.

  • end필수

    start 이후의 종료 시각, UTC 기준. 최대 1m은 2일, 5m은 7일, 1h는 92일, 1d는 3,660일입니다.

  • cursor선택

    이전 페이지의 next_cursor를 같은 start, end, interval과 함께 전달합니다.

응답 필드

  • series필드

    결과당 한 시리즈, 각각 key, active_from, bars 포함.

  • bars필드

    각 바에는 바의 시작인 timestamp와 close가 있습니다. 실시간 바에는 open, high, low가 추가됩니다.

  • active_to필드

    시리즈가 끝나면 한 번 전송됩니다.

  • next_cursor필드

    다음 페이지의 커서입니다. 마지막 페이지에서는 Null입니다.

전체 레퍼런스 →
GET중앙은행 정책 경로 가져오기/v1/predictions/policy-paths/{authority}

다가오는 회의마다 인하, 동결, 인상 확률과 예상 변동(베이시스 포인트).

매개변수

  • authority필수

    federal-reserve, european-central-bank, bank-of-england, bank-of-japan, bank-of-canada, reserve-bank-of-australia 또는 bank-indonesia.

응답 필드

  • as_of필드

    확률을 가져온 시각.

  • meetings필드

    다가오는 회의당 한 행, event_id와 resolves_at 포함.

  • p_cut, p_hold, p_hike필드

    인하, 동결, 인상 가능성.

  • expected_change_bps필드

    회의에서의 확률 가중 변동, 베이시스 포인트 단위.

  • cumulative_change_bps필드

    회의 전반에 걸쳐 합산한 예상 변동.

전체 레퍼런스 →
WSWebSocket으로 실시간 확률 스트리밍/v1/predictions/stream

WebSocket으로 받는 실시간 확률입니다. Authorization 헤더에 키를 보낸 뒤 구독하세요. 연결 한 번에 호출 1회가 듭니다.

매개변수

  • action필수

    subscribe.

  • topics배열

    최대 40개의 주제 ID.

  • event_ids배열

    최대 200개의 이벤트 ID.

메시지

  • snapshot메시지

    유형을 포함한 전체 이벤트.

  • update메시지

    이벤트가 변경되면 다시 전송되며, 최대 분당 한 번입니다.

  • status메시지

    이벤트의 새 상태.

  • heartbeat메시지

    30초마다 전송됩니다.

전체 레퍼런스 →

활용 사례

연방준비제도 금리 결정 확률

다가오는 Fed 회의마다 인하, 동결, 인상 가능성을 읽습니다.

가이드 읽기 →

Polymarket과 Kalshi 비교

하나의 질문에 대해 두 플랫폼을 비교하고 둘 사이의 차이를 확인합니다.

가이드 읽기 →

확률로 읽기

가격을 내재 확률로 바꾸고 오버라운드를 제거합니다.

가이드 읽기 →

확률이 움직일 때 알림

일정에 따라 스크립트를 실행하고 확률이 임계값을 넘어 움직이면 알림을 받습니다.

가이드 읽기 →

실시간 업데이트

WebSocket을 열고 구독하며 재연결을 처리합니다.

가이드 읽기 →

데이터 범위

37개 주제 모두 보기

출처

관련 API

경제 데이터 API

가격, 노동, 생산, 무역 및 금리에 대한 공식 지표입니다.

API 탐색 →

경제 캘린더 API

발표 일정, 상태 및 공표 버전입니다.

API 탐색 →

원자재 API

원래 단위 및 시계열의 정의와 함께 현물 금속과 실물 원자재 가격을 제공합니다.

API 탐색 →

자주 묻는 질문

이 데이터는 공식 경제 수치인가요?

아니요. 시장 내재 확률입니다. 경제 이벤트는 공식 발표로 결과가 확정되며, 이 발표는 Economics API에서도 제공합니다.

확률은 지연되나요?

아니요. 확률은 모든 계정에서 실시간입니다.

어떤 이력과 스트리밍 접근을 사용할 수 있나요?

API는 분 단위부터 일 단위까지의 확률 이력을 제공합니다. 실시간 스트림은 모든 계정에 열려 있으며, 연결 한 번에 호출 1회가 듭니다.

이벤트에는 무엇이 포함되나요?

질문, 마감 및 확정 시각, 공식 확정 출처, 그리고 상태: upcoming, trading, closed, settled 또는 void.

이벤트 유형에는 어떤 것이 있나요?

스칼라 분포, 이진 확률, 극단적 고점과 저점, 타이밍 시장, 그리고 중앙은행 정책 경로.

주제는 무엇을 다루나요?

경제 지표 발표와 중앙은행 금리 결정을 다룹니다. 경제 이벤트는 공식 발표로 결과가 확정됩니다.