Kalshi
Prediction-market data.
Recupera i mercati Kalshi
Elenca i mercati predittivi usando i filtri documentati status, ticker, event, series e timestamp. Il contratto include max_updated_ts ma non dichiara un parametro di ricerca libera. Segui lo schema della risposta per i record di mercato e la paginazione.
Riferimento prezzi
- Misurazione: base di costo fissa per richiesta riuscita.
- Stima di riferimento per richiesta: USD 0.02.
Solo metadati di riferimento, non un preventivo dell'account, né un prezzo garantito o un limite di spesa. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.
- Tipo: stringcursor
Cursore di paginazione. Usa il valore del cursore restituito dalla risposta precedente per ottenere la pagina successiva di risultati. Lascia vuoto per la prima pagina.
- Tipo: stringevent
_ticker Ticker dell'evento su cui filtrare. È supportato un solo ticker di evento.
- Tipo: integer Formato: int64limitmin:0max:1000
Numero di risultati per pagina. Il valore predefinito è 100. Il valore massimo è 1000.
- Tipo: integer Formato: int64max
_close _ts Filtra gli elementi che chiudono prima di questo timestamp Unix
- Tipo: integer Formato: int64max
_created _ts Filtra gli elementi creati prima di questo timestamp Unix
- Tipo: integer Formato: int64max
_settled _ts Filtra gli elementi regolati prima di questo timestamp Unix
- Tipo: integer Formato: int64max
_updated _ts Restituisce i mercati con metadati aggiornati a o prima di questo timestamp Unix (in secondi). Tiene traccia solo delle modifiche non di trading. Può essere combinato con min_updated_ts e mve_filter=exclude. Può anche essere combinato con series_ticker, che richiede mve_filter=exclude. Incompatibile con altri filtri.
- Tipo: integer Formato: int64min
_close _ts Filtra gli elementi che chiudono dopo questo timestamp Unix
- Tipo: integer Formato: int64min
_created _ts Filtra gli elementi creati dopo questo timestamp Unix
- Tipo: integer Formato: int64min
_settled _ts Filtra gli elementi regolati dopo questo timestamp Unix
- Tipo: integer Formato: int64min
_updated _ts Restituisce i mercati con metadati aggiornati dopo questo timestamp Unix (in secondi). Tiene traccia solo delle modifiche non di trading. Può essere combinato con max_updated_ts e mve_filter=exclude. Può anche essere combinato con series_ticker, che richiede mve_filter=exclude. Incompatibile con altri filtri.
- Tipo: string enummve
_filter Filtra per eventi multivariati (combo). 'only' restituisce solo eventi multivariati, 'exclude' esclude gli eventi multivariati.
valori- only
- exclude
- Tipo: stringseries
_ticker Filtra per ticker della serie
- Tipo: string enumstatus
Filtra per stato del mercato. Lascia vuoto per restituire i mercati con qualsiasi stato.
valori- unopened
- open
- paused
- closed
- settled
- Tipo: stringtickers
Filtra per ticker di mercato specifici. Elenco separato da virgole dei ticker di mercato da recuperare.
- Tipo: object · Response24B585A0A861_GetMarketsResponse200
Mercati recuperati correttamente
- Tipo: stringcursorobbligatorio
- Tipo: array object[] · Response24B585A0A861_Market[]marketsobbligatorio
- canTipo: boolean
_close _early obbligatorio - closeTipo: string Formato: date-time
_time obbligatoriothe date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- createdTipo: string Formato: date-time
_time obbligatoriothe date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- eventTipo: string
_ticker obbligatorio - expirationTipo: string
_value obbligatorioIl valore considerato per la liquidazione
- lastTipo: string · Response24B585A0A861_FixedPointDollars
_price _dollars obbligatorioStringa a virgola fissa in dollari statunitensi. La maggior parte dei campi della richiesta accetta da 2 a 4 decimali (ad es. "0.56", "0.5600"); le risposte ne emettono fino a 6. Gli intervalli di quotazione validi per un dato mercato sono vincolati dalla struttura dei livelli di prezzo di quel mercato.
- latestTipo: string Formato: date-time
_expiration _time obbligatorioUltimo momento possibile in cui questo mercato può scadere
- marketTipo: string enum
_type obbligatorioIdentifica il tipo di mercato
valori- binary
- scalar
- noTipo: string · Response24B585A0A861_FixedPointDollars
_ask _dollars obbligatorioStringa a virgola fissa in dollari statunitensi. La maggior parte dei campi della richiesta accetta da 2 a 4 decimali (ad es. "0.56", "0.5600"); le risposte ne emettono fino a 6. Gli intervalli di quotazione validi per un dato mercato sono vincolati dalla struttura dei livelli di prezzo di quel mercato.
- noTipo: string · Response24B585A0A861_FixedPointDollars
_bid _dollars obbligatorioStringa a virgola fissa in dollari statunitensi. La maggior parte dei campi della richiesta accetta da 2 a 4 decimali (ad es. "0.56", "0.5600"); le risposte ne emettono fino a 6. Gli intervalli di quotazione validi per un dato mercato sono vincolati dalla struttura dei livelli di prezzo di quel mercato.
- noTipo: string
_sub _title obbligatorioTitolo abbreviato per il lato NO di questo mercato
- notionalTipo: string · Response24B585A0A861_FixedPointDollars
_value _dollars obbligatorioStringa a virgola fissa in dollari statunitensi. La maggior parte dei campi della richiesta accetta da 2 a 4 decimali (ad es. "0.56", "0.5600"); le risposte ne emettono fino a 6. Gli intervalli di quotazione validi per un dato mercato sono vincolati dalla struttura dei livelli di prezzo di quel mercato.
- openTipo: string · Response24B585A0A861_FixedPointCount
_interest _fp obbligatorioStringa a virgola fissa per il numero di contratti (2 decimali, ad es. "10.00"; indicata come "fp" nei nomi dei campi). Le richieste accettano da 0 a 2 decimali (ad es. "10", "10.0", "10.00"); le risposte emettono sempre 2 decimali. Sono supportati valori contrattuali frazionari (ad es. "2.50"); la granularità minima è 0.01 contratti.
- openTipo: string Formato: date-time
_time obbligatoriothe date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- previousTipo: string · Response24B585A0A861_FixedPointDollars
_price _dollars obbligatorioStringa a virgola fissa in dollari statunitensi. La maggior parte dei campi della richiesta accetta da 2 a 4 decimali (ad es. "0.56", "0.5600"); le risposte ne emettono fino a 6. Gli intervalli di quotazione validi per un dato mercato sono vincolati dalla struttura dei livelli di prezzo di quel mercato.
- previousTipo: string · Response24B585A0A861_FixedPointDollars
_yes _ask _dollars obbligatorioStringa a virgola fissa in dollari statunitensi. La maggior parte dei campi della richiesta accetta da 2 a 4 decimali (ad es. "0.56", "0.5600"); le risposte ne emettono fino a 6. Gli intervalli di quotazione validi per un dato mercato sono vincolati dalla struttura dei livelli di prezzo di quel mercato.
- previousTipo: string · Response24B585A0A861_FixedPointDollars
_yes _bid _dollars obbligatorioStringa a virgola fissa in dollari statunitensi. La maggior parte dei campi della richiesta accetta da 2 a 4 decimali (ad es. "0.56", "0.5600"); le risposte ne emettono fino a 6. Gli intervalli di quotazione validi per un dato mercato sono vincolati dalla struttura dei livelli di prezzo di quel mercato.
- priceTipo: string
_level _structure obbligatorioStruttura dei livelli di prezzo per questo mercato, che definisce intervalli di prezzo e dimensioni dei tick
- priceTipo: array object[] · Response24B585A0A861_PriceRange[]
_ranges obbligatorioIntervalli di prezzo validi per gli ordini su questo mercato
- endTipo: stringobbligatorio
Prezzo finale per questo intervallo in dollari
- startTipo: stringobbligatorio
Prezzo iniziale per questo intervallo in dollari
- stepTipo: stringobbligatorio
Passo di prezzo/dimensione del tick per questo intervallo in dollari
- resultTipo: string enumobbligatoriovalori
- yes
- no
- scalar
- rulesTipo: string
_primary obbligatorioUna descrizione in linguaggio semplice dei termini di mercato più importanti
- rulesTipo: string
_secondary obbligatorioUna descrizione in linguaggio semplice dei termini del mercato secondario
- settlementTipo: string enum
_bounds _type obbligatorioQuali limiti di liquidazione si applicano a questo mercato. default significa che il mercato non ha limiti di liquidazione
valori- default
- floor
- settlementTipo: integer
_timer _seconds obbligatorioIl tempo che intercorre tra la determinazione e la liquidazione del mercato
- statusTipo: string enumobbligatorio
Lo stato attuale del mercato nel suo ciclo di vita.
valori- initialized
- inactive
- active
- closed
- determined
- disputed
- amended
- finalized
- tickerTipo: stringobbligatorio
- updatedTipo: string Formato: date-time
_time obbligatorioOra dell'ultimo aggiornamento dei metadati senza attività di negoziazione.
- volumeTipo: string · Response24B585A0A861_FixedPointCount
_24h _fp obbligatorioStringa a virgola fissa per il numero di contratti (2 decimali, ad es. "10.00"; indicata come "fp" nei nomi dei campi). Le richieste accettano da 0 a 2 decimali (ad es. "10", "10.0", "10.00"); le risposte emettono sempre 2 decimali. Sono supportati valori contrattuali frazionari (ad es. "2.50"); la granularità minima è 0.01 contratti.
- volumeTipo: string · Response24B585A0A861_FixedPointCount
_fp obbligatorioStringa a virgola fissa per il numero di contratti (2 decimali, ad es. "10.00"; indicata come "fp" nei nomi dei campi). Le richieste accettano da 0 a 2 decimali (ad es. "10", "10.0", "10.00"); le risposte emettono sempre 2 decimali. Sono supportati valori contrattuali frazionari (ad es. "2.50"); la granularità minima è 0.01 contratti.
- yesTipo: string · Response24B585A0A861_FixedPointDollars
_ask _dollars obbligatorioStringa a virgola fissa in dollari statunitensi. La maggior parte dei campi della richiesta accetta da 2 a 4 decimali (ad es. "0.56", "0.5600"); le risposte ne emettono fino a 6. Gli intervalli di quotazione validi per un dato mercato sono vincolati dalla struttura dei livelli di prezzo di quel mercato.
- yesTipo: string · Response24B585A0A861_FixedPointCount
_ask _size _fp obbligatorioStringa a virgola fissa per il numero di contratti (2 decimali, ad es. "10.00"; indicata come "fp" nei nomi dei campi). Le richieste accettano da 0 a 2 decimali (ad es. "10", "10.0", "10.00"); le risposte emettono sempre 2 decimali. Sono supportati valori contrattuali frazionari (ad es. "2.50"); la granularità minima è 0.01 contratti.
- yesTipo: string · Response24B585A0A861_FixedPointDollars
_bid _dollars obbligatorioStringa a virgola fissa in dollari statunitensi. La maggior parte dei campi della richiesta accetta da 2 a 4 decimali (ad es. "0.56", "0.5600"); le risposte ne emettono fino a 6. Gli intervalli di quotazione validi per un dato mercato sono vincolati dalla struttura dei livelli di prezzo di quel mercato.
- yesTipo: string · Response24B585A0A861_FixedPointCount
_bid _size _fp obbligatorioStringa a virgola fissa per il numero di contratti (2 decimali, ad es. "10.00"; indicata come "fp" nei nomi dei campi). Le richieste accettano da 0 a 2 decimali (ad es. "10", "10.0", "10.00"); le risposte emettono sempre 2 decimali. Sono supportati valori contrattuali frazionari (ad es. "2.50"); la granularità minima è 0.01 contratti.
- yesTipo: string
_sub _title obbligatorioTitolo abbreviato per il lato sì di questo mercato
- capTipo: number | null Formato: double
_strike Valore di scadenza massimo che porta a una liquidazione YES
- customTipo: object | null
_strike Valore di scadenza per ogni obiettivo che porta a una liquidazione YES
- earlyTipo: string | null
_close _condition La condizione in base alla quale il mercato può chiudere in anticipo
- exchangeTipo: integer · Response24B585A0A861_ExchangeIndex
_index Identificatore di uno shard di exchange.
- expectedTipo: string | null Formato: date-time
_expiration _time Ora in cui si prevede che questo mercato scada
- expirationTipo: string Formato: date-time
_time deprecatothe date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- feeTipo: string | null Formato: date-time
_waiver _expiration _time Ora in cui scade l'esenzione dalle commissioni di questo mercato
- floorTipo: number | null Formato: double
_strike Valore di scadenza minimo che porta a una liquidazione YES
- functionalTipo: string | null
_strike Mappatura dai valori di scadenza ai valori di liquidazione
- isTipo: boolean
_provisional Se true, il mercato può essere rimosso dopo la determinazione se non vi è attività su di esso
- mveTipo: string
_collection _ticker Il ticker della raccolta di eventi multivariati
- mveTipo: array object[] · Response24B585A0A861_MveSelectedLeg[]
_selected _legs - eventTipo: string
_ticker Identificatore univoco dell'evento selezionato
- marketTipo: string
_ticker Identificatore univoco del mercato selezionato
- sideTipo: string
Il lato del mercato selezionato
- yesTipo: string · Response24B585A0A861_FixedPointDollars
_settlement _value _dollars Stringa a virgola fissa in dollari statunitensi. La maggior parte dei campi della richiesta accetta da 2 a 4 decimali (ad es. "0.56", "0.5600"); le risposte ne emettono fino a 6. Gli intervalli di quotazione validi per un dato mercato sono vincolati dalla struttura dei livelli di prezzo di quel mercato.
- occurrenceTipo: string | null Formato: date-time
_datetime La data e ora registrata in cui si è verificato l'evento sottostante, se disponibile
- primaryTipo: string | null
_participant _key - settlementTipo: string · Response24B585A0A861_FixedPointDollars
_floor _dollars Stringa a virgola fissa in dollari statunitensi. La maggior parte dei campi della richiesta accetta da 2 a 4 decimali (ad es. "0.56", "0.5600"); le risposte ne emettono fino a 6. Gli intervalli di quotazione validi per un dato mercato sono vincolati dalla struttura dei livelli di prezzo di quel mercato.
- settlementTipo: string | null Formato: date-time
_ts Timestamp di liquidazione del mercato. Compilato solo per i mercati liquidati
- settlementTipo: string · Response24B585A0A861_FixedPointDollars
_value _dollars Stringa a virgola fissa in dollari statunitensi. La maggior parte dei campi della richiesta accetta da 2 a 4 decimali (ad es. "0.56", "0.5600"); le risposte ne emettono fino a 6. Gli intervalli di quotazione validi per un dato mercato sono vincolati dalla struttura dei livelli di prezzo di quel mercato.
- strikeTipo: string enum
_type Il tipo di strike definisce come viene definito e valutato lo strike del mercato
valori- greater
- greater
_or _equal - less
- less
_or _equal - between
- functional
- custom
- structured
- subtitleTipo: stringdeprecato
- titleTipo: stringdeprecato
application/json - 400
Impossibile elaborare la richiesta. Controlla i parametri della richiesta.
- 401
È richiesta una chiave API Felo valida.
- 402
Impossibile procedere con la richiesta perché non è soddisfatto un requisito di fatturazione.
- 403
L'account non è autorizzato a eseguire questa operazione.
- 429
È stato raggiunto un limite di richieste o di spesa.
- 502
Il servizio non è riuscito a completare la richiesta.
- 503
L'API o il servizio di fatturazione è temporaneamente non disponibile.
- 504
Si è verificato un timeout durante l'elaborazione della richiesta.
- default
Risposta di errore; le risposte passthrough upstream possono usare formati del provider
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.601Z",
"updated_time": "2026-10-26T08:08:16.601Z",
"open_time": "2026-10-26T08:08:16.601Z",
"close_time": "2026-10-26T08:08:16.601Z",
"expected_expiration_time": null,
"latest_expiration_time": "2026-10-26T08:08:16.601Z",
"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"
}