Quickstart

pip install rivermarkets

from datetime import datetime
from rivermarkets import RiverMarkets

client = RiverMarkets(
    key_id="<uuid from Settings → API Keys>",
    private_key="<base64 private key shown once at creation>",
)

# Search for shutdown related markets on Kalshi.
# Filter to active markets that haven't expired yet so the results are tradeable —
# apply both `status=active` and `expiration_date_start` (now) for any exchange.
results = client.markets.search_markets(
    q="shutdown",
    exchange_name="KALSHI",
    expiration_date_start=datetime.now(),
    status="active",
)
for market in results.results:
    print(f"River ID: {market.river_id}, Ticker: {market.ticker}")

subaccount = client.subaccounts.create_subaccount(name="My Trading Account")
subaccount_id = subaccount.subaccount_id

order = client.orders.create_order(
    subaccount_id=subaccount_id,
    river_id=4552150,       # From market search
    order_type="LIMIT",      # LIMIT or MARKET
    time_in_force="GTC",     # FOK, GTC, GTD, or IOC
    buy_flag=True,           # True=buy, False=sell
    price=0.50,              # Limit price (0-1)
    qty=10,                  # Number of contracts
)
print(f"Order placed: {order.river_order_id}")

order_status = client.orders.get_order(order_id=order.river_order_id)
print(f"Status: {order_status.status}, Filled: {order_status.traded_qty}/{order_status.qty}")

result = client.orders.cancel_order(order_id=order.river_order_id)
print(result)