# Kalshi-markten ophalen

**API:** Data API

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

**Tags:** Kalshi

Lijst voorspellingsmarkten met de gedocumenteerde filters status, ticker, event, series en tijdstempel. Het contract bevat max_updated_ts, maar declareert geen zoekparameter voor vrije tekst. Volg het responseschema voor marktrecords en paginering.

### Prijsreferentie

- Metering: Vaste kostenbasis per geslaagd verzoek.
- Referentieschatting per verzoek: USD 0.02.

Alleen referentiemetadata, geen accountofferte, geen gegarandeerde prijs en geen bestedingslimiet. Resourcecredits zijn geen Felo-tegoed. De uiteindelijke kosten volgen de factureringsgegevens van 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 | Pagineringscursor. Gebruik de cursorwaarde uit de vorige respons om de volgende pagina met resultaten op te halen. Laat leeg voor de eerste pagina. |
| `event_ticker` | query | no | string | Event-ticker om op te filteren. Slechts één event-ticker wordt ondersteund. |
| `limit` | query | no | integer, (int64), default: 100 | Aantal resultaten per pagina. Standaard 100. De maximale waarde is 1000. |
| `max_close_ts` | query | no | integer, (int64) | Filtert items die vóór deze Unix-tijdstempel sluiten |
| `max_created_ts` | query | no | integer, (int64) | Filtert items die vóór deze Unix-tijdstempel zijn aangemaakt |
| `max_settled_ts` | query | no | integer, (int64) | Filtert items die vóór deze Unix-tijdstempel zijn afgewikkeld |
| `max_updated_ts` | query | no | integer, (int64) | Retourneert markten waarvan de metadata op of vóór deze Unix-tijdstempel (in seconden) is bijgewerkt. Volgt alleen niet-handelswijzigingen. Kan worden gecombineerd met min_updated_ts en mve_filter=exclude. Kan ook worden gecombineerd met series_ticker, wat mve_filter=exclude vereist. Niet compatibel met andere filters. |
| `min_close_ts` | query | no | integer, (int64) | Filtert items die na deze Unix-tijdstempel sluiten |
| `min_created_ts` | query | no | integer, (int64) | Filtert items die na deze Unix-tijdstempel zijn aangemaakt |
| `min_settled_ts` | query | no | integer, (int64) | Filtert items die na deze Unix-tijdstempel zijn afgewikkeld |
| `min_updated_ts` | query | no | integer, (int64) | Retourneert markten waarvan de metadata later dan deze Unix-tijdstempel (in seconden) is bijgewerkt. Volgt alleen niet-handelswijzigingen. Kan worden gecombineerd met max_updated_ts en mve_filter=exclude. Kan ook worden gecombineerd met series_ticker, wat mve_filter=exclude vereist. Niet compatibel met andere filters. |
| `mve_filter` | query | no | string, enum: "only", "exclude" | Filteren op multivariate events (combo's). 'only' retourneert alleen multivariate events, 'exclude' sluit multivariate events uit. |
| `series_ticker` | query | no | string | Filteren op serie-ticker |
| `status` | query | no | string, enum: "unopened", "open", "paused", "closed", "settled" | Filteren op marktstatus. Laat leeg om markten met elke status te retourneren. |
| `tickers` | query | no | string | Filteren op specifieke markttickers. Kommagescheiden lijst met op te halen markttickers. |

## Responses

### 200 — Markten succesvol opgehaald

Headers:
- `X-Request-Id` (string) — Verzoekidentificatie die je moet meesturen wanneer je contact opneemt met Felo-ondersteuning.

**application/json**

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

### 400 — Het verzoek kon niet worden verwerkt. Controleer de verzoekparameters.

### 401 — Een geldige Felo-API-sleutel is vereist.

### 402 — Het verzoek kan niet doorgaan omdat niet aan een factureringsvoorwaarde is voldaan.

### 403 — Het account mag deze bewerking niet uitvoeren.

### 429 — Een verzoek- of bestedingslimiet is bereikt.

### 502 — De dienst kon het verzoek niet voltooien.

### 503 — De API of factureringsdienst is tijdelijk niet beschikbaar.

### 504 — Er is een time-out opgetreden bij het verwerken van het verzoek.

### default — Foutrespons; upstream-passthrough-responsen kunnen indelingen van de provider gebruiken

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response24B585A0A861_ExchangeIndex

`#/components/schemas/Response24B585A0A861_ExchangeIndex`

```json
{
  "type": "integer",
  "description": "Identificatie voor een exchange-shard.",
  "example": 0
}
```

### Response24B585A0A861_FixedPointCount

`#/components/schemas/Response24B585A0A861_FixedPointCount`

```json
{
  "type": "string",
  "description": "Vastekomma-tekenreeks voor het aantal contracten (2 decimalen, bijvoorbeeld \"10.00\"; in veldnamen \"fp\" genoemd). Verzoeken accepteren 0 tot 2 decimalen (bijvoorbeeld \"10\", \"10.0\", \"10.00\"); responsen geven altijd 2 decimalen. Fractionele contractwaarden (bijvoorbeeld \"2.50\") worden ondersteund; de minimale granulariteit is 0.01 contracten.",
  "example": "10.00"
}
```

### Response24B585A0A861_FixedPointDollars

`#/components/schemas/Response24B585A0A861_FixedPointDollars`

```json
{
  "type": "string",
  "description": "Vastekomma-tekenreeks in Amerikaanse dollars. De meeste aanvraagvelden accepteren 2 tot 4 decimalen (bijvoorbeeld \"0.56\", \"0.5600\"); responsen geven er maximaal 6. Geldige quote-intervallen voor een bepaalde markt worden beperkt door de prijsniveaustructuur van die markt.",
  "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": "Identificeert het type markt"
    },
    "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": "Verkorte titel voor de ja-kant van deze markt"
    },
    "no_sub_title": {
      "type": "string",
      "description": "Verkorte titel voor de NO-kant van deze markt"
    },
    "created_time": {
      "type": "string",
      "format": "date-time"
    },
    "updated_time": {
      "type": "string",
      "format": "date-time",
      "description": "Tijdstip van de laatste metadata-update zonder handelsactiviteit."
    },
    "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": "Tijd waarop deze markt naar verwachting afloopt"
    },
    "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": "Laatst mogelijke tijd waarop deze markt kan aflopen"
    },
    "settlement_timer_seconds": {
      "type": "integer",
      "description": "De tijd na de vaststelling totdat de markt wordt afgewikkeld"
    },
    "status": {
      "type": "string",
      "enum": [
        "initialized",
        "inactive",
        "active",
        "closed",
        "determined",
        "disputed",
        "amended",
        "finalized"
      ],
      "description": "De huidige status van de markt in zijn levenscyclus."
    },
    "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": "Tijdstempel waarop de markt werd afgewikkeld. Alleen ingevuld voor afgewikkelde markten"
    },
    "settlement_bounds_type": {
      "type": "string",
      "enum": [
        "default",
        "floor"
      ],
      "description": "Welke afwikkelingsgrenzen op deze markt van toepassing zijn. default betekent dat de markt geen afwikkelingsgrenzen heeft"
    },
    "settlement_floor_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "expiration_value": {
      "type": "string",
      "description": "De waarde die voor de afwikkeling is overwogen"
    },
    "occurrence_datetime": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "De vastgelegde datum en tijd waarop de onderliggende gebeurtenis heeft plaatsgevonden, indien beschikbaar"
    },
    "fee_waiver_expiration_time": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "x-omitempty": true,
      "description": "Tijd waarop de kwijtschelding van kosten voor deze markt afloopt"
    },
    "early_close_condition": {
      "type": [
        "string",
        "null"
      ],
      "x-omitempty": true,
      "description": "De voorwaarde waaronder de markt vroegtijdig kan sluiten",
      "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": "Het strike-type bepaalt hoe de strike van de markt wordt gedefinieerd en geëvalueerd",
      "x-go-type-skip-optional-pointer": true
    },
    "floor_strike": {
      "type": [
        "number",
        "null"
      ],
      "format": "double",
      "x-omitempty": true,
      "description": "Minimale afloopwaarde die tot een YES-afwikkeling leidt"
    },
    "cap_strike": {
      "type": [
        "number",
        "null"
      ],
      "format": "double",
      "x-omitempty": true,
      "description": "Maximale afloopwaarde die tot een YES-afwikkeling leidt"
    },
    "functional_strike": {
      "type": [
        "string",
        "null"
      ],
      "x-omitempty": true,
      "description": "Toewijzing van afloopwaarden aan afwikkelingswaarden"
    },
    "custom_strike": {
      "type": [
        "object",
        "null"
      ],
      "x-omitempty": true,
      "description": "Afloopwaarde voor elk doel dat tot een YES-afwikkeling leidt"
    },
    "rules_primary": {
      "type": "string",
      "description": "Een beschrijving in eenvoudige taal van de belangrijkste marktvoorwaarden"
    },
    "rules_secondary": {
      "type": "string",
      "description": "Een beschrijving in eenvoudige taal van de voorwaarden van de secundaire markt"
    },
    "mve_collection_ticker": {
      "type": "string",
      "x-omitempty": true,
      "description": "De ticker van de multivariate eventverzameling",
      "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": "Prijsniveaustructuur voor deze markt, die prijsbereiken en tickgroottes definieert"
    },
    "price_ranges": {
      "type": "array",
      "description": "Geldige prijsbereiken voor orders op deze markt",
      "items": {
        "$ref": "#/components/schemas/Response24B585A0A861_PriceRange"
      }
    },
    "is_provisional": {
      "type": "boolean",
      "x-omitempty": true,
      "description": "Als true, kan de markt na de vaststelling worden verwijderd als er geen activiteit op is",
      "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": "Unieke identificatie van de geselecteerde gebeurtenis",
      "x-go-type-skip-optional-pointer": true
    },
    "market_ticker": {
      "type": "string",
      "description": "Unieke identificatie van de geselecteerde markt",
      "x-go-type-skip-optional-pointer": true
    },
    "side": {
      "type": "string",
      "description": "De kant van de geselecteerde markt",
      "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": "Startprijs voor dit bereik in dollars"
    },
    "end": {
      "type": "string",
      "description": "Eindprijs voor dit bereik in dollars"
    },
    "step": {
      "type": "string",
      "description": "Prijsstap/tickgrootte voor dit bereik in dollars"
    }
  }
}
```
