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

# Get Multivariate Event Collections

>  Endpoint for getting data about multivariate event collections.



## OpenAPI

````yaml /openapi.yaml get /multivariate_event_collections
openapi: 3.0.0
info:
  title: Kalshi Trade API Manual Endpoints
  version: 3.34.0
  description: >-
    Manually defined OpenAPI spec for endpoints being migrated to spec-first
    approach
servers:
  - url: https://external-api.kalshi.com/trade-api/v2
    description: Production Trade API server
  - url: https://api.elections.kalshi.com/trade-api/v2
    description: Production shared API server, also supported
  - url: https://external-api.demo.kalshi.co/trade-api/v2
    description: Demo Trade API server
  - url: https://demo-api.kalshi.co/trade-api/v2
    description: Demo shared API server, also supported
security: []
tags:
  - name: api-keys
    description: API key management endpoints
  - name: orders
    description: Order management endpoints
  - name: order-groups
    description: Order group management endpoints
  - name: portfolio
    description: Portfolio and balance information endpoints
  - name: communications
    description: Request-for-quote (RFQ) endpoints
  - name: multivariate
    description: Multivariate event collection endpoints
  - name: exchange
    description: Exchange status and information endpoints
  - name: live-data
    description: Live data endpoints
  - name: markets
    description: Market data endpoints
  - name: milestone
    description: Milestone endpoints
  - name: search
    description: Search and filtering endpoints
  - name: incentive-programs
    description: Incentive program endpoints
  - name: fcm
    description: FCM member specific endpoints
  - name: events
    description: Event endpoints
  - name: structured-targets
    description: Structured targets endpoints
paths:
  /multivariate_event_collections:
    get:
      tags:
        - multivariate
      summary: Get Multivariate Event Collections
      description: ' Endpoint for getting data about multivariate event collections.'
      operationId: GetMultivariateEventCollections
      parameters:
        - name: status
          in: query
          description: >-
            Only return collections of a certain status. Can be unopened, open,
            or closed.
          schema:
            type: string
            enum:
              - unopened
              - open
              - closed
        - name: associated_event_ticker
          in: query
          description: Only return collections associated with a particular event ticker.
          schema:
            type: string
        - name: series_ticker
          in: query
          description: Only return collections with a particular series ticker.
          schema:
            type: string
        - name: limit
          in: query
          description: Specify the maximum number of results.
          schema:
            type: integer
            format: int32
            minimum: 1
            maximum: 200
        - name: cursor
          in: query
          description: >-
            The Cursor represents a pointer to the next page of records in the
            pagination. This optional parameter, when filled, should be filled
            with the cursor string returned in a previous request to this
            end-point.
          schema:
            type: string
      responses:
        '200':
          description: Collections retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetMultivariateEventCollectionsResponse'
        '400':
          $ref: '#/components/responses/BadRequestError'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    GetMultivariateEventCollectionsResponse:
      type: object
      required:
        - multivariate_contracts
      properties:
        multivariate_contracts:
          type: array
          items:
            $ref: '#/components/schemas/MultivariateEventCollection'
          description: List of multivariate event collections.
        cursor:
          type: string
          description: >-
            The Cursor represents a pointer to the next page of records in the
            pagination. Use the value returned here in the cursor query
            parameter for this end-point to get the next page containing limit
            records. An empty value of this field indicates there is no next
            page.
          x-go-type-skip-optional-pointer: true
    MultivariateEventCollection:
      type: object
      required:
        - collection_ticker
        - series_ticker
        - title
        - description
        - open_date
        - close_date
        - associated_events
        - associated_event_tickers
        - is_ordered
        - is_single_market_per_event
        - is_all_yes
        - size_min
        - size_max
        - functional_description
        - price_level_structure
        - price_ranges
      properties:
        collection_ticker:
          type: string
          description: Unique identifier for the collection.
        series_ticker:
          type: string
          description: >-
            Series associated with the collection. Events produced in the
            collection will be associated with this series.
        exchange_index:
          allOf:
            - $ref: '#/components/schemas/ExchangeIndex'
          description: Exchange index inherited from the collection's series.
          x-go-type-skip-optional-pointer: true
          x-omitempty: false
        title:
          type: string
          description: Title of the collection.
        description:
          type: string
          description: Short description of the collection.
        open_date:
          type: string
          format: date-time
          description: >-
            The open date of the collection. Before this time, the collection
            cannot be interacted with.
        close_date:
          type: string
          format: date-time
          description: >-
            The close date of the collection. After this time, the collection
            cannot be interacted with.
        associated_events:
          type: array
          items:
            $ref: '#/components/schemas/AssociatedEvent'
          description: List of events with their individual configuration.
        associated_event_tickers:
          type: array
          items:
            type: string
          description: >-
            [DEPRECATED - Use associated_events instead] A list of events
            associated with the collection. Markets in these events can be
            passed as inputs to the Lookup and Create endpoints.
        is_ordered:
          type: boolean
          description: >-
            Whether the collection is ordered. If true, the order of markets
            passed into Lookup/Create affects the output. If false, the order
            does not matter.
        is_single_market_per_event:
          type: boolean
          description: >-
            [DEPRECATED - Use associated_events instead] Whether the collection
            accepts multiple markets from the same event passed into
            Lookup/Create.
        is_all_yes:
          type: boolean
          description: >-
            [DEPRECATED - Use associated_events instead] Whether the collection
            requires that only the market side of 'yes' may be used.
        size_min:
          type: integer
          format: int32
          description: >-
            The minimum number of markets that must be passed into Lookup/Create
            (inclusive).
        size_max:
          type: integer
          format: int32
          description: >-
            The maximum number of markets that must be passed into Lookup/Create
            (inclusive).
        functional_description:
          type: string
          description: >-
            A functional description of the collection describing how inputs
            affect the output.
        price_level_structure:
          type: string
          description: >-
            Price level structure used for new markets created in this
            collection. Existing markets may differ; use the market's
            price_level_structure and price_ranges for its current pricing.
        price_ranges:
          type: array
          description: >-
            Price bands and tick sizes in fixed-point dollars for new markets
            created in this collection. Use these ranges to determine valid
            prices rather than hardcoding the structure name.
          items:
            $ref: '#/components/schemas/PriceRange'
    ErrorResponse:
      type: object
      properties:
        code:
          type: string
          description: Error code
        message:
          type: string
          description: Human-readable error message
        details:
          type: string
          description: Additional details about the error, if available
    ExchangeIndex:
      type: integer
      description: Identifier for an exchange shard.
      example: 0
    AssociatedEvent:
      type: object
      required:
        - ticker
        - is_yes_only
        - active_quoters
      properties:
        ticker:
          type: string
          description: The event ticker.
        is_yes_only:
          type: boolean
          description: Whether only the 'yes' side can be used for this event.
        size_max:
          type: integer
          format: int32
          nullable: true
          description: >-
            Maximum number of markets from this event (inclusive). Null means no
            limit.
        size_min:
          type: integer
          format: int32
          nullable: true
          description: >-
            Minimum number of markets from this event (inclusive). Null means no
            limit.
        active_quoters:
          type: array
          items:
            type: string
          description: List of active quoters for this event.
    PriceRange:
      type: object
      required:
        - start
        - end
        - step
      properties:
        start:
          type: string
          description: Starting price for this range in dollars
        end:
          type: string
          description: Ending price for this range in dollars
        step:
          type: string
          description: Price step/tick size for this range in dollars
  responses:
    BadRequestError:
      description: Bad request - invalid input
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    InternalServerError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.