Kalshi API 데이터
Kalshi API 데이터: 시장, 주문서, 캔들스틱 및 거래
Kalshi 공개 API는 시리즈, 이벤트, 시장, 현재 주문서, 캔들스틱, 거래를 반환하며, 이 호출들에는 API 키가 필요 없습니다. 반환하지 않는 것은 과거 시점의 주문서입니다. 이 페이지는 각 Kalshi 데이터 유형을 엔드포인트에 매핑하고 호출을 보여주며, 1.5십억 개 기록된 주문서로 공백을 메웁니다.
Kalshi API 데이터는 https://external-api.kalshi.com/trade-api/v2.에서 Kalshi의 Trade API가 제공하는 거래소 데이터입니다. 공개 시장 데이터는 시리즈, 이벤트, 시장, 현재 주문서, 캔들스틱 및 거래를 포함하며, 게시된 컷오프보다 오래된 결제 데이터는 /historical 엔드포인트로 이동합니다. 계정 데이터(주문, 체결, 포지션)는 RSA 서명 API 키 요청이 필요합니다.
기록된 하나의 Kalshi 주문서
DepthFeed 아카이브에 저장된 BTC 15분 관찰 중 하나에서 복사됨. Kalshi의 주문서 응답은 현재 순간에 대해 동일한 두 개의 매수 호가 사다리를 포함합니다.
가격 p에서의 예 매수는 1 − p에서의 아니오 매도이며, 따라서 내재된 예 매도는 1 − 최상의 아니오 매수입니다.: 전체 깊이 REST 폴링.
- yes_dollars / yes_prices
- 대기 중인 예 매수 호가를 가격 및 계약 수로, 최적 우선.
- no_dollars / no_prices
- 대기 중인 아니오 매수 호가. 각각은 1 − 가격의 예 매도 제안이며, 이는 암시된 예 매도 호가(여기서는 0.33)를 제공합니다.
- 티커
- 정확한 시장 티커, 행사가 포함입니다.
- recv_ts_ms
- DepthFeed의 수신 시간은 에포크 밀리초 단위이며; Kalshi의 주문서 응답에는 거래소 타임스탬프가 없습니다.
Kalshi API 데이터 개요
- 기본 URL
- https://external-api.kalshi.com/trade-api/v2
- 시장 데이터 인증
- 시리즈, 이벤트, 시장, 주문서, 캔들스틱 및 거래에 해당 없음
- Account data auth
- RSA 서명 API 키 헤더
- 주문서
- 현재 매수 및 매도 호가 사다리; 매도 = 1 − 최상의 반대 매수
- 캔들스틱 기간
- 1 분 · 1 시간 · 1 일
- 오래된 결제 데이터
- 공개된 기준 시점 이후의 /historical 엔드포인트
- 과거 주문서
- Kalshi에서 제공하지 않음; DepthFeed가 2026-01-08부터 기록함
curl로 Kalshi API 데이터 가져오기
아래의 모든 호출은 공개적입니다. 첫 번째 응답에서 티커를 교체하세요; 타임스탬프는 유닉스 초입니다.
# Open markets in one series
curl -s "https://external-api.kalshi.com/trade-api/v2/markets?series_ticker=KXBTC15M&status=open&limit=5"
# The current order book for one exact market
curl -s "https://external-api.kalshi.com/trade-api/v2/markets/<market_ticker>/orderbook"
# Hourly candles for that market
curl -s "https://external-api.kalshi.com/trade-api/v2/series/KXBTC15M/markets/<market_ticker>/candlesticks?start_ts=1793232000&end_ts=1793318400&period_interval=60"
# Recent trades, then the cutoff for older ones
curl -s "https://external-api.kalshi.com/trade-api/v2/markets/trades?ticker=<market_ticker>&limit=100"
curl -s "https://external-api.kalshi.com/trade-api/v2/historical/cutoff"- 커서 필드가 빈 값으로 돌아올 때까지 따라가세요.
- 예 매도 호가를 1 − 최적의 아니오 매수 호가로 읽기; 주문장에 별도의 매도 배열이 없습니다.
- 컷오프 이전에 결제된 시장은 /historical 엔드포인트에만 있음.
Kalshi API 데이터
Kalshi API가 반환하는 데이터와 출처
시리즈, 이벤트 및 시장: 계층 구조
시리즈는 반복되는 질문입니다 (KXBTC15M은 비트코인 매 15분마다), 이벤트는 그 한 인스턴스이며, 시장은 이벤트 내 하나의 거래 가능한 예/아니오 계약으로, 행사가가 티커에 포함됩니다. GET /series/{series_ticker}, GET /events/{event_ticker}, GET /markets?series_ticker=…가 이를 반환합니다. 전체 시장 티커를 조인 키로 사용하세요: 이벤트 티커는 매우 다른 가격의 여러 시장을 명명합니다.
API 키 없는 시장 데이터
Kalshi는 시장 데이터 엔드포인트를 공개로 문서화하여 시리즈, 이벤트, 시장, 주문서, 캔들스틱 또는 거래에 API 키 헤더가 필요 없습니다. 프로덕션 기본 URL은 https://external-api.kalshi.com/trade-api/v2;이며, 이전 api.elections.kalshi.com 호스트는 선거뿐 아니라 동일한 시장을 제공합니다. 계정 측(주문, 체결, 포지션)과 WebSocket 피드에는 키가 필요합니다.
주문서: 매수만, 현재 데이터만
GET /markets/{ticker}/orderbook은 계약 수와 함께 달러 가격으로 된 두 개의 매수 사다리, 예와 아니오를 반환합니다 (orderbook_fp.yes_dollars 및 no_dollars). 매도 배열은 없습니다: p에서의 아니오 매수는 1 − p에서의 예 매도이므로, 이 페이지의 기록 샘플에서 최우선 예 매수는 0.32, 최우선 아니오 매수는 0.67, 암시된 예 매도는 0.33입니다. 응답은 현재 장부이며, 나중에 다시 호출해도 과거 상태를 알 수 없습니다.
캔들스틱: 1분, 시간별 또는 일별
GET /series/{series_ticker}/markets/{ticker}/candlesticks는 start_ts, end_ts 및 1, 60 또는 1440분의 period_interval을 받습니다. 각 캔들은 예 매수, 예 매도 및 거래 가격에 대한 시가, 고가, 저가, 종가와 거래량 및 미결제약정을 포함합니다. 이는 시장 차트를 그리는 가장 저렴한 방법이지만, 거래된 가격과 장부 최상단 마감 가격만 기록하며, 사용 가능한 크기는 기록하지 않습니다.
거래 및 오래된 데이터 이동 위치
GET /markets/trades는 커서 페이지네이션으로 실행된 거래를 나열합니다. Kalshi는 데이터를 실시간 및 과거 등급으로 분할합니다: 시장이 GET /historical/cutoff에 게시된 컷오프 이전에 결제되면, 해당 시장과 캔들스틱은 GET /historical/markets 및 /historical/markets/{ticker}/candlesticks에서 제공되고, 이전 거래는 GET /historical/trades에서 제공됩니다. 라이브 엔드포인트가 모든 데이터를 포함한다고 가정하기 전에 각 데이터 유형의 컷오프를 확인하세요.
요율 제한 및 폴링
Kalshi의 제한은 초당 요청 수가 아닌 티어별 토큰 예산이며, 읽기 및 쓰기 버킷이 별도입니다. 모든 열린 시장에 대해 주문서 엔드포인트를 폴링하면 읽기 예산이 빠르게 소진됩니다. 429 응답 시 지수 백오프로 재시도하고, 커서를 사용해 페이지를 비울 때까지 반복하며, 모든 주문서 변경을 실시간으로 받아야 할 때는 인증된 WebSocket을 사용하세요.
Kalshi API가 제공하지 않는 것
Kalshi의 어떤 엔드포인트도 한 시간, 일주일 또는 한 달 전의 Yes 및 No 주문장을 반환하지 않습니다. 과거 의사결정 시점의 스프레드와 대기 주문 수량이 필요한 백테스트에는 당시 기록한 주문장이 필요합니다. DepthFeed는 2026년 1월부터 Kalshi의 전체 깊이 주문장을 폴링했습니다. 2026년 6월 21일 기준으로 2,600,000개 이상의 시장에 걸친 1.5십억 개의 스냅샷을 REST 또는 197개의 확정된 일별 Parquet 파일로 제공합니다.
Kalshi API가 유지하지 않는 주문서를 추가합니다
Kalshi 공개 API는 시장, 캔들, 거래를 무료로 제공합니다. 백테스트가 과거 시점의 대기 중인 예스 및 노 래더를 필요로 할 때는 무료 키로 DepthFeed의 기록된 주문서를 쿼리하거나 UTC 전체 일 단위 Parquet 파일을 구매하세요.
