# 取得 Kalshi 市場

**API:** Data API

**Endpoint:** `GET /v1/beta/kalshi/markets`

**Tags:** Kalshi

使用文件記載的 status、ticker、event、series 與時間戳篩選條件列出預測市場。此契約包含 max_updated_ts，但未宣告自由文字搜尋參數。市場記錄與分頁請依循回應結構。

### 定價參考

- 計量方式：以成功請求為固定成本基礎。
- 參考請求預估：USD 0.02。

僅供參考的中繼資料，並非帳戶報價、保證價格或消費上限。資源額度並非 Felo 額度。最終費用依 Felo 計費記錄為準。

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `cursor` | query | no | string | 分頁游標。使用上一次回應傳回的游標值取得下一頁結果。第一頁請留空。 |
| `event_ticker` | query | no | string | 用於篩選的事件 ticker。僅支援單一事件 ticker。 |
| `limit` | query | no | integer, (int64), default: 100 | 每頁結果數。預設為 100，最大值為 1000。 |
| `max_close_ts` | query | no | integer, (int64) | 篩選在此 Unix 時間戳之前關閉的項目 |
| `max_created_ts` | query | no | integer, (int64) | 篩選在此 Unix 時間戳之前建立的項目 |
| `max_settled_ts` | query | no | integer, (int64) | 篩選在此 Unix 時間戳之前結算的項目 |
| `max_updated_ts` | query | no | integer, (int64) | 傳回中繼資料更新時間早於或等於此 Unix 時間戳（秒）的市場。僅追蹤非交易類變更。可與 min_updated_ts 及 mve_filter=exclude 合併使用。也可與 series_ticker 合併，但此時要求 mve_filter=exclude。與其他篩選條件不相容。 |
| `min_close_ts` | query | no | integer, (int64) | 篩選在此 Unix 時間戳之後關閉的項目 |
| `min_created_ts` | query | no | integer, (int64) | 篩選在此 Unix 時間戳之後建立的項目 |
| `min_settled_ts` | query | no | integer, (int64) | 篩選在此 Unix 時間戳之後結算的項目 |
| `min_updated_ts` | query | no | integer, (int64) | 傳回中繼資料更新時間晚於此 Unix 時間戳（秒）的市場。僅追蹤非交易類變更。可與 max_updated_ts 及 mve_filter=exclude 合併使用。也可與 series_ticker 合併，但此時要求 mve_filter=exclude。與其他篩選條件不相容。 |
| `mve_filter` | query | no | string, enum: "only", "exclude" | 依多變量事件（組合）篩選。'only' 僅傳回多變量事件，'exclude' 排除多變量事件。 |
| `series_ticker` | query | no | string | 依系列 ticker 篩選 |
| `status` | query | no | string, enum: "unopened", "open", "paused", "closed", "settled" | 依市場狀態篩選。留空則傳回任意狀態的市場。 |
| `tickers` | query | no | string | 依特定市場 ticker 篩選。以逗號分隔的市場 ticker 清單。 |

## Responses

### 200 — 市場取得成功

Headers:
- `X-Request-Id` (string) — 聯絡 Felo 支援時需提供的請求識別碼。

**application/json**

Schema: `Response24B585A0A861_GetMarketsResponse` (`#/components/schemas/Response24B585A0A861_GetMarketsResponse`)

### 400 — 無法處理該要求。請檢查請求參數。

### 401 — 需要有效的 Felo API 金鑰。

### 402 — 由於未符合計費要求，要求無法繼續。

### 403 — 該帳戶無權執行此操作。

### 429 — 已達到要求或支出上限。

### 502 — 服務無法完成該要求。

### 503 — API 或計費服務暫時無法使用。

### 504 — 服務在處理要求時逾時。

### default — 錯誤回應；上游透傳回應可能採用供應商格式

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response24B585A0A861_ExchangeIndex

`#/components/schemas/Response24B585A0A861_ExchangeIndex`

```json
{
  "type": "integer",
  "description": "交易所分片的識別碼。",
  "example": 0
}
```

### Response24B585A0A861_FixedPointCount

`#/components/schemas/Response24B585A0A861_FixedPointCount`

```json
{
  "type": "string",
  "description": "定點合約數量字串（2 位小數，例如 \"10.00\"；在欄位名稱中稱為 \"fp\"）。請求接受 0–2 位小數（例如 \"10\"、\"10.0\"、\"10.00\"）；回應一律輸出 2 位小數。支援小數合約值（例如 \"2.50\"）；最小粒度為 0.01 份合約。",
  "example": "10.00"
}
```

