---
title: "Get Series List"
method: GET
path: "/series"
tags: ["market"]
---

# Get Series List

`GET /series`

## Request

- Base URL: `https://external-api.kalshi.com/trade-api/v2`
- URL: `https://external-api.kalshi.com/trade-api/v2/series`
- Auth: none declared

Endpoint for getting data about multiple series with specified filters.  A series represents a template for recurring events that follow the same format and rules (e.g., "Monthly Jobs Report", "Weekly Initial Jobless Claims", "Daily Weather in NYC"). This endpoint allows you to browse and discover available series templates by category.

## Query parameters

- `category` string
- `tags` string
- `include_product_metadata` boolean
- `include_volume` boolean
- `min_updated_ts` integer

## Response `200`

Series list retrieved successfully

- GetSeriesListResponse
  - `series` Series[], required
    - `ticker` string, required: Ticker that identifies this series.
    - `frequency` string, required: Description of the frequency of the series. There is no fixed value set here, but will be something human-readable like weekly, daily, one-off.
    - `title` string, required: Title describing the series. For full context use you should use this field with the title field of the events belonging to this series.
    - `category` string, required: Category is the primary category of this series.
    - `categories` string[], required: Categories is the list of discovery categories for this series. The `category` filter on Get Series List matches any entry in this list. May be empty.
    - `tags` string[], nullable, required: Tags specifies the subjects that this series relates to, multiple series from different categories can have the same tags.
    - `settlement_sources` SettlementSource[], nullable, required: SettlementSources specifies the official sources used for the determination of markets within the series. Methodology is defined in the rulebook.
      - `name` string: Name of the settlement source
      - `url` string: URL to the settlement source
    - `contract_url` string, required: ContractUrl provides a direct link to the original filing of the contract which underlies the series.
    - `contract_terms_url` string, required: ContractTermsUrl is the URL to the current terms of the contract underlying the series.
    - `product_metadata` object, nullable: Internal product metadata of the series.
    - `fee_type` 'quadratic' | 'quadratic_with_maker_fees' | 'quadratic_with_combo_maker_fees' | 'flat', required: Fee type for a series or scheduled fee override.
    - `fee_multiplier` number, double, required: FeeMultiplier is a floating point multiplier applied to the fee calculations.
    - `additional_prohibitions` string[], nullable, required: AdditionalProhibitions is a list of additional trading prohibitions for this series.
    - `volume_fp` string: Fixed-point contract count string (2 decimals, e.g., "10.00"; referred to as "fp" in field names). Requests accept 0-2 decimal places (e.g., "10", "10.0", "10.00"); responses always emit 2 decimals. Fractional contract values (e.g., "2.50") are supported; the minimum granularity is 0.01 contracts.
    - `last_updated_ts` string, date-time: Timestamp of when this series' metadata was last updated.
    - `exchange_index` integer: Identifier for an exchange shard.

## Other responses

- `400`: Bad request - invalid input
- `500`: Internal server error

## Changes

- **2026-09-11** `db7b5f46aeb4`: 1 info
  - added the required property `series/items/categories` to the response with the `200` status
- **2026-08-20** `f2e3ba6d8ce6`: 1 warning
  - added the new `quadratic_with_combo_maker_fees` enum value to the `series/items/fee_type/allOf[#/components/schemas/FeeType]/` response property for the response status `200`
- **2026-07-31** `a07481be8bf9`: 1 breaking, 2 warning, 1 info
  - the response property `series/items/additional_prohibitions` became nullable for the status `200`
  - removed the optional property `service` from the response with the `400` status
  - removed the optional property `service` from the response with the `500` status
  - added the optional property `series/items/exchange_index` to the response with the `200` status
- **2026-06-17** `5dacc8874900`: 3 breaking, 4 info
  - the response property `series/items/settlement_sources` became nullable for the status `200`
  - the response property `series/items/tags` became nullable for the status `200`
  - the `series/items/fee_type` response's property type changed from `string` to no type for status `200`
  - added `#/components/schemas/FeeType` to the `series/items/fee_type` response property `allOf` list for the response status `200`
  - …3 more
- **2026-04-13** `218c1f661cbd`: 1 warning
  - removed the optional property `series/items/volume` from the response with the `200` status

[Operation history](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/changes/series/get.md)

---

[API](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints.md) - [All operations](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/revisions/e6691cdd1915?raw)