Kalshi
Prediction-market data.
Obter mercados Kalshi
Lista mercados de previsão usando os filtros documentados status, ticker, event, series e timestamp. O contrato inclui max_updated_ts, mas não declara um parâmetro de busca em texto livre. Siga o esquema de resposta para registros de mercado e paginação.
Referência de preços
- Medição: base de custo fixa por requisição bem-sucedida.
- Estimativa de referência por requisição: USD 0.02.
- Multiplicador de referência do cliente: 1.0. Não o aplique novamente a um valor de cliente já liquidado.
Apenas metadados de referência, não uma cotação da conta, um preço garantido ou um limite de gastos. Créditos de recursos não são créditos Felo. As cobranças finais seguem os registros de cobrança da Felo.
- Tipo: stringcursor
Cursor de paginação. Use o valor de cursor retornado pela resposta anterior para obter a próxima página de resultados. Deixe vazio para a primeira página.
- Tipo: stringevent
_ticker Ticker de evento pelo qual filtrar. Apenas um único ticker de evento é suportado.
- Tipo: integer Formato: int64limitmín:0máx:1000
Número de resultados por página. O padrão é 100. O valor máximo é 1000.
- Tipo: integer Formato: int64max
_close _ts Filtra itens que fecham antes deste timestamp Unix
- Tipo: integer Formato: int64max
_created _ts Filtra itens criados antes deste timestamp Unix
- Tipo: integer Formato: int64max
_settled _ts Filtra itens liquidados antes deste timestamp Unix
- Tipo: integer Formato: int64max
_updated _ts Retorna mercados com metadados atualizados até este timestamp Unix (em segundos). Rastreia apenas alterações que não são de negociação. Pode ser combinado com min_updated_ts e mve_filter=exclude. Também pode ser combinado com series_ticker, que exige mve_filter=exclude. Incompatível com outros filtros.
- Tipo: integer Formato: int64min
_close _ts Filtra itens que fecham depois deste timestamp Unix
- Tipo: integer Formato: int64min
_created _ts Filtra itens criados depois deste timestamp Unix
- Tipo: integer Formato: int64min
_settled _ts Filtra itens liquidados depois deste timestamp Unix
- Tipo: integer Formato: int64min
_updated _ts Retorna mercados com metadados atualizados depois deste timestamp Unix (em segundos). Rastreia apenas alterações que não são de negociação. Pode ser combinado com max_updated_ts e mve_filter=exclude. Também pode ser combinado com series_ticker, que exige mve_filter=exclude. Incompatível com outros filtros.
- Tipo: string enummve
_filter Filtra por eventos multivariados (combos). 'only' retorna apenas eventos multivariados, 'exclude' exclui eventos multivariados.
valores- only
- exclude
- Tipo: stringseries
_ticker Filtra por ticker de série
- Tipo: string enumstatus
Filtra por status de mercado. Deixe vazio para retornar mercados com qualquer status.
valores- unopened
- open
- paused
- closed
- settled
- Tipo: stringtickers
Filtra por tickers de mercado específicos. Lista separada por vírgulas de tickers de mercado a recuperar.
- Tipo: object · Response24B585A0A861_GetMarketsResponse200
Mercados recuperados com sucesso
- Tipo: stringcursorobrigatório
- Tipo: array object[] · Response24B585A0A861_Market[]marketsobrigatório
- canTipo: boolean
_close _early obrigatório - closeTipo: string Formato: date-time
_time obrigatóriothe date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- createdTipo: string Formato: date-time
_time obrigatóriothe date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- eventTipo: string
_ticker obrigatório - expirationTipo: string
_value obrigatórioO valor que foi considerado para a liquidação
- lastTipo: string · Response24B585A0A861_FixedPointDollars
_price _dollars obrigatórioString de dólar americano em ponto fixo. A maioria dos campos de requisição aceita de 2 a 4 casas decimais (por exemplo, "0.56", "0.5600"); as respostas emitem até 6. Os intervalos de cotação válidos para um determinado mercado são restringidos pela estrutura de níveis de preço desse mercado.
- latestTipo: string Formato: date-time
_expiration _time obrigatórioHorário mais tardio possível para este mercado expirar
- marketTipo: string enum
_type obrigatórioIdentifica o tipo de mercado
valores- binary
- scalar
- noTipo: string · Response24B585A0A861_FixedPointDollars
_ask _dollars obrigatórioString de dólar americano em ponto fixo. A maioria dos campos de requisição aceita de 2 a 4 casas decimais (por exemplo, "0.56", "0.5600"); as respostas emitem até 6. Os intervalos de cotação válidos para um determinado mercado são restringidos pela estrutura de níveis de preço desse mercado.
- noTipo: string · Response24B585A0A861_FixedPointDollars
_bid _dollars obrigatórioString de dólar americano em ponto fixo. A maioria dos campos de requisição aceita de 2 a 4 casas decimais (por exemplo, "0.56", "0.5600"); as respostas emitem até 6. Os intervalos de cotação válidos para um determinado mercado são restringidos pela estrutura de níveis de preço desse mercado.
- noTipo: string
_sub _title obrigatórioTítulo abreviado para o lado no deste mercado
- notionalTipo: string · Response24B585A0A861_FixedPointDollars
_value _dollars obrigatórioString de dólar americano em ponto fixo. A maioria dos campos de requisição aceita de 2 a 4 casas decimais (por exemplo, "0.56", "0.5600"); as respostas emitem até 6. Os intervalos de cotação válidos para um determinado mercado são restringidos pela estrutura de níveis de preço desse mercado.
- openTipo: string · Response24B585A0A861_FixedPointCount
_interest _fp obrigatórioString de contagem de contratos em ponto fixo (2 casas decimais, por exemplo, "10.00"; chamada de "fp" nos nomes dos campos). As requisições aceitam de 0 a 2 casas decimais (por exemplo, "10", "10.0", "10.00"); as respostas sempre emitem 2 casas decimais. Valores fracionários de contrato (por exemplo, "2.50") são suportados; a granularidade mínima é de 0,01 contratos.
- openTipo: string Formato: date-time
_time obrigatóriothe date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- previousTipo: string · Response24B585A0A861_FixedPointDollars
_price _dollars obrigatórioString de dólar americano em ponto fixo. A maioria dos campos de requisição aceita de 2 a 4 casas decimais (por exemplo, "0.56", "0.5600"); as respostas emitem até 6. Os intervalos de cotação válidos para um determinado mercado são restringidos pela estrutura de níveis de preço desse mercado.
- previousTipo: string · Response24B585A0A861_FixedPointDollars
_yes _ask _dollars obrigatórioString de dólar americano em ponto fixo. A maioria dos campos de requisição aceita de 2 a 4 casas decimais (por exemplo, "0.56", "0.5600"); as respostas emitem até 6. Os intervalos de cotação válidos para um determinado mercado são restringidos pela estrutura de níveis de preço desse mercado.
- previousTipo: string · Response24B585A0A861_FixedPointDollars
_yes _bid _dollars obrigatórioString de dólar americano em ponto fixo. A maioria dos campos de requisição aceita de 2 a 4 casas decimais (por exemplo, "0.56", "0.5600"); as respostas emitem até 6. Os intervalos de cotação válidos para um determinado mercado são restringidos pela estrutura de níveis de preço desse mercado.
- priceTipo: string
_level _structure obrigatórioEstrutura de níveis de preço deste mercado, que define faixas de preço e tamanhos de tick
- priceTipo: array object[] · Response24B585A0A861_PriceRange[]
_ranges obrigatórioFaixas de preço válidas para ordens neste mercado
- endTipo: stringobrigatório
Preço final deste intervalo em dólares
- startTipo: stringobrigatório
Preço inicial deste intervalo em dólares
- stepTipo: stringobrigatório
Incremento/tick de preço deste intervalo em dólares
- resultTipo: string enumobrigatóriovalores
- yes
- no
- scalar
- rulesTipo: string
_primary obrigatórioUma descrição em linguagem simples dos termos mais importantes do mercado
- rulesTipo: string
_secondary obrigatórioUma descrição em linguagem simples dos termos do mercado secundário
- settlementTipo: string enum
_bounds _type obrigatórioQuais limites de liquidação se aplicam a este mercado. default significa que o mercado não tem limites de liquidação
valores- default
- floor
- settlementTipo: integer
_timer _seconds obrigatórioO tempo que o mercado leva para ser liquidado após a determinação
- statusTipo: string enumobrigatório
O status atual do mercado em seu ciclo de vida.
valores- initialized
- inactive
- active
- closed
- determined
- disputed
- amended
- finalized
- tickerTipo: stringobrigatório
- updatedTipo: string Formato: date-time
_time obrigatórioHorário da última atualização de metadados que não seja de negociação.
- volumeTipo: string · Response24B585A0A861_FixedPointCount
_24h _fp obrigatórioString de contagem de contratos em ponto fixo (2 casas decimais, por exemplo, "10.00"; chamada de "fp" nos nomes dos campos). As requisições aceitam de 0 a 2 casas decimais (por exemplo, "10", "10.0", "10.00"); as respostas sempre emitem 2 casas decimais. Valores fracionários de contrato (por exemplo, "2.50") são suportados; a granularidade mínima é de 0,01 contratos.
- volumeTipo: string · Response24B585A0A861_FixedPointCount
_fp obrigatórioString de contagem de contratos em ponto fixo (2 casas decimais, por exemplo, "10.00"; chamada de "fp" nos nomes dos campos). As requisições aceitam de 0 a 2 casas decimais (por exemplo, "10", "10.0", "10.00"); as respostas sempre emitem 2 casas decimais. Valores fracionários de contrato (por exemplo, "2.50") são suportados; a granularidade mínima é de 0,01 contratos.
- yesTipo: string · Response24B585A0A861_FixedPointDollars
_ask _dollars obrigatórioString de dólar americano em ponto fixo. A maioria dos campos de requisição aceita de 2 a 4 casas decimais (por exemplo, "0.56", "0.5600"); as respostas emitem até 6. Os intervalos de cotação válidos para um determinado mercado são restringidos pela estrutura de níveis de preço desse mercado.
- yesTipo: string · Response24B585A0A861_FixedPointCount
_ask _size _fp obrigatórioString de contagem de contratos em ponto fixo (2 casas decimais, por exemplo, "10.00"; chamada de "fp" nos nomes dos campos). As requisições aceitam de 0 a 2 casas decimais (por exemplo, "10", "10.0", "10.00"); as respostas sempre emitem 2 casas decimais. Valores fracionários de contrato (por exemplo, "2.50") são suportados; a granularidade mínima é de 0,01 contratos.
- yesTipo: string · Response24B585A0A861_FixedPointDollars
_bid _dollars obrigatórioString de dólar americano em ponto fixo. A maioria dos campos de requisição aceita de 2 a 4 casas decimais (por exemplo, "0.56", "0.5600"); as respostas emitem até 6. Os intervalos de cotação válidos para um determinado mercado são restringidos pela estrutura de níveis de preço desse mercado.
- yesTipo: string · Response24B585A0A861_FixedPointCount
_bid _size _fp obrigatórioString de contagem de contratos em ponto fixo (2 casas decimais, por exemplo, "10.00"; chamada de "fp" nos nomes dos campos). As requisições aceitam de 0 a 2 casas decimais (por exemplo, "10", "10.0", "10.00"); as respostas sempre emitem 2 casas decimais. Valores fracionários de contrato (por exemplo, "2.50") são suportados; a granularidade mínima é de 0,01 contratos.
- yesTipo: string
_sub _title obrigatórioTítulo abreviado do lado «sim» deste mercado
- capTipo: number | null Formato: double
_strike Valor máximo de expiração que leva a uma liquidação YES
- customTipo: object | null
_strike Valor de expiração para cada alvo que leva a uma liquidação YES
- earlyTipo: string | null
_close _condition A condição sob a qual o mercado pode fechar antecipadamente
- exchangeTipo: integer · Response24B585A0A861_ExchangeIndex
_index Identificador de um shard de exchange.
- expectedTipo: string | null Formato: date-time
_expiration _time Horário em que este mercado deve expirar
- expirationTipo: string Formato: date-time
_time obsoletothe 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 Horário em que a isenção de taxas deste mercado expira
- floorTipo: number | null Formato: double
_strike Valor mínimo de expiração que leva a uma liquidação YES
- functionalTipo: string | null
_strike Mapeamento de valores de expiração para valores de liquidação
- isTipo: boolean
_provisional Se true, o mercado pode ser removido após a determinação se não houver atividade nele
- mveTipo: string
_collection _ticker O ticker da coleção de eventos multivariados
- mveTipo: array object[] · Response24B585A0A861_MveSelectedLeg[]
_selected _legs - eventTipo: string
_ticker Identificador exclusivo do evento selecionado
- marketTipo: string
_ticker Identificador exclusivo do mercado selecionado
- sideTipo: string
O lado do mercado selecionado
- yesTipo: string · Response24B585A0A861_FixedPointDollars
_settlement _value _dollars String de dólar americano em ponto fixo. A maioria dos campos de requisição aceita de 2 a 4 casas decimais (por exemplo, "0.56", "0.5600"); as respostas emitem até 6. Os intervalos de cotação válidos para um determinado mercado são restringidos pela estrutura de níveis de preço desse mercado.
- occurrenceTipo: string | null Formato: date-time
_datetime A data e hora registradas de quando o evento subjacente ocorreu, se disponível
- primaryTipo: string | null
_participant _key - settlementTipo: string · Response24B585A0A861_FixedPointDollars
_floor _dollars String de dólar americano em ponto fixo. A maioria dos campos de requisição aceita de 2 a 4 casas decimais (por exemplo, "0.56", "0.5600"); as respostas emitem até 6. Os intervalos de cotação válidos para um determinado mercado são restringidos pela estrutura de níveis de preço desse mercado.
- settlementTipo: string | null Formato: date-time
_ts Carimbo de data/hora da liquidação do mercado. Preenchido apenas para mercados liquidados
- settlementTipo: string · Response24B585A0A861_FixedPointDollars
_value _dollars String de dólar americano em ponto fixo. A maioria dos campos de requisição aceita de 2 a 4 casas decimais (por exemplo, "0.56", "0.5600"); as respostas emitem até 6. Os intervalos de cotação válidos para um determinado mercado são restringidos pela estrutura de níveis de preço desse mercado.
- strikeTipo: string enum
_type O tipo de strike define como o strike do mercado é definido e avaliado
valores- greater
- greater
_or _equal - less
- less
_or _equal - between
- functional
- custom
- structured
- subtitleTipo: stringobsoleto
- titleTipo: stringobsoleto
application/json - 400
Não foi possível processar a requisição. Verifique os parâmetros da requisição.
- 401
É necessária uma chave de API da Felo válida.
- 402
A requisição não pode prosseguir porque um requisito de cobrança não foi atendido.
- 403
A conta não tem permissão para realizar esta operação.
- 429
Um limite de requisições ou de gastos foi atingido.
- 502
O serviço não pôde concluir a requisição.
- 503
A API ou o serviço de cobrança está temporariamente indisponível.
- 504
O serviço atingiu o tempo limite ao processar a requisição.
- default
Resposta de erro; respostas repassadas do upstream podem usar formatos do provedor
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"
}