Skip to content

multivariate.md

Latest commit

 

History

History
85 lines (67 loc) · 2.85 KB

multivariate.md

File metadata and controls

85 lines (67 loc) · 2.85 KB
Raw

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.

!!! warning "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.

!!! danger "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.

!!! danger "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 options: heading_level: 3

::: kalshi.resources.multivariate.AsyncMultivariateCollectionsResource options: heading_level: 3