# Dapatkan Pasaran Kalshi

**API:** Data API

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

**Tags:** Kalshi

Senaraikan pasaran ramalan menggunakan penapis status, ticker, event, series dan timestamp yang didokumenkan. Kontrak merangkumi max_updated_ts tetapi tidak mengisytiharkan parameter carian teks bebas. Ikuti skema respons untuk rekod pasaran dan penomboran halaman.

### Rujukan harga

- Pemeteran: Asas kos tetap bagi setiap permintaan berjaya.
- Anggaran rujukan setiap permintaan: USD 0.02.

Metadata rujukan sahaja, bukan sebut harga akaun, harga terjamin atau had perbelanjaan. Kredit sumber bukan kredit Felo. Caj akhir mengikut rekod pengebilan 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 | Kursor penomboran. Gunakan nilai kursor yang dipulangkan daripada respons sebelumnya untuk mendapatkan halaman hasil seterusnya. Biarkan kosong untuk halaman pertama. |
| `event_ticker` | query | no | string | Ticker acara untuk ditapis. Hanya satu ticker acara disokong. |
| `limit` | query | no | integer, (int64), default: 100 | Bilangan hasil setiap halaman. Lalai kepada 100. Nilai maksimum ialah 1000. |
| `max_close_ts` | query | no | integer, (int64) | Tapis item yang ditutup sebelum cap masa Unix ini |
| `max_created_ts` | query | no | integer, (int64) | Tapis item yang dicipta sebelum cap masa Unix ini |
| `max_settled_ts` | query | no | integer, (int64) | Tapis item yang diselesaikan sebelum cap masa Unix ini |
| `max_updated_ts` | query | no | integer, (int64) | Memulangkan pasaran dengan metadata yang dikemas kini pada atau sebelum cap masa Unix ini (dalam saat). Hanya menjejak perubahan bukan dagangan. Boleh digabungkan dengan min_updated_ts dan mve_filter=exclude. Juga boleh digabungkan dengan series_ticker, yang memerlukan mve_filter=exclude. Tidak serasi dengan penapis lain. |
| `min_close_ts` | query | no | integer, (int64) | Tapis item yang ditutup selepas cap masa Unix ini |
| `min_created_ts` | query | no | integer, (int64) | Tapis item yang dicipta selepas cap masa Unix ini |
| `min_settled_ts` | query | no | integer, (int64) | Tapis item yang diselesaikan selepas cap masa Unix ini |
| `min_updated_ts` | query | no | integer, (int64) | Memulangkan pasaran yang metadatanya dikemas kini selepas cap masa Unix ini (dalam saat). Hanya menjejak perubahan bukan dagangan. Boleh digabungkan dengan max_updated_ts dan mve_filter=exclude. Juga boleh digabungkan dengan series_ticker, yang memerlukan mve_filter=exclude. Tidak serasi dengan penapis lain. |
| `mve_filter` | query | no | string, enum: "only", "exclude" | Tapis mengikut acara multivariat (kombo). 'only' hanya memulangkan acara multivariat, 'exclude' mengecualikan acara multivariat. |
| `series_ticker` | query | no | string | Tapis mengikut ticker siri |
| `status` | query | no | string, enum: "unopened", "open", "paused", "closed", "settled" | Tapis mengikut status pasaran. Biarkan kosong untuk memulangkan pasaran dengan mana-mana status. |
| `tickers` | query | no | string | Tapis mengikut ticker pasaran tertentu. Senarai ticker pasaran yang dipisahkan koma untuk diambil. |

## Responses

### 200 — Pasaran berjaya diambil

Headers:
- `X-Request-Id` (string) — Pengecam permintaan untuk disertakan semasa menghubungi sokongan Felo.

**application/json**

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

### 400 — Permintaan tidak dapat diproses. Semak parameter permintaan.

### 401 — Kunci API Felo yang sah diperlukan.

### 402 — Permintaan tidak dapat diteruskan kerana keperluan pengebilan tidak dipenuhi.

### 403 — Akaun tidak dibenarkan melakukan operasi ini.

### 429 — Had permintaan atau had perbelanjaan telah dicapai.

### 502 — Perkhidmatan tidak dapat menyelesaikan permintaan.

### 503 — API atau perkhidmatan pengebilan tidak tersedia buat sementara waktu.

### 504 — Perkhidmatan tamat masa semasa memproses permintaan.

### default — Respons ralat; respons passthrough huluan mungkin menggunakan format penyedia

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response24B585A0A861_ExchangeIndex

`#/components/schemas/Response24B585A0A861_ExchangeIndex`

```json
{
  "type": "integer",
  "description": "Pengecam untuk serpihan bursa.",
  "example": 0
}
```

### Response24B585A0A861_FixedPointCount

`#/components/schemas/Response24B585A0A861_FixedPointCount`

```json
{
  "type": "string",
  "description": "Rentetan bilangan kontrak titik tetap (2 perpuluhan, contohnya \"10.00\"; dirujuk sebagai \"fp\" dalam nama medan). Permintaan menerima 0-2 tempat perpuluhan (contohnya \"10\", \"10.0\", \"10.00\"); respons sentiasa mengeluarkan 2 perpuluhan. Nilai kontrak pecahan (contohnya \"2.50\") disokong; granulariti minimum ialah 0.01 kontrak.",
  "example": "10.00"
}
```

