Kalshi
Prediction-market data.
Získat trhy Kalshi
Vypíše predikční trhy s použitím dokumentovaných filtrů status, ticker, event, series a timestamp. Kontrakt zahrnuje max_updated_ts, ale nedeklaruje parametr fulltextového vyhledávání. Strukturu záznamů trhů a stránkování určuje schéma odpovědi.
Cenová reference
- Měření: pevná nákladová základna za úspěšný požadavek.
- Referenční odhad požadavku: USD 0.02.
Pouze referenční metadata, nikoli nabídka pro účet, garantovaná cena či limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.
- Typ: stringcursor
Kurzor stránkování. Pro získání další stránky výsledků použijte hodnotu kurzoru vrácenou v předchozí odpovědi. Pro první stránku ponechte prázdné.
- Typ: stringevent
_ticker Ticker události pro filtrování. Podporován je pouze jeden ticker události.
- Typ: integer Formát: int64limitmin:0max:1000
Počet výsledků na stránku. Výchozí hodnota je 100. Maximální hodnota je 1000.
- Typ: integer Formát: int64max
_close _ts Filtrujte položky, které se uzavřou před tímto unixovým časovým razítkem
- Typ: integer Formát: int64max
_created _ts Filtrujte položky vytvořené před tímto unixovým časovým razítkem
- Typ: integer Formát: int64max
_settled _ts Filtrujte položky vypořádané před tímto unixovým časovým razítkem
- Typ: integer Formát: int64max
_updated _ts Vrací trhy, jejichž metadata byla aktualizována v tomto unixovém časovém razítku (v sekundách) nebo dříve. Sleduje pouze změny nesouvisející s obchodováním. Lze kombinovat s min_updated_ts a mve_filter=exclude. Lze kombinovat také se series_ticker, což vyžaduje mve_filter=exclude. Nekompatibilní s ostatními filtry.
- Typ: integer Formát: int64min
_close _ts Filtrujte položky, které se uzavřou po tomto unixovém časovém razítku
- Typ: integer Formát: int64min
_created _ts Filtrujte položky vytvořené po tomto unixovém časovém razítku
- Typ: integer Formát: int64min
_settled _ts Filtrujte položky vypořádané po tomto unixovém časovém razítku
- Typ: integer Formát: int64min
_updated _ts Vrací trhy, jejichž metadata byla aktualizována později než toto unixové časové razítko (v sekundách). Sleduje pouze změny nesouvisející s obchodováním. Lze kombinovat s max_updated_ts a mve_filter=exclude. Lze kombinovat také se series_ticker, což vyžaduje mve_filter=exclude. Nekompatibilní s ostatními filtry.
- Typ: string enummve
_filter Filtrujte podle multivariačních událostí (kombinací). 'only' vrací pouze multivariační události, 'exclude' je vylučuje.
hodnoty- only
- exclude
- Typ: stringseries
_ticker Filtrujte podle tickeru série
- Typ: string enumstatus
Filtrujte podle stavu trhu. Ponechte prázdné pro vrácení trhů s jakýmkoli stavem.
hodnoty- unopened
- open
- paused
- closed
- settled
- Typ: stringtickers
Filtrujte podle konkrétních tickerů trhů. Čárkami oddělený seznam tickerů trhů, které se mají načíst.
- Typ: object · Response24B585A0A861_GetMarketsResponse200
Trhy úspěšně načteny
- Typ: stringcursorpovinné
- Typ: array object[] · Response24B585A0A861_Market[]marketspovinné
- canTyp: boolean
_close _early povinné - closeTyp: string Formát: date-time
_time povinnéthe date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- createdTyp: string Formát: date-time
_time povinnéthe date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- eventTyp: string
_ticker povinné - expirationTyp: string
_value povinnéHodnota, která byla zvážena pro vypořádání
- lastTyp: string · Response24B585A0A861_FixedPointDollars
_price _dollars povinnéŘetězec částky v amerických dolarech s pevnou řádovou čárkou. Většina polí požadavku přijímá 2-4 desetinná místa (např. "0.56", "0.5600"); odpovědi vracejí až 6 desetinných míst. Platné intervaly kotací pro daný trh jsou omezeny strukturou cenových hladin tohoto trhu.
- latestTyp: string Formát: date-time
_expiration _time povinnéNejzazší možný čas, kdy tento trh může vypršet
- marketTyp: string enum
_type povinnéUrčuje typ trhu
hodnoty- binary
- scalar
- noTyp: string · Response24B585A0A861_FixedPointDollars
_ask _dollars povinnéŘetězec částky v amerických dolarech s pevnou řádovou čárkou. Většina polí požadavku přijímá 2-4 desetinná místa (např. "0.56", "0.5600"); odpovědi vracejí až 6 desetinných míst. Platné intervaly kotací pro daný trh jsou omezeny strukturou cenových hladin tohoto trhu.
- noTyp: string · Response24B585A0A861_FixedPointDollars
_bid _dollars povinnéŘetězec částky v amerických dolarech s pevnou řádovou čárkou. Většina polí požadavku přijímá 2-4 desetinná místa (např. "0.56", "0.5600"); odpovědi vracejí až 6 desetinných míst. Platné intervaly kotací pro daný trh jsou omezeny strukturou cenových hladin tohoto trhu.
- noTyp: string
_sub _title povinnéZkrácený název nohy no tohoto trhu
- notionalTyp: string · Response24B585A0A861_FixedPointDollars
_value _dollars povinnéŘetězec částky v amerických dolarech s pevnou řádovou čárkou. Většina polí požadavku přijímá 2-4 desetinná místa (např. "0.56", "0.5600"); odpovědi vracejí až 6 desetinných míst. Platné intervaly kotací pro daný trh jsou omezeny strukturou cenových hladin tohoto trhu.
- openTyp: string · Response24B585A0A861_FixedPointCount
_interest _fp povinnéŘetězec počtu kontraktů s pevnou řádovou čárkou (2 desetinná místa, např. "10.00"; v názvech polí označovaný jako "fp"). Požadavky přijímají 0-2 desetinná místa (např. "10", "10.0", "10.00"); odpovědi vždy vracejí 2 desetinná místa. Zlomkové hodnoty kontraktů (např. "2.50") jsou podporovány; minimální granularita je 0,01 kontraktu.
- openTyp: string Formát: date-time
_time povinnéthe date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- previousTyp: string · Response24B585A0A861_FixedPointDollars
_price _dollars povinnéŘetězec částky v amerických dolarech s pevnou řádovou čárkou. Většina polí požadavku přijímá 2-4 desetinná místa (např. "0.56", "0.5600"); odpovědi vracejí až 6 desetinných míst. Platné intervaly kotací pro daný trh jsou omezeny strukturou cenových hladin tohoto trhu.
- previousTyp: string · Response24B585A0A861_FixedPointDollars
_yes _ask _dollars povinnéŘetězec částky v amerických dolarech s pevnou řádovou čárkou. Většina polí požadavku přijímá 2-4 desetinná místa (např. "0.56", "0.5600"); odpovědi vracejí až 6 desetinných míst. Platné intervaly kotací pro daný trh jsou omezeny strukturou cenových hladin tohoto trhu.
- previousTyp: string · Response24B585A0A861_FixedPointDollars
_yes _bid _dollars povinnéŘetězec částky v amerických dolarech s pevnou řádovou čárkou. Většina polí požadavku přijímá 2-4 desetinná místa (např. "0.56", "0.5600"); odpovědi vracejí až 6 desetinných míst. Platné intervaly kotací pro daný trh jsou omezeny strukturou cenových hladin tohoto trhu.
- priceTyp: string
_level _structure povinnéStruktura cenových hladin tohoto trhu, která definuje cenová rozpětí a velikosti cenových kroků
- priceTyp: array object[] · Response24B585A0A861_PriceRange[]
_ranges povinnéPlatná cenová rozpětí pro objednávky na tomto trhu
- endTyp: stringpovinné
Koncová cena tohoto rozsahu v dolarech
- startTyp: stringpovinné
Počáteční cena tohoto rozsahu v dolarech
- stepTyp: stringpovinné
Krok ceny / velikost ticku pro tento rozsah v dolarech
- resultTyp: string enumpovinnéhodnoty
- yes
- no
- scalar
- rulesTyp: string
_primary povinnéPopis nejdůležitějších tržních podmínek srozumitelným jazykem
- rulesTyp: string
_secondary povinnéPopis podmínek sekundárního trhu srozumitelným jazykem
- settlementTyp: string enum
_bounds _type povinnéKterá omezení vypořádání se na tento trh vztahují. default znamená, že trh nemá omezení vypořádání
hodnoty- default
- floor
- settlementTyp: integer
_timer _seconds povinnéDoba od určení, za kterou se trh vypořádá
- statusTyp: string enumpovinné
Aktuální stav trhu v jeho životním cyklu.
hodnoty- initialized
- inactive
- active
- closed
- determined
- disputed
- amended
- finalized
- tickerTyp: stringpovinné
- updatedTyp: string Formát: date-time
_time povinnéČas poslední aktualizace metadat nesouvisející s obchodováním.
- volumeTyp: string · Response24B585A0A861_FixedPointCount
_24h _fp povinnéŘetězec počtu kontraktů s pevnou řádovou čárkou (2 desetinná místa, např. "10.00"; v názvech polí označovaný jako "fp"). Požadavky přijímají 0-2 desetinná místa (např. "10", "10.0", "10.00"); odpovědi vždy vracejí 2 desetinná místa. Zlomkové hodnoty kontraktů (např. "2.50") jsou podporovány; minimální granularita je 0,01 kontraktu.
- volumeTyp: string · Response24B585A0A861_FixedPointCount
_fp povinnéŘetězec počtu kontraktů s pevnou řádovou čárkou (2 desetinná místa, např. "10.00"; v názvech polí označovaný jako "fp"). Požadavky přijímají 0-2 desetinná místa (např. "10", "10.0", "10.00"); odpovědi vždy vracejí 2 desetinná místa. Zlomkové hodnoty kontraktů (např. "2.50") jsou podporovány; minimální granularita je 0,01 kontraktu.
- yesTyp: string · Response24B585A0A861_FixedPointDollars
_ask _dollars povinnéŘetězec částky v amerických dolarech s pevnou řádovou čárkou. Většina polí požadavku přijímá 2-4 desetinná místa (např. "0.56", "0.5600"); odpovědi vracejí až 6 desetinných míst. Platné intervaly kotací pro daný trh jsou omezeny strukturou cenových hladin tohoto trhu.
- yesTyp: string · Response24B585A0A861_FixedPointCount
_ask _size _fp povinnéŘetězec počtu kontraktů s pevnou řádovou čárkou (2 desetinná místa, např. "10.00"; v názvech polí označovaný jako "fp"). Požadavky přijímají 0-2 desetinná místa (např. "10", "10.0", "10.00"); odpovědi vždy vracejí 2 desetinná místa. Zlomkové hodnoty kontraktů (např. "2.50") jsou podporovány; minimální granularita je 0,01 kontraktu.
- yesTyp: string · Response24B585A0A861_FixedPointDollars
_bid _dollars povinnéŘetězec částky v amerických dolarech s pevnou řádovou čárkou. Většina polí požadavku přijímá 2-4 desetinná místa (např. "0.56", "0.5600"); odpovědi vracejí až 6 desetinných míst. Platné intervaly kotací pro daný trh jsou omezeny strukturou cenových hladin tohoto trhu.
- yesTyp: string · Response24B585A0A861_FixedPointCount
_bid _size _fp povinnéŘetězec počtu kontraktů s pevnou řádovou čárkou (2 desetinná místa, např. "10.00"; v názvech polí označovaný jako "fp"). Požadavky přijímají 0-2 desetinná místa (např. "10", "10.0", "10.00"); odpovědi vždy vracejí 2 desetinná místa. Zlomkové hodnoty kontraktů (např. "2.50") jsou podporovány; minimální granularita je 0,01 kontraktu.
- yesTyp: string
_sub _title povinnéZkrácený název strany „ano” tohoto trhu
- capTyp: number | null Formát: double
_strike Maximální hodnota expirace, která vede k vypořádání YES
- customTyp: object | null
_strike Hodnota expirace pro každý cíl, která vede k vypořádání YES
- earlyTyp: string | null
_close _condition Podmínka, za níž se trh může uzavřít dříve
- exchangeTyp: integer · Response24B585A0A861_ExchangeIndex
_index Identifikátor burzovního shardu.
- expectedTyp: string | null Formát: date-time
_expiration _time Čas, kdy má tento trh vypršet
- expirationTyp: string Formát: date-time
_time zastaraléthe date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- feeTyp: string | null Formát: date-time
_waiver _expiration _time Čas, kdy vyprší prominutí poplatků tohoto trhu
- floorTyp: number | null Formát: double
_strike Minimální hodnota expirace, která vede k vypořádání YES
- functionalTyp: string | null
_strike Mapování hodnot expirace na hodnoty vypořádání
- isTyp: boolean
_provisional Pokud je true, trh může být po určení odstraněn, pokud na něm není žádná aktivita
- mveTyp: string
_collection _ticker Ticker kolekce multivariačních událostí
- mveTyp: array object[] · Response24B585A0A861_MveSelectedLeg[]
_selected _legs - eventTyp: string
_ticker Jedinečný identifikátor vybrané události
- marketTyp: string
_ticker Jedinečný identifikátor vybraného trhu
- sideTyp: string
Strana vybraného trhu
- yesTyp: string · Response24B585A0A861_FixedPointDollars
_settlement _value _dollars Řetězec částky v amerických dolarech s pevnou řádovou čárkou. Většina polí požadavku přijímá 2-4 desetinná místa (např. "0.56", "0.5600"); odpovědi vracejí až 6 desetinných míst. Platné intervaly kotací pro daný trh jsou omezeny strukturou cenových hladin tohoto trhu.
- occurrenceTyp: string | null Formát: date-time
_datetime Zaznamenané datum a čas, kdy k podkladové události došlo, pokud je k dispozici
- primaryTyp: string | null
_participant _key - settlementTyp: string · Response24B585A0A861_FixedPointDollars
_floor _dollars Řetězec částky v amerických dolarech s pevnou řádovou čárkou. Většina polí požadavku přijímá 2-4 desetinná místa (např. "0.56", "0.5600"); odpovědi vracejí až 6 desetinných míst. Platné intervaly kotací pro daný trh jsou omezeny strukturou cenových hladin tohoto trhu.
- settlementTyp: string | null Formát: date-time
_ts Časové razítko, kdy byl trh vypořádán. Vyplňuje se pouze u vypořádaných trhů
- settlementTyp: string · Response24B585A0A861_FixedPointDollars
_value _dollars Řetězec částky v amerických dolarech s pevnou řádovou čárkou. Většina polí požadavku přijímá 2-4 desetinná místa (např. "0.56", "0.5600"); odpovědi vracejí až 6 desetinných míst. Platné intervaly kotací pro daný trh jsou omezeny strukturou cenových hladin tohoto trhu.
- strikeTyp: string enum
_type Typ realizační ceny určuje, jak se realizační cena trhu definuje a vyhodnocuje
hodnoty- greater
- greater
_or _equal - less
- less
_or _equal - between
- functional
- custom
- structured
- subtitleTyp: stringzastaralé
- titleTyp: stringzastaralé
application/json - 400
Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.
- 401
Je vyžadován platný API klíč Felo.
- 402
V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.
- 403
Účet nemá oprávnění tuto operaci provést.
- 429
Byl dosažen limit požadavků nebo útraty.
- 502
Služba nemohla požadavek dokončit.
- 503
API nebo fakturační služba je dočasně nedostupná.
- 504
Při zpracování požadavku vypršel časový limit služby.
- default
Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele
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.607Z",
"updated_time": "2026-10-26T08:08:16.607Z",
"open_time": "2026-10-26T08:08:16.607Z",
"close_time": "2026-10-26T08:08:16.607Z",
"expected_expiration_time": null,
"latest_expiration_time": "2026-10-26T08:08:16.607Z",
"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"
}