Synpath
Account

Fills

Your executions as they happen, with the fee, and on Polymarket their settlement state.

WSSawait stream.watch_my_trades(market_ids=None)SDK stream · your process · venue credentials

Self-hosted. Opened from your own process straight to the venue. Nothing here runs on Synpath's servers.

Each event carries a Fill in the YES price. On Polymarket the same fill id arrives again as settlement moves from matched to confirmed or failed; act on confirmed.

Venues

VenueSupportNotes
PolymarketSupportedFills with settlement state.
KalshiSupported
Polymarket USSupportedFills arrive as executions on the order subscription.
OpinionSupportedOnce the chain confirms the match; a failed one arrives failed.
HyperliquidSupportedFinal when they arrive. Splits, merges and settlements arrive as venue events; the opening snapshot of recent fills is not replayed.
predict.funSupportedMatched first, then confirmed or failed on chain, under one settlement id.
LimitlessSupportedMatched first, then mined or failed on chain, under one id.
SX BetSupportedMatched first, then escrowed or failed on chain, under one id.

Parameters

NameTypeDescription
market_idslist[str] | NoneOnly these markets. Omit for every market.

FillEvent

One of your orders traded.

NameTypeDescription
venuestringWhich venue the event came from.
received_atintegerWhen this process received it, ms since epoch.
fillFillThe fill, as in the REST API. settlement is matched, confirmed or failed.
import asyncio
from synpath import PolymarketTrading, PolymarketAccountDataStream, load_credentials, require

trading = PolymarketTrading(require("polymarket", load_credentials()))
stream = PolymarketAccountDataStream(trading=trading)                 # derives the CLOB credentials

from synpath import FillEvent

async def main():
    async with stream:
        async with stream.events() as reader:
            await stream.watch_my_trades()
            async for event in reader:
                if isinstance(event, FillEvent) and event.fill.settlement == "confirmed":
                    print(event.fill.market_id, event.fill.side, event.fill.price, event.fill.amount)

asyncio.run(main())
FillEvent
{
  "venue": "polymarket",
  "received_at": 1790077592174,
  "fill": {
    "id": "TRADE_ID",
    "order_id": "0xorder",
    "market_id": "polymarket:2252244",
    "side": "buy",
    "price": "0.42",
    "amount": "4",
    "fee": null,
    "liquidity": "taker",
    "settlement": "matched",
    "timestamp": 1789655011496,
    "…": "the full Fill"
  }
}