Kalshi
Prediction-market data.
取得 Kalshi 市場
使用文件記載的 status、ticker、event、series 與時間戳篩選條件列出預測市場。此契約包含 max_updated_ts，但未宣告自由文字搜尋參數。市場記錄與分頁請依循回應結構。
定價參考
- 計量方式：以成功請求為固定成本基礎。
- 參考請求預估：USD 0.02。
僅供參考的中繼資料，並非帳戶報價、保證價格或消費上限。資源額度並非 Felo 額度。最終費用依 Felo 計費記錄為準。
- 類型: stringcursor
分頁游標。使用上一次回應傳回的游標值取得下一頁結果。第一頁請留空。
- 類型: stringevent
_ticker 用於篩選的事件 ticker。僅支援單一事件 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 依系列 ticker 篩選
- 類型: string 列舉status
依市場狀態篩選。留空則傳回任意狀態的市場。
值- unopened
- open
- paused
- closed
- settled
- 類型: stringtickers
依特定市場 ticker 篩選。以逗號分隔的市場 ticker 清單。
- 類型: 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 必填對二級市場條款的通俗說明
- 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 多變量事件集合的 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"
}