모든 API

Narwhal로 쓰는 Kalshi API 확률

중앙은행 결정, CPI, 고용, GDP, 금속, 에너지에 대한 Kalshi와 Polymarket 확률을 하나의 Narwhal 스키마로 읽습니다. Narwhal은 읽기 전용입니다.

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

첫 요청

이벤트 확률 가져오기

curl --request GET \
  --url "https://api.narwhalapi.com/v1/predictions/scalar/usa-fed-2026-10" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
2026년 10월 Fed 결정의 응답 예시, 결과 두 개로 줄임
{
  "event_id": "usa-fed-2026-10",
  "topic_id": "usa-fed",
  "question": "Federal Reserve rate decision, 28 October 2026",
  "status": "trading",
  "closes_at": "2026-10-28T17:59:00Z",
  "resolves_at": "2026-10-28T18:00:00Z",
  "release_id": "ae2a77cc-3b5b-4541-a060-3bc2ea1145d9",
  "resolution": "Change in the Federal Reserve policy rate announced at the meeting, in basis points",
  "resolves_with": "/v1/economics/USA/central-bank/policy-rate",
  "unit": "bps",
  "venues": [
    {
      "venue": "kalshi",
      "weight": "0.3353",
      "volume_24h_usd": "15376.51"
    },
    {
      "venue": "polymarket",
      "weight": "0.6647",
      "volume_24h_usd": "531149.67"
    }
  ],
  "outcomes": [
    {
      "key": "cut_25",
      "label": "Cut of 25 bps",
      "lower": "-37.5",
      "upper": "-12.5",
      "probability": "0.0059",
      "quotes": [
        {
          "venue": "kalshi",
          "probability": "0.0049",
          "market_ids": [
            "KXFEDDECISION-26OCT-C25"
          ]
        },
        {
          "venue": "polymarket",
          "probability": "0.0064",
          "market_ids": [
            "3326851035…5947"
          ]
        }
      ]
    },
    {
      "key": "cut_50_plus",
      "label": "Cut of 50 bps or more",
      "lower": null,
      "upper": "-37.5",
      "probability": "0.0026",
      "quotes": [
        {
          "venue": "kalshi",
          "probability": "0.0050",
          "market_ids": [
            "KXFEDDECISION-26OCT-C26"
          ]
        },
        {
          "venue": "polymarket",
          "probability": "0.0015",
          "market_ids": [
            "1701037799…5586"
          ]
        }
      ]
    }
  ]
}

엔드포인트

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/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입니다.

전체 레퍼런스 →
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을 열고 구독하며 재연결을 처리합니다.

가이드 읽기 →

데이터 범위

27개 주제 모두 보기

출처

관련 API

예측 시장 API

Kalshi와 Polymarket의 경제 및 상품 확률을 하나의 스키마로 제공합니다.

API 탐색 →

Kalshi와 Polymarket 확률 API 레퍼런스

엔드포인트, 필드, 플랫폼 역할, 이력, WebSocket 스트림.

레퍼런스 읽기 →

자주 묻는 질문

이것은 공식 Kalshi API인가요?

아니요. Narwhal은 Kalshi의 공개 시장 데이터를 읽어 Polymarket과 나란히 자체 형식으로 반환합니다. 거래하거나 Narwhal이 다루지 않는 시장을 읽으려면 Kalshi의 자체 API를 사용합니다.

Narwhal로 거래할 수 있나요?

아니요. Narwhal은 읽기 전용입니다. 확률과 그 근거가 되는 플랫폼 시장을 반환하며, 주문이나 호가창은 제공하지 않습니다.

Kalshi 확률은 얼마나 최신인가요?

확률은 60초마다 읽어 옵니다. 모든 계정이 실시간 확률을 볼 수 있고 스트림과 웹훅도 쓸 수 있습니다.

왜 Narwhal로 Kalshi를 읽나요?

Kalshi와 Polymarket을 위한 하나의 스키마, 혼합 확률, 분 단위 이력, 각 시장이 확정되는 공식 발표 링크, 웹훅, MCP 도구.

어떤 Kalshi 티커를 받나요?

각 결과에는 그 근거가 되는 Kalshi 시장 티커가 나열되며, 같은 질문의 Polymarket 시장과 혼합 확률이 함께 제공됩니다.

시장은 공식 발표와 연결되나요?

각 시장은 확정 기준이 되는 공식 발표로 연결됩니다.

어떤 이력, 스트림, 웹훅을 사용할 수 있나요?

최근 30일간 수집된 분 단위 이력을 읽을 수 있습니다. 모든 계정이 실시간 확률, WebSocket 스트림, 시장 마감 또는 정산 시 웹훅도 받을 수 있습니다.

어떤 Kalshi 시장을 다루나요?

Narwhal은 적용 범위에 나열된 경제 및 상품 주제에 Kalshi 시장을 사용합니다. 스포츠, 정치 등 다른 Kalshi 시장은 포함되지 않습니다.