Kalshi
Prediction-market data.
Kalshi 시장 조회
문서화된 status, ticker, event, series, 타임스탬프 필터로 예측 시장을 나열합니다. 계약에는 max_updated_ts가 포함되어 있지만 자유 텍스트 검색 매개변수는 선언되어 있지 않습니다. 시장 레코드와 페이지네이션은 응답 스키마를 따르세요.
가격 참고
- 과금 기준: 성공한 요청당 고정 원가 기준.
- 참고 요청 추정치: USD 0.02.
참고용 메타데이터일 뿐이며, 계정 견적 또는 보장된 가격 또는 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다.
- 유형: stringcursor
페이지네이션 커서입니다. 이전 응답에서 반환된 커서 값을 사용해 다음 결과 페이지를 가져옵니다. 첫 페이지는 비워 두세요.
- 유형: stringevent
_ticker 필터링할 이벤트 티커입니다. 이벤트 티커 하나만 지원됩니다.
- 유형: integer 형식: int64limit최솟값:0최댓값:1000
페이지당 결과 수입니다. 기본값은 100입니다. 최대값은 1000입니다.
- 유형: integer 형식: int64max
_close _ts 이 Unix 타임스탬프 이전에 종료되는 항목을 필터링합니다
- 유형: integer 형식: int64max
_created _ts 이 Unix 타임스탬프 이전에 생성된 항목을 필터링합니다
- 유형: integer 형식: int64max
_settled _ts 이 Unix 타임스탬프 이전에 정산된 항목을 필터링합니다
- 유형: integer 형식: int64max
_updated _ts 메타데이터가 이 Unix 타임스탬프(초) 또는 그 이전에 업데이트된 시장을 반환합니다. 거래 외 변경 사항만 추적합니다. min_updated_ts 및 mve_filter=exclude와 함께 사용할 수 있습니다. series_ticker와도 함께 사용할 수 있지만 mve_filter=exclude가 필요합니다. 다른 필터와는 함께 사용할 수 없습니다.
- 유형: integer 형식: int64min
_close _ts 이 Unix 타임스탬프 이후에 종료되는 항목을 필터링합니다
- 유형: integer 형식: int64min
_created _ts 이 Unix 타임스탬프 이후에 생성된 항목을 필터링합니다
- 유형: integer 형식: int64min
_settled _ts 이 Unix 타임스탬프 이후에 정산된 항목을 필터링합니다
- 유형: integer 형식: int64min
_updated _ts 메타데이터가 이 Unix 타임스탬프(초) 이후에 업데이트된 시장을 반환합니다. 거래 외 변경 사항만 추적합니다. max_updated_ts 및 mve_filter=exclude와 함께 사용할 수 있습니다. series_ticker와도 함께 사용할 수 있지만 mve_filter=exclude가 필요합니다. 다른 필터와는 함께 사용할 수 없습니다.
- 유형: string 열거형mve
_filter 복합 이벤트(콤보)로 필터링합니다. 'only'는 복합 이벤트만 반환하고, 'exclude'는 복합 이벤트를 제외합니다.
값- only
- exclude
- 유형: stringseries
_ticker 시리즈 티커로 필터링
- 유형: string 열거형status
시장 상태로 필터링합니다. 모든 상태의 시장을 반환하려면 비워 두세요.
값- unopened
- open
- paused
- closed
- settled
- 유형: stringtickers
특정 시장 티커로 필터링합니다. 검색할 시장 티커를 쉼표로 구분한 목록입니다.
- 유형: object · Response24B585A0A861_GetMarketsResponse200
시장을 성공적으로 가져왔습니다
- 유형: stringcursor필수
- 유형: array object[] · Response24B585A0A861_Market[]markets필수
- can유형: boolean
_close _early 필수 - close유형: string 형식: date-time
_time 필수the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- created유형: string 형식: date-time
_time 필수the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- event유형: string
_ticker 필수 - expiration유형: string
_value 필수정산에 고려된 값
- last유형: string · Response24B585A0A861_FixedPointDollars
_price _dollars 필수고정 소수점 미국 달러 문자열입니다. 대부분의 요청 필드는 소수점 2-4자리를 허용하고(예: "0.56", "0.5600"), 응답은 최대 6자리까지 출력합니다. 특정 시장의 유효한 호가 간격은 해당 시장의 가격 레벨 구조에 따라 제한됩니다.
- latest유형: string 형식: date-time
_expiration _time 필수이 시장의 최대 만료 가능 시각
- market유형: string 열거형
_type 필수시장 유형을 식별합니다
값- binary
- scalar
- no유형: string · Response24B585A0A861_FixedPointDollars
_ask _dollars 필수고정 소수점 미국 달러 문자열입니다. 대부분의 요청 필드는 소수점 2-4자리를 허용하고(예: "0.56", "0.5600"), 응답은 최대 6자리까지 출력합니다. 특정 시장의 유효한 호가 간격은 해당 시장의 가격 레벨 구조에 따라 제한됩니다.
- no유형: string · Response24B585A0A861_FixedPointDollars
_bid _dollars 필수고정 소수점 미국 달러 문자열입니다. 대부분의 요청 필드는 소수점 2-4자리를 허용하고(예: "0.56", "0.5600"), 응답은 최대 6자리까지 출력합니다. 특정 시장의 유효한 호가 간격은 해당 시장의 가격 레벨 구조에 따라 제한됩니다.
- no유형: string
_sub _title 필수이 시장의 NO 쪽에 대한 축약 제목
- notional유형: string · Response24B585A0A861_FixedPointDollars
_value _dollars 필수고정 소수점 미국 달러 문자열입니다. 대부분의 요청 필드는 소수점 2-4자리를 허용하고(예: "0.56", "0.5600"), 응답은 최대 6자리까지 출력합니다. 특정 시장의 유효한 호가 간격은 해당 시장의 가격 레벨 구조에 따라 제한됩니다.
- open유형: string · Response24B585A0A861_FixedPointCount
_interest _fp 필수고정 소수점 계약 수 문자열입니다(소수점 2자리, 예: "10.00", 필드 이름에서는 "fp"로 지칭). 요청은 소수점 0-2자리를 허용하고(예: "10", "10.0", "10.00"), 응답은 항상 소수점 2자리로 출력합니다. 소수 계약 값(예: "2.50")이 지원되며, 최소 단위는 0.01 계약입니다.
- open유형: string 형식: date-time
_time 필수the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- previous유형: string · Response24B585A0A861_FixedPointDollars
_price _dollars 필수고정 소수점 미국 달러 문자열입니다. 대부분의 요청 필드는 소수점 2-4자리를 허용하고(예: "0.56", "0.5600"), 응답은 최대 6자리까지 출력합니다. 특정 시장의 유효한 호가 간격은 해당 시장의 가격 레벨 구조에 따라 제한됩니다.
- previous유형: string · Response24B585A0A861_FixedPointDollars
_yes _ask _dollars 필수고정 소수점 미국 달러 문자열입니다. 대부분의 요청 필드는 소수점 2-4자리를 허용하고(예: "0.56", "0.5600"), 응답은 최대 6자리까지 출력합니다. 특정 시장의 유효한 호가 간격은 해당 시장의 가격 레벨 구조에 따라 제한됩니다.
- previous유형: string · Response24B585A0A861_FixedPointDollars
_yes _bid _dollars 필수고정 소수점 미국 달러 문자열입니다. 대부분의 요청 필드는 소수점 2-4자리를 허용하고(예: "0.56", "0.5600"), 응답은 최대 6자리까지 출력합니다. 특정 시장의 유효한 호가 간격은 해당 시장의 가격 레벨 구조에 따라 제한됩니다.
- price유형: string
_level _structure 필수이 시장의 가격 레벨 구조로, 가격 범위와 호가 단위를 정의합니다
- price유형: array object[] · Response24B585A0A861_PriceRange[]
_ranges 필수이 시장의 주문에 유효한 가격 범위
- end유형: string필수
이 범위의 종료 가격(달러)입니다.
- start유형: string필수
이 범위의 시작 가격(달러)입니다.
- step유형: string필수
이 범위의 가격 단위/틱 크기(달러)입니다.
- result유형: string 열거형필수값
- yes
- no
- scalar
- rules유형: string
_primary 필수가장 중요한 시장 조건에 대한 쉬운 설명
- rules유형: string
_secondary 필수2차 시장 조건에 대한 쉬운 설명
- settlement유형: string 열거형
_bounds _type 필수이 시장에 적용되는 정산 경계입니다. default는 시장에 정산 경계가 없음을 의미합니다
값- default
- floor
- settlement유형: integer
_timer _seconds 필수판정 후 시장이 정산되기까지 걸리는 시간입니다.
- status유형: string 열거형필수
수명 주기에서 시장의 현재 상태입니다.
값- initialized
- inactive
- active
- closed
- determined
- disputed
- amended
- finalized
- ticker유형: string필수
- updated유형: string 형식: date-time
_time 필수마지막으로 거래와 무관한 메타데이터가 업데이트된 시각입니다.
- volume유형: string · Response24B585A0A861_FixedPointCount
_24h _fp 필수고정 소수점 계약 수 문자열입니다(소수점 2자리, 예: "10.00", 필드 이름에서는 "fp"로 지칭). 요청은 소수점 0-2자리를 허용하고(예: "10", "10.0", "10.00"), 응답은 항상 소수점 2자리로 출력합니다. 소수 계약 값(예: "2.50")이 지원되며, 최소 단위는 0.01 계약입니다.
- volume유형: string · Response24B585A0A861_FixedPointCount
_fp 필수고정 소수점 계약 수 문자열입니다(소수점 2자리, 예: "10.00", 필드 이름에서는 "fp"로 지칭). 요청은 소수점 0-2자리를 허용하고(예: "10", "10.0", "10.00"), 응답은 항상 소수점 2자리로 출력합니다. 소수 계약 값(예: "2.50")이 지원되며, 최소 단위는 0.01 계약입니다.
- yes유형: string · Response24B585A0A861_FixedPointDollars
_ask _dollars 필수고정 소수점 미국 달러 문자열입니다. 대부분의 요청 필드는 소수점 2-4자리를 허용하고(예: "0.56", "0.5600"), 응답은 최대 6자리까지 출력합니다. 특정 시장의 유효한 호가 간격은 해당 시장의 가격 레벨 구조에 따라 제한됩니다.
- yes유형: string · Response24B585A0A861_FixedPointCount
_ask _size _fp 필수고정 소수점 계약 수 문자열입니다(소수점 2자리, 예: "10.00", 필드 이름에서는 "fp"로 지칭). 요청은 소수점 0-2자리를 허용하고(예: "10", "10.0", "10.00"), 응답은 항상 소수점 2자리로 출력합니다. 소수 계약 값(예: "2.50")이 지원되며, 최소 단위는 0.01 계약입니다.
- yes유형: string · Response24B585A0A861_FixedPointDollars
_bid _dollars 필수고정 소수점 미국 달러 문자열입니다. 대부분의 요청 필드는 소수점 2-4자리를 허용하고(예: "0.56", "0.5600"), 응답은 최대 6자리까지 출력합니다. 특정 시장의 유효한 호가 간격은 해당 시장의 가격 레벨 구조에 따라 제한됩니다.
- yes유형: string · Response24B585A0A861_FixedPointCount
_bid _size _fp 필수고정 소수점 계약 수 문자열입니다(소수점 2자리, 예: "10.00", 필드 이름에서는 "fp"로 지칭). 요청은 소수점 0-2자리를 허용하고(예: "10", "10.0", "10.00"), 응답은 항상 소수점 2자리로 출력합니다. 소수 계약 값(예: "2.50")이 지원되며, 최소 단위는 0.01 계약입니다.
- yes유형: string
_sub _title 필수이 시장의 예(yes) 측에 대한 축약 제목입니다.
- cap유형: number | null 형식: double
_strike YES 정산으로 이어지는 최대 만료 값
- custom유형: object | null
_strike YES 정산으로 이어지는 각 대상의 만료 값
- early유형: string | null
_close _condition 시장이 조기 종료될 수 있는 조건
- exchange유형: integer · Response24B585A0A861_ExchangeIndex
_index 거래소 샤드의 식별자입니다.
- expected유형: string | null 형식: date-time
_expiration _time 이 시장이 만료될 것으로 예상되는 시각
- expiration유형: string 형식: date-time
_time 지원 중단the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- fee유형: string | null 형식: date-time
_waiver _expiration _time 이 시장의 수수료 면제가 만료되는 시각
- floor유형: number | null 형식: double
_strike YES 정산으로 이어지는 최소 만료 값
- functional유형: string | null
_strike 만료 값에서 정산 값으로의 매핑
- is유형: boolean
_provisional true이면 확정 후 시장에 활동이 없을 경우 해당 시장이 제거될 수 있습니다
- mve유형: string
_collection _ticker 다변량 이벤트 컬렉션의 티커
- mve유형: array object[] · Response24B585A0A861_MveSelectedLeg[]
_selected _legs - event유형: string
_ticker 선택한 이벤트의 고유 식별자입니다.
- market유형: string
_ticker 선택한 시장의 고유 식별자입니다.
- side유형: string
선택한 시장의 사이드입니다.
- yes유형: string · Response24B585A0A861_FixedPointDollars
_settlement _value _dollars 고정 소수점 미국 달러 문자열입니다. 대부분의 요청 필드는 소수점 2-4자리를 허용하고(예: "0.56", "0.5600"), 응답은 최대 6자리까지 출력합니다. 특정 시장의 유효한 호가 간격은 해당 시장의 가격 레벨 구조에 따라 제한됩니다.
- occurrence유형: string | null 형식: date-time
_datetime 기초 이벤트가 발생한 기록된 날짜와 시각(사용 가능한 경우)
- primary유형: string | null
_participant _key - settlement유형: string · Response24B585A0A861_FixedPointDollars
_floor _dollars 고정 소수점 미국 달러 문자열입니다. 대부분의 요청 필드는 소수점 2-4자리를 허용하고(예: "0.56", "0.5600"), 응답은 최대 6자리까지 출력합니다. 특정 시장의 유효한 호가 간격은 해당 시장의 가격 레벨 구조에 따라 제한됩니다.
- settlement유형: string | null 형식: date-time
_ts 시장이 정산된 시각입니다. 정산된 시장에만 값이 채워집니다.
- settlement유형: string · Response24B585A0A861_FixedPointDollars
_value _dollars 고정 소수점 미국 달러 문자열입니다. 대부분의 요청 필드는 소수점 2-4자리를 허용하고(예: "0.56", "0.5600"), 응답은 최대 6자리까지 출력합니다. 특정 시장의 유효한 호가 간격은 해당 시장의 가격 레벨 구조에 따라 제한됩니다.
- strike유형: string 열거형
_type 행사가 유형은 시장 행사가가 어떻게 정의되고 평가되는지를 나타냅니다.
값- greater
- greater
_or _equal - less
- less
_or _equal - between
- functional
- custom
- structured
- subtitle유형: string지원 중단
- title유형: string지원 중단
application/json - 400
요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요.
- 401
유효한 Felo API 키가 필요합니다.
- 402
청구 요건이 충족되지 않아 요청을 진행할 수 없습니다.
- 403
이 계정에는 이 작업을 수행할 권한이 없습니다.
- 429
요청 또는 지출 한도에 도달했습니다.
- 502
서비스가 요청을 완료할 수 없습니다.
- 503
API 또는 청구 서비스를 일시적으로 사용할 수 없습니다.
- 504
요청을 처리하는 동안 서비스 시간이 초과되었습니다.
- default
오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다.
application/json
curl https://openapi.felo.ai/v1/beta/kalshi/markets \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"markets": [
{
"ticker": "string",
"event_ticker": "string",
"market_type": "binary",
"yes_sub_title": "string",
"no_sub_title": "string",
"created_time": "2026-10-26T08:08:16.678Z",
"updated_time": "2026-10-26T08:08:16.678Z",
"open_time": "2026-10-26T08:08:16.678Z",
"close_time": "2026-10-26T08:08:16.678Z",
"expected_expiration_time": null,
"latest_expiration_time": "2026-10-26T08:08:16.678Z",
"settlement_timer_seconds": 1,
"status": "initialized",
"yes_bid_dollars": "0.5600",
"yes_bid_size_fp": "10.00",
"yes_ask_dollars": "0.5600",
"yes_ask_size_fp": "10.00",
"no_bid_dollars": "0.5600",
"no_ask_dollars": "0.5600",
"last_price_dollars": "0.5600",
"volume_fp": "10.00",
"volume_24h_fp": "10.00",
"result": "yes",
"can_close_early": true,
"open_interest_fp": "10.00",
"notional_value_dollars": "0.5600",
"previous_yes_bid_dollars": "0.5600",
"previous_yes_ask_dollars": "0.5600",
"previous_price_dollars": "0.5600",
"settlement_value_dollars": "0.5600",
"settlement_ts": null,
"settlement_bounds_type": "default",
"settlement_floor_dollars": "0.5600",
"expiration_value": "string",
"occurrence_datetime": null,
"fee_waiver_expiration_time": null,
"early_close_condition": null,
"strike_type": "greater",
"floor_strike": null,
"cap_strike": null,
"functional_strike": null,
"custom_strike": null,
"rules_primary": "string",
"rules_secondary": "string",
"mve_collection_ticker": "string",
"mve_selected_legs": [
{
"event_ticker": "string",
"market_ticker": "string",
"side": "string",
"yes_settlement_value_dollars": "0.5600"
}
],
"primary_participant_key": null,
"price_level_structure": "string",
"price_ranges": [
{
"start": "string",
"end": "string",
"step": "string"
}
],
"is_provisional": true,
"exchange_index": 0
}
],
"cursor": "string"
}