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.

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
`lookup_tickers(collection_ticker, *, selected_markets)`	`PUT /multivariate_event_collections/{ticker}/lookup`	no
`lookup_history(collection_ticker, *, lookback_seconds)`	`GET /multivariate_event_collections/{ticker}/lookup_history`	no

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)

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"),
]

Lookup the auto-generated ticker (no mint)¶

resp = client.multivariate_collections.lookup_tickers(
    "KXWEATHER-SPORTS-COMBO",
    selected_markets=legs,
)
print(resp.market_ticker, resp.event_ticker)

Wire-level note: this endpoint is a PUT — unusual for a read operation, but matches the OpenAPI spec.

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)

Recent lookup history¶

hist = client.multivariate_collections.lookup_history(
    "KXWEATHER-SPORTS-COMBO",
    lookback_seconds=3600,
)
for entry in hist.lookups:
    print(entry.market_ticker, entry.created_ts)

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.