aiokalshi provides a friendly interface into Kalshi's REST API (websocket support is in development). The library offers the benefits of asynchronous code, editor autocomplete, and parity with Kalshi's API while being easy to use and not requiring authentication.
uv add aiokalshipip install aiokalshiaiokalshi uses the same structure as Kalshi's documented RESTful API. Every query parameter available is provided in a typed fashion, meaning you get autocomplete when customizing your queries.
Every response includes all of the available data and makes use of Pydantic.
from httpx import AsyncClient
from aiokalshi import Kalshi
async def main():
async with AsyncClient(follow_redirects=True) as client:
# Make a client
kalshi = Kalshi(client)
# Get markets
# Convention: list for grabbing paginated things, get for grabbing one-off queries
markets = await kalshi.markets.list()
markets_one = await kalshi.markets.list(limit=1)
# Get one market
market = await kalshi.markets.get(markets_one.markets[0].ticker)
# Get the orderbook for a market
orderbook = await kalshi.markets.orderbook.get(market.ticker, depth=5)
# Get trades for a market
trades = await kalshi.markets.trades.list(market.ticker, limit=10)
# Get candlestick data for a market
candlesticks = await kalshi.markets.candlesticks.get(
series_ticker="SERIES-TICKER",
market_ticker=market.ticker,
start_ts=1700000000,
end_ts=1700086400,
period_interval=60 # 1 hour intervals
)
# Get events
events = await kalshi.events.list(status="open", limit=10)
# Get a specific event
event = await kalshi.events.get(events.events[0].event_ticker)
# Get event metadata
metadata = await kalshi.events.metadata.list(event.event.event_ticker)
# Get series by category
series_list = await kalshi.series.list(category="Science and Technology")
# Get a specific series
if series_list.series:
series = await kalshi.series.get(series_list.series[0].ticker)This project is under rapid development. Expect breaking changes.