pmquant 0.1.0__tar.gz → 0.2.0__tar.gz

pmquant-0.2.0/.github/workflows/canary.yml

@@ -0,0 +1,34 @@
+name: canary
+on:
+  schedule:
+    - cron: "17 6 * * 1"        # weekly, monday 06:17 UTC
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  issues: write
+
+jobs:
+  canary:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install -e ".[dev]"
+      - name: Live canary against real Polymarket endpoints
+        env:
+          PMQ_CANARY: "1"
+        run: pytest tests/test_canary_live.py -q
+      - name: Open an issue if Polymarket drifted
+        if: failure()
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          existing=$(gh issue list --label canary --state open --json number --jq length)
+          if [ "$existing" = "0" ]; then
+            gh issue create --label canary \
+              --title "Canary: Polymarket surface drifted ($(date -u +%F))" \
+              --body "The weekly live canary failed: an endpoint shape or the installed py-clob-client-v2 surface no longer matches what pmq was verified against. See the failed run: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}"
+          fi

{pmquant-0.1.0 → pmquant-0.2.0}/.github/workflows/test.yml

@@ -14,4 +14,5 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
       - run: pip install -e ".[dev]"
+      - run: ruff check .
       - run: pytest -q

{pmquant-0.1.0 → pmquant-0.2.0}/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.2.0 (2026-07-03)
+
+* New: `positions(user)` and `event_markets(slug)` in the data layer; `event`
+  tool in the MCP server; `fee_rate(condition_id)` (authoritative per-market
+  taker rate from the exchange) and `cancel_order(order_id)` on the executor.
+* Trust: weekly live canary workflow (real-endpoint checks, auto-opens an
+  issue on drift), SECURITY.md, production receipt in the README,
+  docs/rounding-study.md (measured V2 rounding behavior).
+* Quality: ruff in CI, tests for the bot-template engine (34 tests total).
+
 ## 0.1.0 (2026-07-03)
 
 First release.

