Kalshi
Prediction-market data.
Kalshi 거래 조회
Kalshi 시장의 체결 거래 테이프를 가져옵니다. 호가가 아닌 실제 체결입니다. 기간 내 실현 가격과 거래 규모가 필요할 때 사용하세요. 예를 들어 이벤트가 전개되는 동안 확신이 어떻게 움직였는지 확인할 수 있습니다. ticker와 min_ts / max_ts Unix 초 범위로 좁히고, is_block_trade를 설정해 대형 협상 거래만 분리하세요. trade_id, ticker, count_fp(계약 수), yes_price_dollars / no_price_dollars, taker_side, created_time이 포함된 trades[]와 페이지 이동용 cursor를 반환합니다. 체결이 아닌 현재 호가, 정산 규칙, 시장 메타데이터는 get_kalshi_markets를 사용하세요.
가격 참고
- 과금 기준: 성공한 요청당 고정 원가 기준.
- 참고 요청 추정치: USD 0.02.
참고용 메타데이터일 뿐이며, 계정 견적 또는 보장된 가격 또는 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다.
- 유형: stringcursor
페이지네이션 커서입니다. 이전 응답에서 반환된 커서 값을 사용해 다음 결과 페이지를 가져옵니다. 첫 페이지는 비워 두세요.
- 유형: booleanis
_block _trade 거래가 블록 거래인지 여부로 필터링합니다. 모든 거래를 반환하려면 생략하세요.
true로 설정하면 블록 거래만 반환합니다.false로 설정하면 블록 거래가 아닌 거래만 반환합니다. - 유형: integer 형식: int64limit최솟값:0최댓값:1000
페이지당 결과 수입니다. 기본값은 100입니다. 최대값은 1000입니다.
- 유형: integer 형식: int64max
_ts 이 Unix 타임스탬프 이전의 항목을 필터링합니다
- 유형: integer 형식: int64min
_ts 이 Unix 타임스탬프 이후의 항목을 필터링합니다
- 유형: stringticker
시장 티커로 필터링
- 유형: object · Response24B585A0A861_GetTradesResponse200
거래를 성공적으로 가져왔습니다
- 유형: stringcursor필수
- 유형: array object[] · Response24B585A0A861_Trade[]trades필수
- count유형: string · Response24B585A0A861_FixedPointCount
_fp 필수고정 소수점 계약 수 문자열입니다(소수점 2자리, 예: "10.00", 필드 이름에서는 "fp"로 지칭). 요청은 소수점 0-2자리를 허용하고(예: "10", "10.0", "10.00"), 응답은 항상 소수점 2자리로 출력합니다. 소수 계약 값(예: "2.50")이 지원되며, 최소 단위는 0.01 계약입니다.
- created유형: string 형식: date-time
_time 필수이 거래가 체결된 시각입니다.
- is유형: boolean
_block _trade 필수이 거래가 블록 거래로 장외에서 체결된 경우(예: RFQ 또는 협상된 블록 제안) true이고, 표준 호가창에서 체결된 거래는 false입니다.
- no유형: string · Response24B585A0A861_FixedPointDollars
_price _dollars 필수고정 소수점 미국 달러 문자열입니다. 대부분의 요청 필드는 소수점 2-4자리를 허용하고(예: "0.56", "0.5600"), 응답은 최대 6자리까지 출력합니다. 특정 시장의 유효한 호가 간격은 해당 시장의 가격 레벨 구조에 따라 제한됩니다.
- taker유형: string · Response24B585A0A861_BookSide열거형
_book _side 필수주문 또는 거래의 호가 방향입니다. 이벤트 시장에서는 YES 쪽만을 의미합니다.
bid는 YES 매수를,ask는 YES 매도를 뜻합니다. (YES 매도는1 - price에 NO를 매수하는 것과 경제적으로 동일하지만, 이 엔드포인트는 모든 것을 YES 쪽에서 호가합니다.)값- bid
- ask
- taker유형: string 열거형
_outcome _side 필수테이커가 취하는 결과 측입니다. buy-yes와 sell-no는 'yes'를, buy-no와 sell-yes는 'no'를 만듭니다.
taker_outcome_side는 방향성 노출만 설명하며 거래 가격을 바꾸지 않습니다.taker_outcome_side=no인 가격p의 거래는 반대 방향의 동일한 가격p로 메이커와 매칭됩니다. 양측은 같은 가격에 거래합니다.taker_outcome_side와taker_book_side가 거래 방향을 결정하는 표준 방식이 됩니다. 레거시taker_side필드는 향후 릴리스에서 지원 중단되므로 새 필드로 마이그레이션하세요.값- yes =
Trade Taker Outcome Side Yes - no =
Trade Taker Outcome Side No
- ticker유형: string필수
시장의 고유 식별자입니다.
- trade유형: string
_id 필수이 거래의 고유 식별자입니다.
- yes유형: string · Response24B585A0A861_FixedPointDollars
_price _dollars 필수고정 소수점 미국 달러 문자열입니다. 대부분의 요청 필드는 소수점 2-4자리를 허용하고(예: "0.56", "0.5600"), 응답은 최대 6자리까지 출력합니다. 특정 시장의 유효한 호가 간격은 해당 시장의 가격 레벨 구조에 따라 제한됩니다.
- taker유형: string 열거형
_side 지원 중단지원 중단되었습니다. 대신
taker_outcome_side(또는taker_book_side)를 사용하세요. 주문 방향을 참고하세요. 이 필드는 2026년 5월 14일 이전에는 제거되지 않습니다.값- yes =
Trade Taker Side Yes - no =
Trade Taker Side No
application/json - 400
요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요.
- 401
유효한 Felo API 키가 필요합니다.
- 402
청구 요건이 충족되지 않아 요청을 진행할 수 없습니다.
- 403
이 계정에는 이 작업을 수행할 권한이 없습니다.
- 429
요청 또는 지출 한도에 도달했습니다.
- 502
서비스가 요청을 완료할 수 없습니다.
- 503
API 또는 청구 서비스를 일시적으로 사용할 수 없습니다.
- 504
요청을 처리하는 동안 서비스 시간이 초과되었습니다.
- default
오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다.
application/json
curl https://openapi.felo.ai/v1/beta/kalshi/trades \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"trades": [
{
"trade_id": "string",
"ticker": "string",
"count_fp": "10.00",
"yes_price_dollars": "0.5600",
"no_price_dollars": "0.5600",
"taker_outcome_side": "yes",
"taker_book_side": "bid",
"created_time": "2026-10-26T08:08:16.601Z",
"is_block_trade": true
}
],
"cursor": "string"
}