---
title: "Create Market In Multivariate Event Collection"
method: POST
path: "/multivariate_event_collections/{collection_ticker}"
tags: ["multivariate"]
---

# Create Market In Multivariate Event Collection

`POST /multivariate_event_collections/{collection_ticker}`

## Request

- Base URL: `https://external-api.kalshi.com/trade-api/v2`
- URL: `https://external-api.kalshi.com/trade-api/v2/multivariate_event_collections/{collection_ticker}`
- Auth: API key in header `KALSHI-ACCESS-KEY` and API key in header `KALSHI-ACCESS-SIGNATURE` and API key in header `KALSHI-ACCESS-TIMESTAMP`

Endpoint for creating an individual market in a multivariate event collection. This endpoint must be hit at least once before trading or looking up a market. Users are limited to 5000 creations per week.

## Path parameters

- `collection_ticker` string, required

## Request body

- CreateMarketInMultivariateEventCollectionRequest
  - `selected_markets` TickerPair[], required: List of selected markets that act as parameters to determine which market is created.
    - `market_ticker` string, required: Market ticker identifier.
    - `event_ticker` string, required: Event ticker identifier.
    - `side` 'yes' | 'no', required: Side of the market (yes or no).
  - `with_market_payload` boolean: Whether to include the market payload in the response.

## Response `200`

Market created successfully

- CreateMarketInMultivariateEventCollectionResponse
  - `event_ticker` string, required: Event ticker for the created market.
  - `market_ticker` string, required: Market ticker for the created market.
  - `market` Market
    - `ticker` string, required
    - `event_ticker` string, required
    - `market_type` 'binary' | 'scalar', required: Identifies the type of market
    - `title` string
    - `subtitle` string
    - `yes_sub_title` string, required: Shortened title for the yes side of this market
    - `no_sub_title` string, required: Deprecated. Use `yes_sub_title` instead. Equal to `yes_sub_title` on every market created since September 2024.
    - `created_time` string, date-time, required
    - `updated_time` string, date-time, required: Time of the last non-trading metadata update.
    - `open_time` string, date-time, required
    - `close_time` string, date-time, required
    - `expected_expiration_time` string, date-time, nullable: Time when this market is expected to expire
    - `expiration_time` string, date-time
    - `latest_expiration_time` string, date-time, required: Latest possible time for this market to expire
    - `settlement_timer_seconds` integer, required: The amount of time after determination that the market settles
    - `status` 'initialized' | 'inactive' | 'active' | 'closed' | 'determined' | 'disputed' | 'amended' | 'finalized', required: The current status of the market in its lifecycle.
    - `yes_bid_dollars` string, required: Fixed-point US dollar string. Most request fields accept 2-4 decimal places (e.g., "0.56", "0.5600"); responses emit up to 6. Valid quote intervals for a given market are constrained by that market's price level structure.
    - `yes_bid_size_fp` string, required: 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.
    - `yes_ask_dollars` string, required: Fixed-point US dollar string. Most request fields accept 2-4 decimal places (e.g., "0.56", "0.5600"); responses emit up to 6. Valid quote intervals for a given market are constrained by that market's price level structure.
    - `yes_ask_size_fp` string, required: 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.
    - `no_bid_dollars` string, required: Fixed-point US dollar string. Most request fields accept 2-4 decimal places (e.g., "0.56", "0.5600"); responses emit up to 6. Valid quote intervals for a given market are constrained by that market's price level structure.
    - `no_ask_dollars` string, required: Fixed-point US dollar string. Most request fields accept 2-4 decimal places (e.g., "0.56", "0.5600"); responses emit up to 6. Valid quote intervals for a given market are constrained by that market's price level structure.
    - `last_price_dollars` string, required: Fixed-point US dollar string. Most request fields accept 2-4 decimal places (e.g., "0.56", "0.5600"); responses emit up to 6. Valid quote intervals for a given market are constrained by that market's price level structure.
    - `volume_fp` string, required: 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.
    - `volume_24h_fp` string, required: 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.
    - `result` 'yes' | 'no' | 'scalar' | '', required
    - `can_close_early` boolean, required
    - `open_interest_fp` string, required: 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.
    - `notional_value_dollars` string, required: Fixed-point US dollar string. Most request fields accept 2-4 decimal places (e.g., "0.56", "0.5600"); responses emit up to 6. Valid quote intervals for a given market are constrained by that market's price level structure.
    - `previous_yes_bid_dollars` string, required: Fixed-point US dollar string. Most request fields accept 2-4 decimal places (e.g., "0.56", "0.5600"); responses emit up to 6. Valid quote intervals for a given market are constrained by that market's price level structure.
    - `previous_yes_ask_dollars` string, required: Fixed-point US dollar string. Most request fields accept 2-4 decimal places (e.g., "0.56", "0.5600"); responses emit up to 6. Valid quote intervals for a given market are constrained by that market's price level structure.
    - `previous_price_dollars` string, required: Fixed-point US dollar string. Most request fields accept 2-4 decimal places (e.g., "0.56", "0.5600"); responses emit up to 6. Valid quote intervals for a given market are constrained by that market's price level structure.
    - `settlement_value_dollars` string: Fixed-point US dollar string. Most request fields accept 2-4 decimal places (e.g., "0.56", "0.5600"); responses emit up to 6. Valid quote intervals for a given market are constrained by that market's price level structure.
    - `settlement_ts` string, date-time, nullable: Timestamp when the market was settled. Only filled for settled markets
    - `settlement_bounds_type` 'default' | 'floor', required: Which settlement bounds apply to this market. default means the market has no settlement bounds
    - `settlement_floor_dollars` string: Fixed-point US dollar string. Most request fields accept 2-4 decimal places (e.g., "0.56", "0.5600"); responses emit up to 6. Valid quote intervals for a given market are constrained by that market's price level structure.
    - `expiration_value` string, required: The value that was considered for the settlement
    - `occurrence_datetime` string, date-time, nullable: The recorded datetime when the underlying event occurred, if available
    - `fee_waiver_expiration_time` string, date-time, nullable: Time when this market's fee waiver expires
    - `early_close_condition` string, nullable: The condition under which the market can close early
    - `strike_type` 'greater' | 'greater_or_equal' | 'less' | 'less_or_equal' | 'between' | 'functional' | 'custom' | 'structured': Strike type defines how the market strike is defined and evaluated
    - `floor_strike` number, double, nullable: Minimum expiration value that leads to a YES settlement
    - `cap_strike` number, double, nullable: Maximum expiration value that leads to a YES settlement
    - `functional_strike` string, nullable: Mapping from expiration values to settlement values
    - `custom_strike` object, nullable: Expiration value for each target that leads to a YES settlement
    - `rules_primary` string, required: A plain language description of the most important market terms
    - `rules_secondary` string, required: A plain language description of secondary market terms
    - `mve_collection_ticker` string: The ticker of the multivariate event collection
    - `mve_selected_legs` MveSelectedLeg[]
      - `event_ticker` string: Unique identifier for the selected event
      - `market_ticker` string: Unique identifier for the selected market
      - `side` string: The side of the selected market
      - `yes_settlement_value_dollars` string: Fixed-point US dollar string. Most request fields accept 2-4 decimal places (e.g., "0.56", "0.5600"); responses emit up to 6. Valid quote intervals for a given market are constrained by that market's price level structure.
    - `primary_participant_key` string, nullable
    - `price_level_structure` string, required: Price level structure for this market, defining price ranges and tick sizes
    - `price_ranges` PriceRange[], required: Valid price ranges for orders on this market
      - `start` string, required: Starting price for this range in dollars
      - `end` string, required: Ending price for this range in dollars
      - `step` string, required: Price step/tick size for this range in dollars
    - `is_provisional` boolean: If true, the market may be removed after determination if there is no activity on it
    - `exchange_index` integer: Identifier for an exchange shard.