{pmquant-0.1.0 → pmquant-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pmquant
-Version: 0.1.0
+Version: 0.2.0
 Summary: Fail-closed execution and market-data layer for Polymarket CLOB V2: local signing, confirmed fills only, fee-correct math, working deposit-wallet (POLY_1271) support.
 Project-URL: Homepage, https://github.com/crp4222/pmq
 Project-URL: Issues, https://github.com/crp4222/pmq/issues
@@ -19,12 +19,18 @@ Requires-Dist: py-clob-client-v2<2,>=1.0.2
 Provides-Extra: dev
 Requires-Dist: mcp>=1.2; extra == 'dev'
 Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
 Provides-Extra: mcp
 Requires-Dist: mcp>=1.2; extra == 'mcp'
 Description-Content-Type: text/markdown
 
 # pmq
 
+[![PyPI](https://img.shields.io/pypi/v/pmquant)](https://pypi.org/project/pmquant/)
+[![tests](https://github.com/crp4222/pmq/actions/workflows/test.yml/badge.svg)](https://github.com/crp4222/pmq/actions/workflows/test.yml)
+[![canary](https://github.com/crp4222/pmq/actions/workflows/canary.yml/badge.svg)](https://github.com/crp4222/pmq/actions/workflows/canary.yml)
+[![license](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+
 Fail-closed execution and market data for **Polymarket CLOB V2**, in Python.
 Local signing (your keys never leave your process), exchange-confirmed fills
 only, fee-correct math, and deposit-wallet (`POLY_1271`) support that actually
@@ -63,6 +69,17 @@ a real error in live trading:
 
 The full write-up with reproduction details: [docs/war-story.md](docs/war-story.md).
 
+## Runs in production
+
+The maintainer's own bot trades through this exact executor 24/7 with real
+money. Example receipt (2026-07-03): settlement transaction
+[`0x387f5f09...100d88a8`](https://polygonscan.com/tx/0x387f5f09c031bb36a71c54adc978b1ed4d50c67f6dd3f0c2c8068391100d88a8)
+on the CTF Exchange V2: a FAK market buy built by this library, matched and
+settled, with the builder code visible in the calldata. Additionally, a weekly
+[canary workflow](.github/workflows/canary.yml) exercises the real endpoints
+and the installed client surface, and opens an issue by itself if Polymarket
+drifts.
+
 ## The contract: nothing is booked without exchange confirmation
 
 | Situation | What pmq does |

{pmquant-0.1.0 → pmquant-0.2.0}/README.md

@@ -1,5 +1,10 @@
 # pmq
 
+[![PyPI](https://img.shields.io/pypi/v/pmquant)](https://pypi.org/project/pmquant/)
+[![tests](https://github.com/crp4222/pmq/actions/workflows/test.yml/badge.svg)](https://github.com/crp4222/pmq/actions/workflows/test.yml)
+[![canary](https://github.com/crp4222/pmq/actions/workflows/canary.yml/badge.svg)](https://github.com/crp4222/pmq/actions/workflows/canary.yml)
+[![license](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+
 Fail-closed execution and market data for **Polymarket CLOB V2**, in Python.
 Local signing (your keys never leave your process), exchange-confirmed fills
 only, fee-correct math, and deposit-wallet (`POLY_1271`) support that actually
@@ -38,6 +43,17 @@ a real error in live trading:
 
 The full write-up with reproduction details: [docs/war-story.md](docs/war-story.md).
 
+## Runs in production
+
+The maintainer's own bot trades through this exact executor 24/7 with real
+money. Example receipt (2026-07-03): settlement transaction
+[`0x387f5f09...100d88a8`](https://polygonscan.com/tx/0x387f5f09c031bb36a71c54adc978b1ed4d50c67f6dd3f0c2c8068391100d88a8)
+on the CTF Exchange V2: a FAK market buy built by this library, matched and
+settled, with the builder code visible in the calldata. Additionally, a weekly
+[canary workflow](.github/workflows/canary.yml) exercises the real endpoints
+and the installed client surface, and opens an issue by itself if Polymarket
+drifts.
+
 ## The contract: nothing is booked without exchange confirmation
 
 | Situation | What pmq does |

pmquant-0.2.0/SECURITY.md

@@ -0,0 +1,29 @@
+# Security
+
+## Posture
+
+* Your private key is read from the environment, used to instantiate the
+  local signer, and never logged, transmitted or stored by pmq. There is no
+  backend, no telemetry, no custody. The only hosts contacted are Polymarket
+  endpoints (clob/gamma/data-api) and, for the on-chain debug helpers you run
+  yourself, the RPC you choose.
+* The builder code embedded by default is attribution metadata inside the
+  signed order (public on-chain either way). It carries 0/0 commission and is
+  disabled with `builder_code=None`. It cannot access funds.
+* The executor refuses to trade if the installed py-clob-client-v2 no longer
+  matches the API surface pmq was verified against (introspection at startup),
+  rather than signing through changed semantics.
+
+## Reading the source before trusting it
+
+A documented wave of fake "polymarket bot" repositories steals private keys.
+pmq is deliberately small (five modules) so you can audit the entire execution
+path in minutes. Grep targets that settle the important questions fast:
+`POLY_PRIVATE_KEY` (read once, passed to the official client), `builder_code`
+(the disclosure and the opt-out), `http` (every host contacted).
+
+## Reporting a vulnerability
+
+Open a GitHub security advisory on this repository (Security tab, "Report a
+vulnerability") or an issue with the `security` label if it is not sensitive.
+You will get an answer within a few days.

{pmquant-0.1.0 → pmquant-0.2.0}/bot-template/bot.py

@@ -86,6 +86,39 @@ def write_halt_flag(utc_day, pnl):
         log(f"halt flag write failed ({e}); halt still enforced in-process")
 
 
+def recover_orphans(tracked):
+    """Markets that got a fill but no scoring row (a restart between fill and
+    resolution wipes in-memory state) are rebuilt so the scoring loop settles
+    them. Live scoring re-pulls exchange truth, so numbers cannot drift."""
+    try:
+        scored = set()
+        if os.path.exists(WINDOWS_CSV):
+            for r in csv.DictReader(open(WINDOWS_CSV)):
+                scored.add((r["family"], r["mode"]))
+        if not os.path.exists(FILLS_CSV):
+            return
+        now, orphans = time.time(), {}
+        for r in csv.DictReader(open(FILLS_CSV)):
+            if r["mode"] != MODE or (r["family"], MODE) in scored:
+                continue
+            o = orphans.setdefault(r["family"], {"side": r["side"], "fills": []})
+            o["fills"].append((float(r["price"]), float(r["shares"])))
+        for slug, o in orphans.items():
+            pm = pmq.parse_market(pmq.get_market(slug, log))
+            if not pm:
+                log(f"orphan {slug}: market unresolvable, skipped")
+                continue
+            spent = sum(p * s for p, s in o["fills"])
+            fees = sum(pmq.fee(p, s, FEE_RATE) for p, s in o["fills"])
+            tracked[slug] = {"pm": pm, "first_seen": now - MAX_TRACK_H * 1800,
+                             "fills": o["fills"], "spent": spent, "fees": fees,
+                             "side": o["side"], "winner": None, "src": "",
+                             "resolved": False, "poisoned": False, "sstate": {}}
+            log(f"orphan recovered: {slug} ({len(o['fills'])} fill(s)), will be scored")
+    except Exception as e:
+        log(f"orphan recovery failed (continuing without): {e}")
+
+
 def main(run_hours):
     t_end = time.time() + run_hours * 3600
     ex = None
@@ -109,6 +142,7 @@ def main(run_hours):
         f"daily_halt={DAILY_HALT_USD}$ strategy={strategy.NAME}")
 
     tracked, day_pnl, halted_day = {}, {}, None
+    recover_orphans(tracked)
     last_score_poll = 0.0
 
     while time.time() < t_end:
@@ -251,6 +285,12 @@ def main(run_hours):
                     log(f"{slug}: SCORED {st['side']} net={net:+.2f}$ "
                         f"winner={winner} day={day_pnl[d]:+.2f}$")
                     st["resolved"] = True
+                    if ex:
+                        # republish the CLOB-visible balance so the dashboard
+                        # tracks exchange truth without ever holding keys
+                        c = ex.collateral()
+                        if c > 0:
+                            log(f"collateral {c:.2f} USDC")
 
         except SystemExit:
             raise

{pmquant-0.1.0 → pmquant-0.2.0}/bot-template/dash/bot_dash.py

@@ -94,7 +94,8 @@ def service_state():
                  "-n", "1500", "--no-pager", "-q"])
     lines = jout.splitlines()
     for line in reversed(lines):
-        if "live executor ready" in line and "collateral" in line:
+        # matches both the startup line and the per-scoring republication
+        if "collateral" in line:
             try:
                 collateral = float(line.split("collateral", 1)[1].split()[0])
                 collateral_ts = float(line.split(" ", 1)[0])

{pmquant-0.1.0 → pmquant-0.2.0}/bot-template/dash/dash.html

@@ -97,7 +97,7 @@ footer .stale{color:var(--warn);font-weight:600}
   </div>
 
   <div class="tiles">
-    <div class="tile"><div class="lbl">Balance estimée</div><div class="val" id="tBal">…</div><div class="hint" id="tBalH"></div></div>
+    <div class="tile"><div class="lbl">Balance</div><div class="val" id="tBal">…</div><div class="hint" id="tBalH"></div></div>
     <div class="tile"><div class="lbl">Win rate</div><div class="val" id="tWr">…</div><div class="hint" id="tWrH"></div></div>
     <div class="tile"><div class="lbl">PnL période</div><div class="val" id="tPnl">…</div><div class="hint" id="tPnlH"></div></div>
     <div class="tile"><div class="lbl">Frais payés</div><div class="val" id="tFee">…</div><div class="hint" id="tFeeH"></div></div>
@@ -186,7 +186,9 @@ function renderTiles(){
     const extra = d.windows.filter(w => w.mode === "live" && (w.scored_ts||0) > (s.collateral_ts||0))
                            .reduce((a,w) => a + (w.net_pnl||0), 0);
     $("tBal").textContent = "~" + (s.collateral + extra).toFixed(2) + "$";
-    $("tBalH").textContent = "collatéral vu au démarrage " + (extra ? "+ scoré depuis" : "");
+    $("tBalH").textContent = "vue exchange, maj il y a "
+      + (s.collateral_ts ? ago(d.now - s.collateral_ts) : "?")
+      + (extra ? " + scoré depuis" : "");
   } else { $("tBal").textContent = "?"; $("tBalH").textContent = "visible en mode live"; }
   $("tWr").textContent = rows.length ? Math.round(100*wins/rows.length) + "%" : "…";
   $("tWrH").textContent = rows.length ? wins + "W/" + (rows.length-wins) + "L · " + state.mode + " " + per : "aucune fenêtre";

pmquant-0.2.0/docs/rounding-study.md

@@ -0,0 +1,45 @@
+# CLOB V2 order rounding, measured
+
+*Controlled experiment against production, 2026-07-03, py-clob-client-v2
+1.0.2, total risk budget 10 USD (net result of the run: +0.39). Raw data
+posted on the client's issues
+[#89](https://github.com/Polymarket/py-clob-client-v2/issues/89#issuecomment-4875871905)
+and [#66](https://github.com/Polymarket/py-clob-client-v2/issues/66#issuecomment-4875871996).*
+
+## Method
+
+Phase A: resting GTC bids far below the touch (cannot fill, cancelled after
+each case, zero cost), submitted with adversarial sizes and prices, then read
+back through `get_open_orders` to see what the server actually recorded.
+Phase B: two marketable limit buys on a liquid market to observe matched
+amounts against requested size, cross-checked with `get_trades`.
+
+## Results
+
+| Case | Requested | Server-side view |
+|---|---|---|
+| Baseline 2-decimal size | 5.25 @ 0.05 | 5.25, exact |
+| 4-decimal size | 5.2537 | **5.25, silently rounded down** |
+| Float drift | 5.100000000000001 | 5.1, normalized |
+| Price finer than tick | 0.0515 (tick 0.01) | **0.05, silently rounded down** |
+| Sub-cent notional | 5.007 @ 0.03 | accepted, size recorded as 5.00 |
+| Below minimum size | size 4 (min 5) | HTTP 400: `Size (4) lower than the minimum: 5` |
+| Marketable fill, odd size | 5.1234 @ 0.96 | signed as 5.12; matched **exactly 5.12** shares for 4.9152 USDC (0.96 x 5.12 to the cent) |
+| Marketable fill, control | 5.0 @ 0.96 | matched exactly 5.00 for 4.80 USDC |
+
+## What this means
+
+1. On 1.0.2, every input is normalized CLIENT-side (rounded DOWN to the
+   allowed decimals per the tick's RoundConfig) before signing. Float-drift
+   artifacts never reach the wire.
+2. The normalization is **silent**. If your own accounting keeps the
+   unrounded size or price, it diverges from what the exchange signed. Book
+   from the response's matched amounts (what pmq's `Fill` does), never from
+   your request.
+3. Limit-path fills never exceeded the signed size in these tests. The
+   overfill reports (filled 5.051 on a size-5 order) are consistent with the
+   MARKET-order path instead, where the contract is "spend this amount" and
+   the share count is the division remainder of amount by price.
+4. The per-market minimum size is enforced server-side with a clean 400, and
+   is readable in advance from the book response (`min_order_size`, exposed
+   by `pmq.book_meta`).

{pmquant-0.1.0 → pmquant-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pmquant"
-version = "0.1.0"
+version = "0.2.0"
 description = "Fail-closed execution and market-data layer for Polymarket CLOB V2: local signing, confirmed fills only, fee-correct math, working deposit-wallet (POLY_1271) support."
 readme = "README.md"
 license = { text = "MIT" }
@@ -31,10 +31,18 @@ Issues = "https://github.com/crp4222/pmq/issues"
 
 [project.optional-dependencies]
 mcp = ["mcp>=1.2"]
-dev = ["pytest>=8", "mcp>=1.2"]
+dev = ["pytest>=8", "mcp>=1.2", "ruff>=0.6"]
 
 [project.scripts]
 pmq-mcp = "pmq.mcp:main"
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/pmq"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I"]
+ignore = ["E501"]

{pmquant-0.1.0 → pmquant-0.2.0}/src/pmq/__init__.py

@@ -7,16 +7,29 @@ get_tape, fee, FEE_RATES.
 Execution layer (keys stay local, nothing booked without exchange
 confirmation): PolymarketExecutor, Fill, OrderUncertain.
 """
-from .data import (FEE_RATES, band_ask_depth_usd, best_bid_ask,
-                   book_inferred_winner, book_meta, fee, get_book, get_market,
-                   get_tape, http_get_json, parse_market, resolved_winner)
+from .data import (
+    FEE_RATES,
+    band_ask_depth_usd,
+    best_bid_ask,
+    book_inferred_winner,
+    book_meta,
+    event_markets,
+    fee,
+    get_book,
+    get_market,
+    get_tape,
+    http_get_json,
+    parse_market,
+    positions,
+    resolved_winner,
+)
 from .exceptions import IntrospectionMismatch, OrderUncertain, PmqError
 
-__version__ = "0.1.0"
+__version__ = "0.2.0"
 __all__ = [
     "FEE_RATES", "band_ask_depth_usd", "best_bid_ask", "book_inferred_winner",
-    "book_meta", "fee", "get_book", "get_market", "get_tape", "http_get_json",
-    "parse_market", "resolved_winner",
+    "book_meta", "event_markets", "fee", "get_book", "get_market", "get_tape",
+    "http_get_json", "parse_market", "positions", "resolved_winner",
     "PolymarketExecutor", "Fill",
     "PmqError", "OrderUncertain", "IntrospectionMismatch",
     "__version__",

{pmquant-0.1.0 → pmquant-0.2.0}/src/pmq/data.py

@@ -191,6 +191,29 @@ def book_inferred_winner(bid_a, bid_b, threshold=0.90):
     return None
 
 
+def event_markets(slug, logger=None):
+    """All binary markets of one event (multi-outcome events like elections
+    or tournaments are one binary market per candidate). Returns a list of
+    :func:`parse_market` dicts; unparseable members are skipped."""
+    ev = http_get_json(f"{GAMMA}/events?slug={slug}", logger=logger)
+    if not ev:
+        return []
+    out = []
+    for m in ev[0].get("markets") or []:
+        pm = parse_market(m)
+        if pm:
+            out.append(pm)
+    return out
+
+
+def positions(user_address, logger=None, limit=200):
+    """Current holdings of a wallet per the data-api (public, ~1 min lag).
+    Answers "what do I hold?" after fills: list of dicts with asset,
+    conditionId, size, avgPrice, currentValue and friends."""
+    return http_get_json(f"{DATA}/positions?user={user_address}&limit={limit}",
+                         logger=logger) or []
+
+
 def get_tape(condition_id, since_ts, max_pages=4, logger=None):
     """Complete trade tape for a closed market (paginated, newest first).
 

{pmquant-0.1.0 → pmquant-0.2.0}/src/pmq/executor.py

@@ -101,9 +101,16 @@ class PolymarketExecutor:
                  builder_code=_UNSET, host=HOST, chain_id=CHAIN_ID,
                  client=None, derive_creds=True):
         from py_clob_client_v2.clob_types import (
-            AssetType, BalanceAllowanceParams, BuilderConfig,
-            MarketOrderArgsV2, OpenOrderParams, OrderArgsV2,
-            OrderMarketCancelParams, OrderType, TradeParams)
+            AssetType,
+            BalanceAllowanceParams,
+            BuilderConfig,
+            MarketOrderArgsV2,
+            OpenOrderParams,
+            OrderArgsV2,
+            OrderMarketCancelParams,
+            OrderType,
+            TradeParams,
+        )
         from py_clob_client_v2.exceptions import PolyApiException
         self._t = {
             "AssetType": AssetType, "BalanceAllowanceParams": BalanceAllowanceParams,
@@ -271,6 +278,27 @@ class PolymarketExecutor:
         return self._parse_fill(resp, side)
 
     # ---------------- reconciliation ----------------
+    def fee_rate(self, condition_id):
+        """Authoritative taker fee rate for one market, straight from the
+        exchange (``get_clob_market_info`` field ``fd.r``). Falls back to the
+        published crypto rate on failure, so treat the result as an estimate
+        exactly like :data:`~pmq.data.FEE_RATES`."""
+        try:
+            mi = self.client.get_clob_market_info(condition_id)
+            return float(mi["fd"]["r"])
+        except Exception as e:
+            log.warning("fee_rate(%s) fell back to static table: %s", condition_id, e)
+            return FEE_RATES["crypto"]
+
+    def cancel_order(self, order_id):
+        """Cancel one resting order by id. Never raises."""
+        try:
+            self.client.cancel_orders([order_id])
+            return True
+        except Exception as e:
+            log.warning("cancel_order(%s) failed: %s", order_id, e)
+            return False
+
     def cancel_market(self, condition_id):
         """Cancel every resting order of ours on one market. Never raises."""
         try:

{pmquant-0.1.0 → pmquant-0.2.0}/src/pmq/mcp.py

@@ -80,6 +80,19 @@ def find_markets(query: str = "", limit: int = 10) -> list:
     return out or [{"error": "nothing found"}]
 
 
+@mcp.tool()
+def event(slug: str) -> list:
+    """All binary markets of one multi-outcome EVENT (an election, a
+    tournament: one market per candidate). Use the event slug from
+    find_markets. Returns per market: slug, outcome names with token ids,
+    close time, settled winner if any."""
+    out = [{"market_slug": pm["slug"],
+            "outcomes": {pm["outcome_a"]: pm["token_a"], pm["outcome_b"]: pm["token_b"]},
+            "end_ts": pm["end_ts"], "settled_winner": data.resolved_winner(pm)}
+           for pm in data.event_markets(slug)]
+    return out or [{"error": f"no event found for slug {slug!r}"}]
+
+
 @mcp.tool()
 def market(slug: str) -> dict:
     """Resolve one Polymarket market by its gamma slug (any category, works

pmquant-0.2.0/tests/test_canary_live.py

@@ -0,0 +1,72 @@
+"""Live canary: exercises the REAL Polymarket endpoints and the installed
+py-clob-client-v2 surface. Runs only when PMQ_CANARY=1 (weekly scheduled
+workflow); regular CI stays offline. A failure here means Polymarket or the
+client drifted, not that pmq broke."""
+import os
+
+import pytest
+
+import pmq
+
+pytestmark = pytest.mark.skipif(os.environ.get("PMQ_CANARY") != "1",
+                                reason="live canary runs on schedule only")
+
+
+def _top_market():
+    evs = pmq.http_get_json(
+        f"{pmq.data.GAMMA}/events?closed=false&order=volume24hr"
+        f"&ascending=false&limit=1")
+    assert evs, "gamma events endpoint returned nothing"
+    pm = pmq.parse_market(evs[0]["markets"][0])
+    assert pm and pm["token_a"] and pm["condition_id"]
+    return pm
+
+
+def test_gamma_and_slug_resolution():
+    pm = _top_market()
+    again = pmq.parse_market(pmq.get_market(pm["slug"]))
+    assert again and again["condition_id"] == pm["condition_id"]
+
+
+def test_book_shape_and_exchange_rules():
+    pm = _top_market()
+    book = pmq.get_book(pm["token_a"])
+    assert book, "CLOB book endpoint returned nothing"
+    bid, bid_sz, ask, ask_sz = pmq.best_bid_ask(book)
+    assert (bid is not None) or (ask is not None), "book has no quotes at all"
+    meta = pmq.book_meta(book)
+    assert meta["min_order_size"] and meta["tick_size"], \
+        "book no longer carries min_order_size/tick_size"
+
+
+def test_positions_endpoint_shape():
+    rows = pmq.positions("0x0000000000000000000000000000000000000001")
+    assert isinstance(rows, list)
+
+
+def test_installed_client_surface_still_matches():
+    import inspect
+
+    from py_clob_client_v2.client import ClobClient
+    from py_clob_client_v2.clob_types import MarketOrderArgsV2, OrderType
+
+    from pmq.executor import _EXPECTED_MARKET_ARGS, _EXPECTED_METHODS
+    for name, params in _EXPECTED_METHODS.items():
+        fn = getattr(ClobClient, name, None)
+        assert fn is not None, f"client lost method {name}"
+        have = set(inspect.signature(fn).parameters)
+        for p in params:
+            assert p in have, f"{name}() lost parameter {p}"
+    have = set(inspect.signature(MarketOrderArgsV2).parameters)
+    for p in _EXPECTED_MARKET_ARGS:
+        assert p in have, f"MarketOrderArgsV2 lost field {p}"
+    assert hasattr(OrderType, "FAK")
+
+
+def test_market_info_fee_field():
+    pm = _top_market()
+    from py_clob_client_v2.client import ClobClient
+    c = ClobClient("https://clob.polymarket.com", chain_id=137)
+    mi = c.get_clob_market_info(pm["condition_id"])
+    assert isinstance(mi, dict) and "fd" in mi and "r" in mi["fd"], \
+        "get_clob_market_info no longer exposes fd.r (authoritative fee rate)"

{pmquant-0.1.0 → pmquant-0.2.0}/tests/test_data.py

@@ -1,7 +1,13 @@
 import json
 
-from pmq import (band_ask_depth_usd, best_bid_ask, book_inferred_winner, fee,
-                 parse_market, resolved_winner)
+from pmq import (
+    band_ask_depth_usd,
+    best_bid_ask,
+    book_inferred_winner,
+    fee,
+    parse_market,
+    resolved_winner,
+)
 
 
 def test_fee_matches_official_formula():

{pmquant-0.1.0 → pmquant-0.2.0}/tests/test_executor.py

@@ -160,3 +160,21 @@ def test_reconcile_cancels_then_reports_truth():
     sh, usd, fees = make(fc).reconcile("0xc")
     assert sh == 2.0 and abs(usd - 1.9) < 1e-9
     assert fc.calls and fc.calls[0][0] == "cancel"
+
+
+def test_fee_rate_authoritative_with_fallback():
+    class WithInfo(FakeClient):
+        def get_clob_market_info(self, condition_id):
+            return {"fd": {"r": 0.03, "e": 1}}
+    assert make(WithInfo()).fee_rate("0xc") == 0.03
+    assert make(FakeClient()).fee_rate("0xc") == 0.07  # fallback: method missing
+
+
+def test_cancel_order_single():
+    class WithCancel(FakeClient):
+        def cancel_orders(self, order_hashes):
+            self.calls.append(("cancel_orders", order_hashes))
+    fc = WithCancel()
+    assert make(fc).cancel_order("0xdead") is True
+    assert ("cancel_orders", ["0xdead"]) in fc.calls
+    assert make(FakeClient()).cancel_order("0xdead") is False

pmquant-0.2.0/tests/test_template_engine.py

@@ -0,0 +1,82 @@
+"""Tests for the bot-template engine (loaded from bot-template/bot.py)."""
+import csv
+import importlib.util
+import os
+import sys
+
+import pytest
+
+TEMPLATE = os.path.join(os.path.dirname(__file__), "..", "bot-template", "bot.py")
+
+
+@pytest.fixture()
+def engine(tmp_path, monkeypatch):
+    monkeypatch.setenv("BOT_OUT_DIR", str(tmp_path))
+    monkeypatch.setenv("BOT_MODE", "paper")
+    for mod in ("bot", "strategy"):
+        sys.modules.pop(mod, None)
+    spec = importlib.util.spec_from_file_location("bot", os.path.abspath(TEMPLATE))
+    bot = importlib.util.module_from_spec(spec)
+    sys.modules["bot"] = bot
+    spec.loader.exec_module(bot)
+    return bot
+
+
+def _write_csv(path, header, rows):
+    with open(path, "w", newline="") as f:
+        w = csv.DictWriter(f, fieldnames=header)
+        w.writeheader()
+        for r in rows:
+            w.writerow(r)
+
+
+def test_recover_orphans_rebuilds_unscored_markets(engine, monkeypatch):
+    _write_csv(engine.FILLS_CSV, engine.FILLS_HEADER, [
+        {"ts": 1, "family": "some-market", "window": 100, "mode": "paper",
+         "side": "Yes", "price": 0.5, "shares": 10, "notional": 5,
+         "ask_size_at_fill": "", "band_depth_usd": "", "secs_left": "",
+         "order_id": ""},
+        {"ts": 2, "family": "scored-market", "window": 100, "mode": "paper",
+         "side": "Yes", "price": 0.5, "shares": 10, "notional": 5,
+         "ask_size_at_fill": "", "band_depth_usd": "", "secs_left": "",
+         "order_id": ""},
+    ])
+    _write_csv(engine.WINDOWS_CSV, engine.WINDOWS_HEADER, [
+        {"family": "scored-market", "window": 100, "mode": "paper",
+         "side": "Yes", "n_fills": 1, "avg_price": 0.5, "shares": 10,
+         "spent": 5, "winner": "Yes", "winner_source": "gamma",
+         "gross_pnl": 5, "fee": 0, "net_pnl": 5, "scored_ts": 3}])
+    fake_pm = {"condition_id": "0xc", "slug": "some-market", "token_a": "1",
+               "token_b": "2", "outcome_a": "Yes", "outcome_b": "No",
+               "outcome_prices_raw": None, "idx_a": 0, "end_ts": None}
+    monkeypatch.setattr(engine.pmq, "get_market", lambda s, logger=None: {"slug": s})
+    monkeypatch.setattr(engine.pmq, "parse_market",
+                        lambda m, *a, **k: dict(fake_pm) if m else None)
+    tracked = {}
+    engine.recover_orphans(tracked)
+    assert "some-market" in tracked and "scored-market" not in tracked
+    st = tracked["some-market"]
+    assert st["side"] == "Yes" and st["spent"] == 5.0 and not st["resolved"]
+
+
+def test_recover_orphans_survives_missing_files(engine):
+    tracked = {}
+    engine.recover_orphans(tracked)
+    assert tracked == {}
+
+
+def test_halt_flag_roundtrip(engine, tmp_path, monkeypatch):
+    monkeypatch.setattr(engine, "STATE_DIR", str(tmp_path / "state"))
+    day = "2026-07-03"
+    engine.write_halt_flag(day, -25.5)
+    assert os.path.exists(engine.halt_flag_path(day))
+    content = open(engine.halt_flag_path(day)).read()
+    assert "day_pnl=-25.50" in content
+
+
+def test_append_csv_writes_header_once(engine, tmp_path):
+    p = str(tmp_path / "x.csv")
+    engine.append_csv(p, {"a": 1, "b": 2}, ["a", "b"])
+    engine.append_csv(p, {"a": 3, "b": 4}, ["a", "b"])
+    rows = list(csv.DictReader(open(p)))
+    assert len(rows) == 2 and rows[1]["a"] == "3"