# Obter mercados Kalshi

**API:** Data API

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

**Tags:** 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.

## 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 | 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. |
| `event_ticker` | query | no | string | Ticker de evento pelo qual filtrar. Apenas um único ticker de evento é suportado. |
| `limit` | query | no | integer, (int64), default: 100 | Número de resultados por página. O padrão é 100. O valor máximo é 1000. |
| `max_close_ts` | query | no | integer, (int64) | Filtra itens que fecham antes deste timestamp Unix |
| `max_created_ts` | query | no | integer, (int64) | Filtra itens criados antes deste timestamp Unix |
| `max_settled_ts` | query | no | integer, (int64) | Filtra itens liquidados antes deste timestamp Unix |
| `max_updated_ts` | query | no | integer, (int64) | 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. |
| `min_close_ts` | query | no | integer, (int64) | Filtra itens que fecham depois deste timestamp Unix |
| `min_created_ts` | query | no | integer, (int64) | Filtra itens criados depois deste timestamp Unix |
| `min_settled_ts` | query | no | integer, (int64) | Filtra itens liquidados depois deste timestamp Unix |
| `min_updated_ts` | query | no | integer, (int64) | 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. |
| `mve_filter` | query | no | string, enum: "only", "exclude" | Filtra por eventos multivariados (combos). 'only' retorna apenas eventos multivariados, 'exclude' exclui eventos multivariados. |
| `series_ticker` | query | no | string | Filtra por ticker de série |
| `status` | query | no | string, enum: "unopened", "open", "paused", "closed", "settled" | Filtra por status de mercado. Deixe vazio para retornar mercados com qualquer status. |
| `tickers` | query | no | string | Filtra por tickers de mercado específicos. Lista separada por vírgulas de tickers de mercado a recuperar. |

## Responses

### 200 — Mercados recuperados com sucesso

Headers:
- `X-Request-Id` (string) — Identificador da requisição a incluir ao contatar o suporte da Felo.

**application/json**

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

### 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**

Schema:

```json
{}
```

## Schema definitions

### Response24B585A0A861_ExchangeIndex

`#/components/schemas/Response24B585A0A861_ExchangeIndex`

```json
{
  "type": "integer",
  "description": "Identificador de um shard de exchange.",
  "example": 0
}
```

### Response24B585A0A861_FixedPointCount

`#/components/schemas/Response24B585A0A861_FixedPointCount`

```json
{
  "type": "string",
  "description": "String 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.",
  "example": "10.00"
}
```

### Response24B585A0A861_FixedPointDollars

`#/components/schemas/Response24B585A0A861_FixedPointDollars`

```json
{
  "type": "string",
  "description": "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.",
  "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": "Identifica o tipo de mercado"
    },
    "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": "Título abreviado do lado «sim» deste mercado"
    },
    "no_sub_title": {
      "type": "string",
      "description": "Título abreviado para o lado no deste mercado"
    },
    "created_time": {
      "type": "string",
      "format": "date-time"
    },
    "updated_time": {
      "type": "string",
      "format": "date-time",
      "description": "Horário da última atualização de metadados que não seja de negociação."
    },
    "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": "Horário em que este mercado deve expirar"
    },
    "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": "Horário mais tardio possível para este mercado expirar"
    },
    "settlement_timer_seconds": {
      "type": "integer",
      "description": "O tempo que o mercado leva para ser liquidado após a determinação"
    },
    "status": {
      "type": "string",
      "enum": [
        "initialized",
        "inactive",
        "active",
        "closed",
        "determined",
        "disputed",
        "amended",
        "finalized"
      ],
      "description": "O status atual do mercado em seu ciclo de vida."
    },
    "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": "Carimbo de data/hora da liquidação do mercado. Preenchido apenas para mercados liquidados"
    },
    "settlement_bounds_type": {
      "type": "string",
      "enum": [
        "default",
        "floor"
      ],
      "description": "Quais limites de liquidação se aplicam a este mercado. default significa que o mercado não tem limites de liquidação"
    },
    "settlement_floor_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "expiration_value": {
      "type": "string",
      "description": "O valor que foi considerado para a liquidação"
    },
    "occurrence_datetime": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "A data e hora registradas de quando o evento subjacente ocorreu, se disponível"
    },
    "fee_waiver_expiration_time": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "x-omitempty": true,
      "description": "Horário em que a isenção de taxas deste mercado expira"
    },
    "early_close_condition": {
      "type": [
        "string",
        "null"
      ],
      "x-omitempty": true,
      "description": "A condição sob a qual o mercado pode fechar antecipadamente",
      "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": "O tipo de strike define como o strike do mercado é definido e avaliado",
      "x-go-type-skip-optional-pointer": true
    },
    "floor_strike": {
      "type": [
        "number",
        "null"
      ],
      "format": "double",
      "x-omitempty": true,
      "description": "Valor mínimo de expiração que leva a uma liquidação YES"
    },
    "cap_strike": {
      "type": [
        "number",
        "null"
      ],
      "format": "double",
      "x-omitempty": true,
      "description": "Valor máximo de expiração que leva a uma liquidação YES"
    },
    "functional_strike": {
      "type": [
        "string",
        "null"
      ],
      "x-omitempty": true,
      "description": "Mapeamento de valores de expiração para valores de liquidação"
    },
    "custom_strike": {
      "type": [
        "object",
        "null"
      ],
      "x-omitempty": true,
      "description": "Valor de expiração para cada alvo que leva a uma liquidação YES"
    },
    "rules_primary": {
      "type": "string",
      "description": "Uma descrição em linguagem simples dos termos mais importantes do mercado"
    },
    "rules_secondary": {
      "type": "string",
      "description": "Uma descrição em linguagem simples dos termos do mercado secundário"
    },
    "mve_collection_ticker": {
      "type": "string",
      "x-omitempty": true,
      "description": "O ticker da coleção de eventos multivariados",
      "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": "Estrutura de níveis de preço deste mercado, que define faixas de preço e tamanhos de tick"
    },
    "price_ranges": {
      "type": "array",
      "description": "Faixas de preço válidas para ordens neste mercado",
      "items": {
        "$ref": "#/components/schemas/Response24B585A0A861_PriceRange"
      }
    },
    "is_provisional": {
      "type": "boolean",
      "x-omitempty": true,
      "description": "Se true, o mercado pode ser removido após a determinação se não houver atividade nele",
      "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": "Identificador exclusivo do evento selecionado",
      "x-go-type-skip-optional-pointer": true
    },
    "market_ticker": {
      "type": "string",
      "description": "Identificador exclusivo do mercado selecionado",
      "x-go-type-skip-optional-pointer": true
    },
    "side": {
      "type": "string",
      "description": "O lado do mercado selecionado",
      "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": "Preço inicial deste intervalo em dólares"
    },
    "end": {
      "type": "string",
      "description": "Preço final deste intervalo em dólares"
    },
    "step": {
      "type": "string",
      "description": "Incremento/tick de preço deste intervalo em dólares"
    }
  }
}
```
