> ## Documentation Index
> Fetch the complete documentation index at: https://docs.entityml.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Kalshi Markets

> List stored Kalshi market tickers from the backing S3 inventory.

## Request

### Headers

<ParamField header="Authorization" type="string" required>
  Bearer token. Example: `Bearer YOUR_API_KEY`
</ParamField>

### Query Parameters

<ParamField query="prefix" type="string">
  Optional ticker prefix filter. Values are normalized to uppercase. Example: `KXBTC-26FEB2606`.
</ParamField>

<ParamField query="offset" type="integer">
  Number of markets to skip. Default: `0`.
</ParamField>

<ParamField query="limit" type="integer">
  Maximum number of markets to return. Default: `100`. Max: `1000`.
</ParamField>

## Response

<ResponseField name="total_markets" type="integer">
  Total number of stored Kalshi markets after applying the optional prefix filter.
</ResponseField>

<ResponseField name="returned_count" type="integer">
  Number of tickers returned in this page.
</ResponseField>

<ResponseField name="filter_prefix" type="string">
  The normalized ticker prefix filter that was applied, if any.
</ResponseField>

<ResponseField name="market_tickers" type="array">
  Array of stored Kalshi market tickers.
</ResponseField>

<ResponseField name="pagination" type="object">
  Standard pagination metadata with `offset`, `limit`, `total_count`, and `has_more`.
</ResponseField>

<Tip>
  Each successful call to this endpoint counts as 1 API request.
</Tip>

## Example

<CodeGroup>
  ```bash Raw HTTP (cURL) theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    "https://api.entityml.com/api/v1/kalshi/market/list?prefix=KXBTC-26FEB2606&offset=0&limit=5"
  ```

  ```python Python theme={null}
  import os
  import requests

  response = requests.get(
      "https://api.entityml.com/api/v1/kalshi/market/list",
      headers={"Authorization": f"Bearer {os.environ['ENTITY_API_KEY']}"},
      params={"prefix": "KXBTC-26FEB2606", "offset": 0, "limit": 5},
  )

  print(response.json())
  ```
</CodeGroup>

### Example response

```json theme={null}
{
  "total_markets": 5,
  "returned_count": 5,
  "filter_prefix": "KXBTC-26FEB2606",
  "market_tickers": [
    "KXBTC-26FEB2606-B59375",
    "KXBTC-26FEB2606-B59625",
    "KXBTC-26FEB2606-B59875",
    "KXBTC-26FEB2606-B60125",
    "KXBTC-26FEB2606-B60375"
  ],
  "pagination": {
    "offset": 0,
    "limit": 5,
    "total_count": 5,
    "has_more": false
  }
}
```