Python SDK

pip install trymithril

from trymithril import Mithril

m = Mithril()  # reads MITHRIL_API_KEY (or pass api_key=...)

sub = m.subaccounts.list()[0]
market = m.markets.search("world cup", limit=1)[0]
ob = m.markets.orderbook(market.id)

order = m.orders.create(
    subaccount_id=sub.id,
    market_id=market.id,
    token_id=ob.token_id,
    action="buy",
    quantity="5",
    price="0.40",
)
print(order.id, order.status)

order.status                  # typed attribute
preview.impact.fillable_qty   # nested models
order.model_dump()            # plain dict when you need one

for fill in m.fills.iterate():
    print(fill.price, fill.quantity)

from trymithril import RiskLimitExceeded

try:
    m.orders.create(...)
except RiskLimitExceeded as e:
    # a guardrail protected you — the order never reached the venue
    print(e.code, e.message)

m.orders.create(..., idempotency_key="my-strategy-signal-42")

Mithril(
    api_key="mk_live_...",                  # or MITHRIL_API_KEY
    base_url="https://api.trymithril.com",  # or MITHRIL_BASE_URL
    timeout=15.0,
    max_retries=2,
)