Multivariate event collections¶

A multivariate event collection is a template that lets you bet on combinations of outcomes — e.g. "Will it rain in NYC AND the Yankees win Saturday?" The collection holds the building-block markets; create_market with a list of leg selections mints a derived YES/NO contract.

Public listing, auth-required minting. Attribute name on the client: multivariate_collections.

Deprecated methods

create_market() is deprecated — "This endpoint predates RFQs and should not be used for new integrations." Calling it emits a DeprecationWarning. Use the Communications (RFQ/Quote) surface instead. list() / list_all() / get() remain supported.

Removed in 10.0.0

lookup_tickers() and the LookupTickersForMarketInMultivariateEventCollectionRequest / LookupTickersResponse models were removed — Kalshi deleted PUT /multivariate_event_collections/{ticker}/lookup from the OpenAPI spec, and the AsyncAPI multivariate / multivariate_lookup channel with it.

Removed in 6.0.0

lookup_history() and the LookupPoint model were removed — Kalshi deleted the backing GET /multivariate_event_collections/{ticker}/lookup endpoint from the spec in 3.23.0.

Quick reference¶

Method	Endpoint	Auth
`list(...)` / `list_all(...)`	`GET /multivariate_event_collections`	no
`get(collection_ticker)`	`GET /multivariate_event_collections/{ticker}`	no
`create_market(collection_ticker, *, selected_markets, with_market_payload=False)`	`POST /multivariate_event_collections/{ticker}`	yes

List collections¶

page = client.multivariate_collections.list(
    status="open",                  # MultivariateCollectionStatusLiteral
    series_ticker="KXWEATHER",
    limit=100,
)
for c in page:
    print(c.collection_ticker, c.title, c.exchange_index)

Select legs¶

A leg is a TickerPair(event_ticker=..., market_ticker=...) — one event-side selection. To bet on "rain in NYC AND Yankees win":

from kalshi import TickerPair

legs = [
    TickerPair(event_ticker="KXNYRAIN-26", market_ticker="KXNYRAIN-26-YES"),
    TickerPair(event_ticker="KXYANKEES-26-SAT", market_ticker="KXYANKEES-26-SAT-WIN"),
]

Mint a combo market¶

resp = client.multivariate_collections.create_market(
    "KXWEATHER-SPORTS-COMBO",
    selected_markets=legs,
    with_market_payload=True,        # also return the full Market body
)
print(resp.market_ticker, resp.event_ticker)
if resp.market is not None:
    print(resp.market.yes_bid, resp.market.yes_ask)

Reference¶

kalshi.resources.multivariate.MultivariateCollectionsResource ¶

MultivariateCollectionsResource(transport: SyncTransport)

Bases: SyncResource

Sync multivariate event collections API.

kalshi.resources.multivariate.AsyncMultivariateCollectionsResource ¶

AsyncMultivariateCollectionsResource(
    transport: AsyncTransport,
)

Bases: AsyncResource

Async multivariate event collections API.