FCM¶

Futures Commission Merchant routes. FCM-member accounts only — non-FCM calls come back 401/403. Auth required throughout.

subtrader_id is the required discriminator on every call — every FCM request scopes to one subtrader under your member account.

Quick reference¶

Method	Endpoint
`orders(*, subtrader_id, ...)`	`GET /fcm/orders`
`orders_all(*, subtrader_id, ...)`	walks `orders`
`positions(*, subtrader_id, ...)`	`GET /fcm/positions`

List orders¶

page = client.fcm.orders(
    subtrader_id="st_alpha",
    ticker="KXPRES-24-DJT",
    event_ticker="KXPRES-24",
    status="resting",              # OrderStatusLiteral
    min_ts=1_700_000_000,
    max_ts=1_800_000_000,
    limit=200,
)
for o in page:
    print(o.order_id, o.status, o.remaining_count)

for o in client.fcm.orders_all(subtrader_id="st_alpha", status="resting"):
    ...

Same Order model as Orders. Standard Page[Order] pagination on orders().

Positions¶

resp = client.fcm.positions(
    subtrader_id="st_alpha",
    event_ticker="KXPRES-24",
    count_filter="position",
    settlement_status="unsettled",     # SettlementStatusLiteral
    limit=200,
)
for mp in resp.market_positions:
    print(mp.ticker, mp.position)

positions() returns a PositionsResponse (same shape as portfolio.positions), not a Page. There is no positions_all() helper — walk it manually if you need cursor traversal.

settlement_status is the FCM-specific kwarg that does not exist on portfolio.positions().

Reference¶

kalshi.resources.fcm.FcmResource ¶

FcmResource(transport: SyncTransport)

Bases: SyncResource

Sync FCM API — orders and positions filtered by subtrader_id.

kalshi.resources.fcm.AsyncFcmResource ¶

AsyncFcmResource(transport: AsyncTransport)

Bases: AsyncResource

Async FCM API.

orders_all ¶

orders_all(
    *,
    subtrader_id: str,
    ticker: str | None = None,
    event_ticker: str | None = None,
    status: OrderStatusLiteral | None = None,
    min_ts: int | None = None,
    max_ts: int | None = None,
    limit: int | None = None,
    max_pages: int | None = None
) -> AsyncIterator[Order]

Returns an async iterator — use async for.