Kalshi
Prediction-market data.
Ambil Pasar Kalshi
Daftar pasar prediksi menggunakan filter status, ticker, event, series, dan timestamp yang didokumentasikan. Kontrak mencakup max_updated_ts tetapi tidak mendeklarasikan parameter pencarian teks bebas. Ikuti skema respons untuk catatan pasar dan paginasi.
Referensi harga
- Metering: Dasar biaya tetap per permintaan berhasil.
- Estimasi referensi per permintaan: USD 0.02.
Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukanlah kredit Felo. Biaya akhir mengikuti catatan tagihan Felo.
- Tipe: stringcursor
Kursor paginasi. Gunakan nilai kursor yang dikembalikan dari respons sebelumnya untuk mendapatkan halaman hasil berikutnya. Biarkan kosong untuk halaman pertama.
- Tipe: stringevent
_ticker Ticker peristiwa untuk difilter. Hanya satu ticker peristiwa yang didukung.
- Tipe: integer Format: int64limitmin:0maks:1000
Jumlah hasil per halaman. Default-nya 100. Nilai maksimum adalah 1000.
- Tipe: integer Format: int64max
_close _ts Filter item yang ditutup sebelum stempel waktu Unix ini
- Tipe: integer Format: int64max
_created _ts Filter item yang dibuat sebelum stempel waktu Unix ini
- Tipe: integer Format: int64max
_settled _ts Filter item yang diselesaikan sebelum stempel waktu Unix ini
- Tipe: integer Format: int64max
_updated _ts Mengembalikan pasar dengan metadata yang diperbarui pada atau sebelum stempel waktu Unix ini (dalam detik). Hanya melacak perubahan non-perdagangan. Dapat digabungkan dengan min_updated_ts dan mve_filter=exclude. Juga dapat digabungkan dengan series_ticker, yang memerlukan mve_filter=exclude. Tidak kompatibel dengan filter lain.
- Tipe: integer Format: int64min
_close _ts Filter item yang ditutup setelah stempel waktu Unix ini
- Tipe: integer Format: int64min
_created _ts Filter item yang dibuat setelah stempel waktu Unix ini
- Tipe: integer Format: int64min
_settled _ts Filter item yang diselesaikan setelah stempel waktu Unix ini
- Tipe: integer Format: int64min
_updated _ts Mengembalikan pasar yang metadatanya diperbarui setelah stempel waktu Unix ini (dalam detik). Hanya melacak perubahan non-perdagangan. Dapat digabungkan dengan max_updated_ts dan mve_filter=exclude. Juga dapat digabungkan dengan series_ticker, yang memerlukan mve_filter=exclude. Tidak kompatibel dengan filter lain.
- Tipe: string enummve
_filter Filter berdasarkan peristiwa multivariat (combo). 'only' hanya mengembalikan peristiwa multivariat, 'exclude' mengecualikan peristiwa multivariat.
nilai- only
- exclude
- Tipe: stringseries
_ticker Filter berdasarkan ticker seri
- Tipe: string enumstatus
Filter berdasarkan status pasar. Biarkan kosong untuk mengembalikan pasar dengan status apa pun.
nilai- unopened
- open
- paused
- closed
- settled
- Tipe: stringtickers
Filter berdasarkan ticker pasar tertentu. Daftar ticker pasar yang dipisahkan koma untuk diambil.
- Tipe: object · Response24B585A0A861_GetMarketsResponse200
Pasar berhasil diambil
- Tipe: stringcursorwajib
- Tipe: array object[] · Response24B585A0A861_Market[]marketswajib
- canTipe: boolean
_close _early wajib - closeTipe: string Format: date-time
_time wajibthe date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- createdTipe: string Format: date-time
_time wajibthe date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- eventTipe: string
_ticker wajib - expirationTipe: string
_value wajibNilai yang dipertimbangkan untuk penyelesaian
- lastTipe: string · Response24B585A0A861_FixedPointDollars
_price _dollars wajibString dolar AS titik tetap. Sebagian besar field permintaan menerima 2-4 tempat desimal (misalnya "0.56", "0.5600"); respons mengeluarkan hingga 6. Interval kuotasi yang valid untuk pasar tertentu dibatasi oleh struktur tingkat harga pasar tersebut.
- latestTipe: string Format: date-time
_expiration _time wajibWaktu terakhir yang mungkin untuk pasar ini kedaluwarsa
- marketTipe: string enum
_type wajibMengidentifikasi jenis pasar
nilai- binary
- scalar
- noTipe: string · Response24B585A0A861_FixedPointDollars
_ask _dollars wajibString dolar AS titik tetap. Sebagian besar field permintaan menerima 2-4 tempat desimal (misalnya "0.56", "0.5600"); respons mengeluarkan hingga 6. Interval kuotasi yang valid untuk pasar tertentu dibatasi oleh struktur tingkat harga pasar tersebut.
- noTipe: string · Response24B585A0A861_FixedPointDollars
_bid _dollars wajibString dolar AS titik tetap. Sebagian besar field permintaan menerima 2-4 tempat desimal (misalnya "0.56", "0.5600"); respons mengeluarkan hingga 6. Interval kuotasi yang valid untuk pasar tertentu dibatasi oleh struktur tingkat harga pasar tersebut.
- noTipe: string
_sub _title wajibJudul singkat untuk sisi NO pasar ini
- notionalTipe: string · Response24B585A0A861_FixedPointDollars
_value _dollars wajibString dolar AS titik tetap. Sebagian besar field permintaan menerima 2-4 tempat desimal (misalnya "0.56", "0.5600"); respons mengeluarkan hingga 6. Interval kuotasi yang valid untuk pasar tertentu dibatasi oleh struktur tingkat harga pasar tersebut.
- openTipe: string · Response24B585A0A861_FixedPointCount
_interest _fp wajibString jumlah kontrak titik tetap (2 desimal, misalnya "10.00"; disebut "fp" dalam nama field). Permintaan menerima 0-2 tempat desimal (misalnya "10", "10.0", "10.00"); respons selalu mengeluarkan 2 desimal. Nilai kontrak pecahan (misalnya "2.50") didukung; granularitas minimum adalah 0.01 kontrak.
- openTipe: string Format: date-time
_time wajibthe date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- previousTipe: string · Response24B585A0A861_FixedPointDollars
_price _dollars wajibString dolar AS titik tetap. Sebagian besar field permintaan menerima 2-4 tempat desimal (misalnya "0.56", "0.5600"); respons mengeluarkan hingga 6. Interval kuotasi yang valid untuk pasar tertentu dibatasi oleh struktur tingkat harga pasar tersebut.
- previousTipe: string · Response24B585A0A861_FixedPointDollars
_yes _ask _dollars wajibString dolar AS titik tetap. Sebagian besar field permintaan menerima 2-4 tempat desimal (misalnya "0.56", "0.5600"); respons mengeluarkan hingga 6. Interval kuotasi yang valid untuk pasar tertentu dibatasi oleh struktur tingkat harga pasar tersebut.
- previousTipe: string · Response24B585A0A861_FixedPointDollars
_yes _bid _dollars wajibString dolar AS titik tetap. Sebagian besar field permintaan menerima 2-4 tempat desimal (misalnya "0.56", "0.5600"); respons mengeluarkan hingga 6. Interval kuotasi yang valid untuk pasar tertentu dibatasi oleh struktur tingkat harga pasar tersebut.
- priceTipe: string
_level _structure wajibStruktur tingkat harga untuk pasar ini, yang menentukan rentang harga dan ukuran tick
- priceTipe: array object[] · Response24B585A0A861_PriceRange[]
_ranges wajibRentang harga yang valid untuk order di pasar ini
- endTipe: stringwajib
Harga akhir untuk rentang ini dalam dolar
- startTipe: stringwajib
Harga awal untuk rentang ini dalam dolar
- stepTipe: stringwajib
Ukuran langkah/tick harga untuk rentang ini dalam dolar
- resultTipe: string enumwajibnilai
- yes
- no
- scalar
- rulesTipe: string
_primary wajibDeskripsi bahasa sederhana tentang ketentuan pasar yang paling penting
- rulesTipe: string
_secondary wajibDeskripsi bahasa sederhana tentang ketentuan pasar sekunder
- settlementTipe: string enum
_bounds _type wajibBatas penyelesaian mana yang berlaku untuk pasar ini. default berarti pasar tidak memiliki batas penyelesaian
nilai- default
- floor
- settlementTipe: integer
_timer _seconds wajibRentang waktu setelah penetapan hingga pasar diselesaikan
- statusTipe: string enumwajib
Status pasar saat ini dalam siklus hidupnya.
nilai- initialized
- inactive
- active
- closed
- determined
- disputed
- amended
- finalized
- tickerTipe: stringwajib
- updatedTipe: string Format: date-time
_time wajibWaktu pembaruan metadata non-perdagangan terakhir.
- volumeTipe: string · Response24B585A0A861_FixedPointCount
_24h _fp wajibString jumlah kontrak titik tetap (2 desimal, misalnya "10.00"; disebut "fp" dalam nama field). Permintaan menerima 0-2 tempat desimal (misalnya "10", "10.0", "10.00"); respons selalu mengeluarkan 2 desimal. Nilai kontrak pecahan (misalnya "2.50") didukung; granularitas minimum adalah 0.01 kontrak.
- volumeTipe: string · Response24B585A0A861_FixedPointCount
_fp wajibString jumlah kontrak titik tetap (2 desimal, misalnya "10.00"; disebut "fp" dalam nama field). Permintaan menerima 0-2 tempat desimal (misalnya "10", "10.0", "10.00"); respons selalu mengeluarkan 2 desimal. Nilai kontrak pecahan (misalnya "2.50") didukung; granularitas minimum adalah 0.01 kontrak.
- yesTipe: string · Response24B585A0A861_FixedPointDollars
_ask _dollars wajibString dolar AS titik tetap. Sebagian besar field permintaan menerima 2-4 tempat desimal (misalnya "0.56", "0.5600"); respons mengeluarkan hingga 6. Interval kuotasi yang valid untuk pasar tertentu dibatasi oleh struktur tingkat harga pasar tersebut.
- yesTipe: string · Response24B585A0A861_FixedPointCount
_ask _size _fp wajibString jumlah kontrak titik tetap (2 desimal, misalnya "10.00"; disebut "fp" dalam nama field). Permintaan menerima 0-2 tempat desimal (misalnya "10", "10.0", "10.00"); respons selalu mengeluarkan 2 desimal. Nilai kontrak pecahan (misalnya "2.50") didukung; granularitas minimum adalah 0.01 kontrak.
- yesTipe: string · Response24B585A0A861_FixedPointDollars
_bid _dollars wajibString dolar AS titik tetap. Sebagian besar field permintaan menerima 2-4 tempat desimal (misalnya "0.56", "0.5600"); respons mengeluarkan hingga 6. Interval kuotasi yang valid untuk pasar tertentu dibatasi oleh struktur tingkat harga pasar tersebut.
- yesTipe: string · Response24B585A0A861_FixedPointCount
_bid _size _fp wajibString jumlah kontrak titik tetap (2 desimal, misalnya "10.00"; disebut "fp" dalam nama field). Permintaan menerima 0-2 tempat desimal (misalnya "10", "10.0", "10.00"); respons selalu mengeluarkan 2 desimal. Nilai kontrak pecahan (misalnya "2.50") didukung; granularitas minimum adalah 0.01 kontrak.
- yesTipe: string
_sub _title wajibJudul singkat untuk sisi ya dari pasar ini
- capTipe: number | null Format: double
_strike Nilai kedaluwarsa maksimum yang menghasilkan penyelesaian YES
- customTipe: object | null
_strike Nilai kedaluwarsa untuk setiap target yang menghasilkan penyelesaian YES
- earlyTipe: string | null
_close _condition Kondisi agar pasar dapat tutup lebih awal
- exchangeTipe: integer · Response24B585A0A861_ExchangeIndex
_index Pengenal untuk shard bursa.
- expectedTipe: string | null Format: date-time
_expiration _time Waktu saat pasar ini diperkirakan kedaluwarsa
- expirationTipe: string Format: date-time
_time usangthe date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- feeTipe: string | null Format: date-time
_waiver _expiration _time Waktu saat pembebasan biaya pasar ini berakhir
- floorTipe: number | null Format: double
_strike Nilai kedaluwarsa minimum yang menghasilkan penyelesaian YES
- functionalTipe: string | null
_strike Pemetaan dari nilai kedaluwarsa ke nilai penyelesaian
- isTipe: boolean
_provisional Jika true, pasar dapat dihapus setelah penentuan jika tidak ada aktivitas di dalamnya
- mveTipe: string
_collection _ticker Ticker dari koleksi peristiwa multivariat
- mveTipe: array object[] · Response24B585A0A861_MveSelectedLeg[]
_selected _legs - eventTipe: string
_ticker Pengenal unik untuk peristiwa yang dipilih
- marketTipe: string
_ticker Pengenal unik untuk pasar yang dipilih
- sideTipe: string
Sisi pasar yang dipilih
- yesTipe: string · Response24B585A0A861_FixedPointDollars
_settlement _value _dollars String dolar AS titik tetap. Sebagian besar field permintaan menerima 2-4 tempat desimal (misalnya "0.56", "0.5600"); respons mengeluarkan hingga 6. Interval kuotasi yang valid untuk pasar tertentu dibatasi oleh struktur tingkat harga pasar tersebut.
- occurrenceTipe: string | null Format: date-time
_datetime Datetime yang tercatat saat peristiwa yang mendasari terjadi, jika tersedia
- primaryTipe: string | null
_participant _key - settlementTipe: string · Response24B585A0A861_FixedPointDollars
_floor _dollars String dolar AS titik tetap. Sebagian besar field permintaan menerima 2-4 tempat desimal (misalnya "0.56", "0.5600"); respons mengeluarkan hingga 6. Interval kuotasi yang valid untuk pasar tertentu dibatasi oleh struktur tingkat harga pasar tersebut.
- settlementTipe: string | null Format: date-time
_ts Stempel waktu saat pasar diselesaikan. Hanya diisi untuk pasar yang telah diselesaikan
- settlementTipe: string · Response24B585A0A861_FixedPointDollars
_value _dollars String dolar AS titik tetap. Sebagian besar field permintaan menerima 2-4 tempat desimal (misalnya "0.56", "0.5600"); respons mengeluarkan hingga 6. Interval kuotasi yang valid untuk pasar tertentu dibatasi oleh struktur tingkat harga pasar tersebut.
- strikeTipe: string enum
_type Jenis strike menentukan bagaimana strike pasar didefinisikan dan dievaluasi
nilai- greater
- greater
_or _equal - less
- less
_or _equal - between
- functional
- custom
- structured
- subtitleTipe: stringusang
- titleTipe: stringusang
application/json - 400
Permintaan tidak dapat diproses. Periksa parameter permintaan.
- 401
Kunci API Felo yang valid diperlukan.
- 402
Permintaan tidak dapat dilanjutkan karena persyaratan penagihan belum terpenuhi.
- 403
Akun tidak diizinkan melakukan operasi ini.
- 429
Batas permintaan atau batas pengeluaran telah tercapai.
- 502
Layanan tidak dapat menyelesaikan permintaan.
- 503
API atau layanan penagihan untuk sementara tidak tersedia.
- 504
Layanan kehabisan waktu saat memproses permintaan.
- default
Respons error; respons passthrough upstream dapat menggunakan format penyedia
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"
}