## Other responses

- `400`: Bad request - invalid input
- `401`: Unauthorized - authentication required
- `429`: Rate limit exceeded. The default cost is 10 tokens per request. Use GET /trade-api/v2/account/endpoint_costs to list non-default endpoint costs.
- `500`: Internal server error

## Changes

- **2026-11-02** `e6691cdd1915`: 1 info
  - response property `market/no_sub_title` deprecated
- **2026-09-29** `dde105932d49`: 2 info
  - added the optional property `market/settlement_floor_dollars` to the response with the `200` status
  - added the required property `market/settlement_bounds_type` to the response with the `200` status
- **2026-09-25** `7a870e939ec6`: 1 warning
  - removed the optional property `market/liquidity_dollars` from the response with the `200` status
- **2026-07-31** `a07481be8bf9`: 4 warning
  - removed the optional property `service` from the response with the `400` status
  - removed the optional property `service` from the response with the `401` status
  - removed the optional property `service` from the response with the `429` status
  - removed the optional property `service` from the response with the `500` status
- **2026-07-13** `a671b3e77f35`: 3 breaking, 1 warning, 1 info
  - the response property `market/liquidity_dollars` became optional for the status `200`
  - the `market/liquidity_dollars` response's property type changed from `string` to no type for status `200`
  - removed the required property `market/fractional_trading_enabled` from the response with the `200` status
  - removed the optional property `market/response_price_units` from the response with the `200` status
  - …1 more

[Operation history](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/changes/multivariate_event_collections/:collection_ticker/post.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)