Kalshi API: 공개 데이터, 스트림, 계정 접근 선택

작성: PredictionToolkit · 공개: 2026-11-03

시장 탐색기와 주문 엔진에 필요한 접근은 다릅니다. 먼저 데이터와 작업을 정한 뒤, 자격 증명, 환경, 운영 모델에 맞춰 Kalshi 자체 API나 래퍼를 선택하세요.

이벤트 계약 API 선택하기

Kalshi 문서는 이벤트 계약용 Predictions API와 무기한 선물용 Perps API를 구분합니다. 예측시장 작업은 Predictions에서 시작하세요. 공개 REST 빠른 시작은 인증 없이 시리즈, 이벤트, 시장, 호가장을 조회하지만 계정 데이터나 주문 제출의 익명 접근을 뜻하지는 않습니다.

인터페이스에 맞는 자격 증명

• 공개 시장 REST 조회: 문서화된 탐색 및 호가장 스냅샷 엔드포인트를 사용하세요.
• WebSocket: 공개 시장 데이터 채널을 구독하더라도 연결 핸드셰이크를 인증해야 합니다. 해당 채널은 추가적인 채널별 권한 검사를 요구하지 않습니다.
• 계정 및 거래 작업: 필요한 서명 요청과 계정에 허용된 기능을 사용하세요.

현재 키 가이드는 Ed25519와 RSA-PSS를 지원합니다. 오래된 RSA 전용 예제를 복사하지 말고 실제 클라이언트 버전이 지원하는 키 유형을 선택하세요. 키 ID는 등록된 키를 식별하고 개인 키는 요청에 서명합니다. 개인 키를 브라우저 번들, 공개 저장소, 로그에 넣지 말고 정확한 메서드와 경로는 공식 서명 가이드에서 확인하세요.

데모와 운영 환경 분리하기

권장 REST 호스트는 운영용 external-api.kalshi.com과 데모용 external-api.demo.kalshi.co이며 기본 경로는 /trade-api/v2입니다. 데모와 운영 키는 서로 바꿔 쓸 수 없습니다. 계정이 필요한 개발은 데모에서 시작하고 운영 작업을 활성화하기 전에 환경을 명확히 확인하세요. 데모 결과는 실제 유동성이나 실행을 검증하지 않습니다.

직접 클라이언트, 로컬 래퍼, 호스팅 서비스 중 선택

직접 통합하면 Kalshi 고유 식별자와 API 규약을 그대로 확인할 수 있습니다. PMXT는 거래소가 해당 기능을 구현한 경우 공통 SDK 인터페이스를 제공합니다. 자체 호스팅 모드에서는 로컬 pmxt-core가 거래소에 연결하고 필요할 때 거래소 고유 자격 증명을 사용합니다. 호스팅 PMXT는 자체 키와 인프라를 사용하며, 문서화된 호스팅 쓰기 작업은 PreFundedEscrow 수탁 구조를 사용합니다. SDK 함수 이름뿐 아니라 선택한 모드의 메서드 지원과 수탁 방식을 비교하세요.

범위를 정한 데이터 흐름부터 만들기

• 시리즈, 이벤트, 시장 티커를 확인하고 정확한 계약 규칙을 보관하세요. 이벤트 이름은 거래 가능한 시장의 식별자가 아닙니다.
• 시장·호가장 표본을 작게 조회하고 차트나 비교 기능을 만들기 전에 시각, 가격 단위, 가용 수량을 보관하세요.
• 스트림에서는 연결 끊김과 상태 복구를 처리하세요. 연결이 열려 있다는 사실만으로 사용 가능한 최신 데이터가 입증되지는 않습니다.
• 계정의 현재 한도와 엔드포인트 비용을 확인하고 HTTP 429 응답에는 재시도 간격을 늘리세요.
• 공개 데이터 요청 성공과 별개로 계정 권한과 주문 매개변수의 의미를 검토하세요.

처리 용량과 금전 비용을 나눠 계산하기

Kalshi는 읽기와 쓰기를 나눈 토큰 기반 요청 예산을 문서화합니다. 여기서 토큰은 API 처리 용량을 측정하며 오래된 예제의 초당 요청 수가 공통 한도는 아닙니다. 현재 엔드포인트 비용과 등급 규칙을 확인하세요. 호스팅 업체 요금제, 자체 인프라, 거래소 거래 수수료는 서로 다른 비용 항목입니다.

아래 출처는 이 가이드의 접근 선택을 위해 검토했습니다. 키를 생성하거나 계정을 연결하거나 주문을 제출하지 않았습니다. 연결된 프로필로 통합 인터페이스를 비교하고 구현 전에 공식 문서에서 정확한 엔드포인트와 권한을 확인하세요.