# 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 | 1 ページあたりの結果数。既定は 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": "この範囲の価格ステップ/ティックサイズ（米ドル）" } } } ```