### Response24B585A0A861_FixedPointDollars

`#/components/schemas/Response24B585A0A861_FixedPointDollars`

```json
{
  "type": "string",
  "description": "定點美元字串。多數請求欄位接受 2–4 位小數（例如 \"0.56\"、\"0.5600\"）；回應最多輸出 6 位小數。特定市場的有效報價間隔受該市場的價格級距結構限制。",
  "example": "0.5600"
}
```

### Response24B585A0A861_GetMarketsResponse

`#/components/schemas/Response24B585A0A861_GetMarketsResponse`

```json
{
  "type": "object",
  "required": [
    "markets",
    "cursor"
  ],
  "properties": {
    "markets": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Response24B585A0A861_Market"
      }
    },
    "cursor": {
      "type": "string"
    }
  }
}
```

### Response24B585A0A861_Market

`#/components/schemas/Response24B585A0A861_Market`

```json
{
  "type": "object",
  "required": [
    "ticker",
    "event_ticker",
    "market_type",
    "yes_sub_title",
    "no_sub_title",
    "created_time",
    "updated_time",
    "open_time",
    "close_time",
    "latest_expiration_time",
    "settlement_timer_seconds",
    "status",
    "notional_value_dollars",
    "yes_bid_dollars",
    "yes_ask_dollars",
    "no_bid_dollars",
    "no_ask_dollars",
    "yes_bid_size_fp",
    "yes_ask_size_fp",
    "last_price_dollars",
    "previous_yes_bid_dollars",
    "previous_yes_ask_dollars",
    "previous_price_dollars",
    "volume_fp",
    "volume_24h_fp",
    "open_interest_fp",
    "result",
    "can_close_early",
    "expiration_value",
    "rules_primary",
    "rules_secondary",
    "price_level_structure",
    "price_ranges",
    "settlement_bounds_type"
  ],
  "properties": {
    "ticker": {
      "type": "string"
    },
    "event_ticker": {
      "type": "string"
    },
    "market_type": {
      "type": "string",
      "enum": [
        "binary",
        "scalar"
      ],
      "description": "識別市場類型"
    },
    "title": {
      "type": "string",
      "deprecated": true,
      "x-go-type-skip-optional-pointer": true
    },
    "subtitle": {
      "type": "string",
      "deprecated": true,
      "x-go-type-skip-optional-pointer": true
    },
    "yes_sub_title": {
      "type": "string",
      "description": "該市場 YES 一側的簡稱"
    },
    "no_sub_title": {
      "type": "string",
      "description": "該市場 NO 一側的簡稱"
    },
    "created_time": {
      "type": "string",
      "format": "date-time"
    },
    "updated_time": {
      "type": "string",
      "format": "date-time",
      "description": "最近一次非交易類中繼資料更新的時間。"
    },
    "open_time": {
      "type": "string",
      "format": "date-time"
    },
    "close_time": {
      "type": "string",
      "format": "date-time"
    },
    "expected_expiration_time": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "x-omitempty": true,
      "description": "該市場的預期到期時間"
    },
    "expiration_time": {
      "type": "string",
      "format": "date-time",
      "deprecated": true,
      "x-go-type-skip-optional-pointer": true
    },
    "latest_expiration_time": {
      "type": "string",
      "format": "date-time",
      "description": "該市場可能的最晚到期時間"
    },
    "settlement_timer_seconds": {
      "type": "integer",
      "description": "市場確定後到結算之間的時間"
    },
    "status": {
      "type": "string",
      "enum": [
        "initialized",
        "inactive",
        "active",
        "closed",
        "determined",
        "disputed",
        "amended",
        "finalized"
      ],
      "description": "市場在生命週期中的目前狀態。"
    },
    "yes_bid_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "yes_bid_size_fp": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointCount"
    },
    "yes_ask_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "yes_ask_size_fp": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointCount"
    },
    "no_bid_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "no_ask_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "last_price_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "volume_fp": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointCount"
    },
    "volume_24h_fp": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointCount"
    },
    "result": {
      "type": "string",
      "enum": [
        "yes",
        "no",
        "scalar",
        ""
      ]
    },
    "can_close_early": {
      "type": "boolean"
    },
    "open_interest_fp": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointCount"
    },
    "notional_value_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "previous_yes_bid_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "previous_yes_ask_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "previous_price_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "settlement_value_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "settlement_ts": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "x-omitempty": true,
      "description": "市場結算的時間戳記。僅對已結算的市場填入"
    },
    "settlement_bounds_type": {
      "type": "string",
      "enum": [
        "default",
        "floor"
      ],
      "description": "適用於該市場的結算邊界。default 表示該市場沒有結算邊界"
    },
    "settlement_floor_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "expiration_value": {
      "type": "string",
      "description": "結算時考量的值"
    },
    "occurrence_datetime": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "底層事件發生時的記錄日期時間（若有）"
    },
    "fee_waiver_expiration_time": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "x-omitempty": true,
      "description": "該市場手續費減免的到期時間"
    },
    "early_close_condition": {
      "type": [
        "string",
        "null"
      ],
      "x-omitempty": true,
      "description": "市場可以提前關閉的條件",
      "x-go-type-skip-optional-pointer": true
    },
    "strike_type": {
      "type": "string",
      "enum": [
        "greater",
        "greater_or_equal",
        "less",
        "less_or_equal",
        "between",
        "functional",
        "custom",
        "structured"
      ],
      "x-omitempty": true,
      "description": "履約價類型定義市場履約價的設定與評估方式",
      "x-go-type-skip-optional-pointer": true
    },
    "floor_strike": {
      "type": [
        "number",
        "null"
      ],
      "format": "double",
      "x-omitempty": true,
      "description": "導致 YES 結算的最小到期值"
    },
    "cap_strike": {
      "type": [
        "number",
        "null"
      ],
      "format": "double",
      "x-omitempty": true,
      "description": "導致 YES 結算的最大到期值"
    },
    "functional_strike": {
      "type": [
        "string",
        "null"
      ],
      "x-omitempty": true,
      "description": "從到期值到結算值的對應"
    },
    "custom_strike": {
      "type": [
        "object",
        "null"
      ],
      "x-omitempty": true,
      "description": "每個目標導致 YES 結算的到期值"
    },
    "rules_primary": {
      "type": "string",
      "description": "對最重要的市場條款的通俗說明"
    },
    "rules_secondary": {
      "type": "string",
      "description": "對二級市場條款的通俗說明"
    },
    "mve_collection_ticker": {
      "type": "string",
      "x-omitempty": true,
      "description": "多變量事件集合的 ticker",
      "x-go-type-skip-optional-pointer": true
    },
    "mve_selected_legs": {
      "type": "array",
      "x-omitempty": true,
      "items": {
        "$ref": "#/components/schemas/Response24B585A0A861_MveSelectedLeg"
      },
      "x-go-type-skip-optional-pointer": true
    },
    "primary_participant_key": {
      "type": [
        "string",
        "null"
      ],
      "x-omitempty": true
    },
    "price_level_structure": {
      "type": "string",
      "description": "該市場的價格級距結構，定義價格區間與最小跳動單位"
    },
    "price_ranges": {
      "type": "array",
      "description": "該市場訂單的有效價格區間",
      "items": {
        "$ref": "#/components/schemas/Response24B585A0A861_PriceRange"
      }
    },
    "is_provisional": {
      "type": "boolean",
      "x-omitempty": true,
      "description": "為 true 時，市場在判定後若沒有任何活動，可能會被移除",
      "x-go-type-skip-optional-pointer": true
    },
    "exchange_index": {
      "allOf": [
        {
          "$ref": "#/components/schemas/Response24B585A0A861_ExchangeIndex"
        }
      ],
      "x-go-type-skip-optional-pointer": true,
      "x-omitempty": false
    }
  }
}
```

### Response24B585A0A861_MveSelectedLeg

`#/components/schemas/Response24B585A0A861_MveSelectedLeg`

```json
{
  "type": "object",
  "properties": {
    "event_ticker": {
      "type": "string",
      "description": "所選事件的唯一識別碼",
      "x-go-type-skip-optional-pointer": true
    },
    "market_ticker": {
      "type": "string",
      "description": "所選市場的唯一識別碼",
      "x-go-type-skip-optional-pointer": true
    },
    "side": {
      "type": "string",
      "description": "所選市場的一側",
      "x-go-type-skip-optional-pointer": true
    },
    "yes_settlement_value_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    }
  }
}
```

### Response24B585A0A861_PriceRange

`#/components/schemas/Response24B585A0A861_PriceRange`

```json
{
  "type": "object",
  "required": [
    "start",
    "end",
    "step"
  ],
  "properties": {
    "start": {
      "type": "string",
      "description": "此價格區間的起始價格（美元）"
    },
    "end": {
      "type": "string",
      "description": "此價格區間的結束價格（美元）"
    },
    "step": {
      "type": "string",
      "description": "此價格區間的價格級距/最小跳動單位（美元）"
    }
  }
}
```