### Response24B585A0A861_FixedPointDollars

`#/components/schemas/Response24B585A0A861_FixedPointDollars`

```json
{
  "type": "string",
  "description": "Rentetan dolar AS titik tetap. Kebanyakan medan permintaan menerima 2-4 tempat perpuluhan (contohnya \"0.56\", \"0.5600\"); respons mengeluarkan sehingga 6. Selang sebut harga yang sah untuk pasaran tertentu dihadkan oleh struktur aras harga pasaran tersebut.",
  "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": "Mengenal pasti jenis pasaran"
    },
    "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": "Tajuk ringkas untuk sisi ya pasaran ini"
    },
    "no_sub_title": {
      "type": "string",
      "description": "Tajuk ringkas untuk bahagian NO pasaran ini"
    },
    "created_time": {
      "type": "string",
      "format": "date-time"
    },
    "updated_time": {
      "type": "string",
      "format": "date-time",
      "description": "Masa kemas kini metadata bukan dagangan terakhir."
    },
    "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": "Masa apabila pasaran ini dijangka tamat tempoh"
    },
    "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": "Masa terakhir yang mungkin untuk pasaran ini tamat tempoh"
    },
    "settlement_timer_seconds": {
      "type": "integer",
      "description": "Tempoh masa selepas penetapan untuk pasaran diselesaikan"
    },
    "status": {
      "type": "string",
      "enum": [
        "initialized",
        "inactive",
        "active",
        "closed",
        "determined",
        "disputed",
        "amended",
        "finalized"
      ],
      "description": "Status semasa pasaran dalam kitaran hayatnya."
    },
    "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": "Cap masa apabila pasaran diselesaikan. Hanya diisi untuk pasaran yang telah diselesaikan"
    },
    "settlement_bounds_type": {
      "type": "string",
      "enum": [
        "default",
        "floor"
      ],
      "description": "Had penyelesaian mana yang terpakai pada pasaran ini. default bermaksud pasaran tidak mempunyai had penyelesaian"
    },
    "settlement_floor_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "expiration_value": {
      "type": "string",
      "description": "Nilai yang dipertimbangkan untuk penyelesaian"
    },
    "occurrence_datetime": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "Tarikh masa yang direkodkan apabila peristiwa asas berlaku, jika tersedia"
    },
    "fee_waiver_expiration_time": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "x-omitempty": true,
      "description": "Masa apabila pengecualian fi pasaran ini tamat tempoh"
    },
    "early_close_condition": {
      "type": [
        "string",
        "null"
      ],
      "x-omitempty": true,
      "description": "Syarat di mana pasaran boleh tutup lebih awal",
      "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": "Jenis strike menentukan cara strike pasaran ditakrifkan dan dinilai",
      "x-go-type-skip-optional-pointer": true
    },
    "floor_strike": {
      "type": [
        "number",
        "null"
      ],
      "format": "double",
      "x-omitempty": true,
      "description": "Nilai tamat tempoh minimum yang membawa kepada penyelesaian YES"
    },
    "cap_strike": {
      "type": [
        "number",
        "null"
      ],
      "format": "double",
      "x-omitempty": true,
      "description": "Nilai tamat tempoh maksimum yang membawa kepada penyelesaian YES"
    },
    "functional_strike": {
      "type": [
        "string",
        "null"
      ],
      "x-omitempty": true,
      "description": "Pemetaan daripada nilai tamat tempoh kepada nilai penyelesaian"
    },
    "custom_strike": {
      "type": [
        "object",
        "null"
      ],
      "x-omitempty": true,
      "description": "Nilai tamat tempoh untuk setiap sasaran yang membawa kepada penyelesaian YES"
    },
    "rules_primary": {
      "type": "string",
      "description": "Penerangan bahasa mudah tentang terma pasaran terpenting"
    },
    "rules_secondary": {
      "type": "string",
      "description": "Penerangan bahasa mudah tentang terma pasaran sekunder"
    },
    "mve_collection_ticker": {
      "type": "string",
      "x-omitempty": true,
      "description": "Ticker koleksi acara multivariat",
      "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": "Struktur aras harga untuk pasaran ini, mentakrifkan julat harga dan saiz tick"
    },
    "price_ranges": {
      "type": "array",
      "description": "Julat harga yang sah untuk pesanan pada pasaran ini",
      "items": {
        "$ref": "#/components/schemas/Response24B585A0A861_PriceRange"
      }
    },
    "is_provisional": {
      "type": "boolean",
      "x-omitempty": true,
      "description": "Jika true, pasaran boleh dialihkan selepas penentuan jika tiada aktiviti padanya",
      "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": "Pengecam unik untuk acara yang dipilih",
      "x-go-type-skip-optional-pointer": true
    },
    "market_ticker": {
      "type": "string",
      "description": "Pengecam unik untuk pasaran yang dipilih",
      "x-go-type-skip-optional-pointer": true
    },
    "side": {
      "type": "string",
      "description": "Sisi pasaran yang dipilih",
      "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": "Harga mula untuk julat ini dalam dolar"
    },
    "end": {
      "type": "string",
      "description": "Harga tamat untuk julat ini dalam dolar"
    },
    "step": {
      "type": "string",
      "description": "Saiz langkah/tick harga untuk julat ini dalam dolar"
    }
  }
}
```
