polynode 0.14.1__tar.gz → 0.15.1__tar.gz

polynode-0.15.1/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+## 0.15.1 (2026-10-11)
+
+- Fixed `wrap_to_polyusd()` and `unwrap_from_polyusd()` for EOA wallets on Polygon. With web3 7 or 8 they failed before sending anything, with an `ExtraDataLengthError` about a POA chain. They now set gas and gas price themselves.
+- `wrap_to_polyusd()` and `unwrap_from_polyusd()` now wait for the approval transaction to confirm before sending the wrap or unwrap, and return the transaction hash with a `0x` prefix.
+- Fixed `set_approvals()` on Polygon in the same way.
+- `ensure_ready()` results have a new `approval_tx_hashes` field with the hashes of any approval transactions that call sent. It is an empty list when nothing was sent. Existing fields are unchanged.
+
+Earlier releases are described at the top of the README.

{polynode-0.14.1 → polynode-0.15.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: polynode
-Version: 0.14.1
+Version: 0.15.1
 Summary: Python SDK for the Polynode real-time prediction market data platform
 Project-URL: Homepage, https://polynode.dev
 Project-URL: Documentation, https://docs.polynode.dev
@@ -36,7 +36,11 @@ Description-Content-Type: text/markdown
 
 Python SDK for the [Polynode](https://polynode.dev) real-time prediction market data platform.
 
-**New in v0.14.1:** Every prepared user-owned order exposes its canonical V2 exchange `order_hash` before submission. This is the exact CLOB/open-order ID and fill `order_hash`; deposit-wallet orders hash the standard inner `Order`, not the POLY_1271 wallet-signing wrapper. Record it before the network attempt so timeouts can be reconciled without risking a duplicate.
+**New in v0.15.1:** Fixes `wrap_to_polyusd()` and `unwrap_from_polyusd()` for EOA wallets on Polygon. With web3 7 or 8 they failed before sending anything, with an `ExtraDataLengthError` about a POA chain. They now set gas and gas price themselves, wait for the approval to confirm before sending the wrap or unwrap, and return the transaction hash with a `0x` prefix. `set_approvals()` gets the same gas price fix. `ensure_ready()` results now include `approval_tx_hashes`: the hashes of any approval transactions that call sent, or an empty list when none were needed.
+
+**In v0.15.0:** Polymarket Protocol V2 markets (October 2026). Upgrade before 2026-11-02 if you trade: `order()` looks up each market's protocol and signs Protocol V2 orders for the right exchange automatically, and split, merge and the new redeem work on them too. Nothing changes for current markets or for streaming and REST users. This is not the April 2026 "V2" (CTF Exchange V2 and pUSD) described elsewhere in this README; see [Polymarket Protocol V2 markets](#polymarket-protocol-v2-markets).
+
+**In v0.14.1:** Every prepared user-owned order exposes its canonical V2 exchange `order_hash` before submission. This is the exact CLOB/open-order ID and fill `order_hash`; deposit-wallet orders hash the standard inner `Order`, not the POLY_1271 wallet-signing wrapper. Record it before the network attempt so timeouts can be reconciled without risking a duplicate.
 
 **In v0.14.0:** Web platforms can take a user from wallet authorization through an exact browser-signed user-owned order without exposing backend credentials. The SDK imports the shared versioned browser bundle into memory, produces a credential-free signing request with a complete order preview, supports one-time multi-worker state, validates canonical signatures and wallet identity, checks BUY collateral before prompting, and submits with exact zero builder attribution.
 
@@ -72,7 +76,6 @@ with PolyNode(api_key="pn_live_...") as pn:
     status = pn.status()
     connections = pn.connections()
     markets = pn.markets(count=10)
-    settlements = pn.recent_settlements(count=5)
     wallet_positions = pn.wallet_positions(
         address, redeemable=True, condition_id=condition_id
     )
@@ -127,7 +130,7 @@ asyncio.run(main())
 
 ### Complete V3 API
 
-V3 includes wallets, combos, rewards, credits, identities, markets, builders, profiles, perps, crypto, sports, backtesting, and other current product families. `execute()` gives you access to all 120 current V3 operations through one consistent Python interface.
+V3 includes wallets, combos, rewards, credits, identities, markets, events, builders, profiles, perps, crypto, sports, backtesting, and other current product families. `execute()` gives you access to all 129 current V3 operations through one consistent Python interface.
 
 ```python
 import asyncio
@@ -135,7 +138,7 @@ from polynode import AsyncPolyNode
 
 async def read_v3(address: str):
     async with AsyncPolyNode(api_key="pn_live_...") as pn:
-        print(len(pn.v3.operations))  # 120
+        print(len(pn.v3.operations))  # 128
 
         combo_activity = await pn.v3.execute(
             "GET /v3/combos/activity",
@@ -146,11 +149,76 @@ async def read_v3(address: str):
             path_params={"address": address},
             query={"limit": 100},
         )
-        return combo_activity, wallet_rewards
+        scopes = await pn.v3.execute(
+            "GET /v3/leaderboard/scopes",
+            query={"period": "7d", "scope": "category"},
+        )
+        markets = await pn.v3.execute(
+            "GET /v3/markets",
+            query={"status": "open", "limit": 100},
+        )
+        return combo_activity, wallet_rewards, scopes, markets
 
 asyncio.run(read_v3("0xabc..."))
 ```
 
+Use the typed Combo P&L helper for All Time realized, unrealized, and total
+P&L, or realized P&L over a fixed or custom half-open window:
+
+```python
+from polynode import PolyNodeV3
+
+with PolyNodeV3("pn_live_...") as v3:
+    all_time = v3.combo_pnl_leaderboard(
+        period="all",
+        sort_by="total_pnl",
+    )
+    custom = v3.combo_pnl_leaderboard(
+        period="custom",
+        after=1_788_134_400,
+        before=1_788_220_800,
+        sort_by="realized_pnl",
+    )
+```
+
+Wallets with incomplete arbitrary transfer basis or without a current mark are
+omitted rather than returned with zero P&L. Inspect `coverage` on every response
+before presenting the ranking.
+
+Market and event catalogs use opaque cursor pagination. Reward-market list
+rows include nullable title, slug, image, event, category, and tag fields.
+
+Named perps helpers accept the returned opaque cursor:
+
+```python
+from polynode import PolyNodeV3
+
+with PolyNodeV3(api_key="pn_live_...") as v3:
+    first = v3.perps_trades(
+        "BTC-USD",
+        after=1_787_875_200,
+        before=1_787_961_600,
+        limit=100,
+    )
+    if first.get("next_cursor"):
+        second = v3.perps_trades(
+            "BTC-USD",
+            after=1_787_875_200,
+            before=1_787_961_600,
+            limit=100,
+            cursor=first["next_cursor"],
+        )
+
+    events = v3.perps_events(address=address, limit=100)
+    liquidations = v3.perps_liquidations(min_notional=10_000)
+    flows = v3.perps_wallet_flows(address, limit=100)
+```
+
+Reuse the same route and filters on every cursor page. Wallet-flow totals and
+counts remain fixed during one traversal. Cumulative volume delta remains a
+bounded single-page series and has no cursor helper. Async clients expose the
+same methods with `await`.
+
 The SDK encodes path parameters for you. Read requests that are safe to repeat retry transient failures and honor `Retry-After`; requests that change data are never retried automatically. JSON decimals decode as `Decimal`, and `ApiError` exposes the status, request ID, retry details, and a request URL with credentials removed.
 
 Current presets include `dome`, `fills`, `combos`, `redemptions`, and `deposits`. Current filters include `since()`, `combo_condition_ids()`, `leg_position_ids()`, `event_ids()`, `module_ids()`, `action()`, and `direction()`.
@@ -301,6 +369,43 @@ For the V2 order flow, required approvals, and common failure modes, see [docs.p
 
 V2 fees are determined at match time and are not signed into an order, so V2 payloads omit `feeRateBps`, `nonce`, and `taker`. Explicit legacy V1 mode still signs `feeRateBps`; for that path the SDK fetches `/fee-rate` and fails closed if fee, tick-size, or neg-risk metadata is unavailable or malformed.
 
+#### Polymarket Protocol V2 markets
+
+> **Two different "V2"s.** Polymarket Protocol V2 (October 2026) is Polymarket's new position system: positions live in a new ledger (PositionManager), every market type trades on one new exchange (ExchangeV3, order signing domain version `"3"`), and split, merge and redeem go through a Router. It is **not** the April 2026 upgrade (CTF Exchange V2 with pUSD collateral) that `ExchangeVersion.V2` and the rest of this README call "V2". Current markets keep using the April exchanges.
+
+**When.** Polymarket's test markets for Protocol V2 trade from 2026-10-05 to 2026-10-30. New markets move to Protocol V2 from around 2026-11-02 (tentative, per Polymarket). Existing markets stay where they are.
+
+**What you need to do.**
+
+- Streaming and REST only: nothing. Same methods, same response shapes. Rows and events for Protocol V2 markets carry a few optional fields: `protocol_version: "v2"`, `module` (`"binary"` or `"neg_risk"`), `exchange_version: "v3"` on fills, and `payouts_ppm` / `derived` on oracle events. A row without them is a current market.
+- Trading: upgrade to `polynode` 0.15.0 before 2026-11-02 and place orders exactly as before. Older versions keep working on current markets, but Polymarket rejects their orders on Protocol V2 markets (no funds move).
+- Storing ids yourself: keep outcome ids as strings (up to 78 digits). Condition ids are returned in the 66-character form; the 64-character form is accepted as input.
+
+The first order on a Protocol V2 market grants the two approvals it needs (pUSD and PositionManager, both for ExchangeV3): one gasless batch for Safe and deposit wallets, or two transactions with a little POL gas for an EOA. To do it ahead of time, or for browser-signed user-owned orders, call `ensure_ready` once with `protocol_v2=True`. Plain `ensure_ready()` behaves exactly as before.
+
+```python
+from polynode.trading import MergeParams, RedeemParams, SplitParams
+
+await trader.ensure_ready("0xYourPrivateKey...", protocol_v2=True)  # optional
+version = await trader.get_market_protocol(token_id)  # "v1" (current) or "v2"
+
+# Same call for every market; the SDK picks the exchange and signing domain.
+await trader.order(OrderParams(token_id=token_id, side="BUY", price=0.5, size=10))
+
+# Position operations (user-owned execution) route through the Router on V2 markets.
+await trader.execute_split(SplitParams(condition_id=condition_id, amount=10))
+await trader.execute_merge(MergeParams(condition_id=condition_id, amount=10))
+await trader.execute_redeem(RedeemParams(condition_id=condition_id, outcome_index=0))  # 0 = YES, 1 = NO
+payout = await trader.preview_payout(position_id, 10)  # None until resolved
+
+status = await trader.check_approvals(protocol_v2=True)
+print(status.protocol_v2_ready, status.position_ops_v2_ready, status.auto_redeem_enabled)
+```
+
+The SDK learns a market's protocol from Polymarket's market data and caches it for 24 hours in a new local table (existing tables are unchanged). It never guesses from the shape of an id: if the protocol cannot be learned, the order is refused with a retryable `MarketProtocolError` instead of being signed for the wrong exchange. Pass `protocol_version="v2"` (or call `trader.hint_market_protocol(...)`) to skip the lookup; a value that contradicts what the SDK already knows is refused. Short-form streams pick `positionIds` for Protocol V2 markets and expose `market.protocol_version`, so orders on discovered markets skip the lookup.
+
+Results of Protocol V2 markets are shares of 1,000,000 (`[1000000, 0]` = YES won, `[500000, 500000]` = 50/50); `payouts` carries the same result in smallest whole numbers, like current markets. `RedemptionWatcher` handles both. Automatic redemption by Polymarket's AutoRedeemer is opt-in only (`enable_auto_redeem()` / `disable_auto_redeem()`); proceeds always return to your wallet. Converting neg-risk positions is not supported for Protocol V2 markets yet.
+
 #### Optional user-owned execution
 
 Set `execution_mode=ExecutionMode.USER_OWNED` when the signing wallet should trade with zero builder attribution and use its own gasless authorization. Builder mode remains the default and existing integrations are unchanged.

{polynode-0.14.1 → polynode-0.15.1}/README.md

@@ -2,7 +2,11 @@
 
 Python SDK for the [Polynode](https://polynode.dev) real-time prediction market data platform.
 
-**New in v0.14.1:** Every prepared user-owned order exposes its canonical V2 exchange `order_hash` before submission. This is the exact CLOB/open-order ID and fill `order_hash`; deposit-wallet orders hash the standard inner `Order`, not the POLY_1271 wallet-signing wrapper. Record it before the network attempt so timeouts can be reconciled without risking a duplicate.
+**New in v0.15.1:** Fixes `wrap_to_polyusd()` and `unwrap_from_polyusd()` for EOA wallets on Polygon. With web3 7 or 8 they failed before sending anything, with an `ExtraDataLengthError` about a POA chain. They now set gas and gas price themselves, wait for the approval to confirm before sending the wrap or unwrap, and return the transaction hash with a `0x` prefix. `set_approvals()` gets the same gas price fix. `ensure_ready()` results now include `approval_tx_hashes`: the hashes of any approval transactions that call sent, or an empty list when none were needed.
+
+**In v0.15.0:** Polymarket Protocol V2 markets (October 2026). Upgrade before 2026-11-02 if you trade: `order()` looks up each market's protocol and signs Protocol V2 orders for the right exchange automatically, and split, merge and the new redeem work on them too. Nothing changes for current markets or for streaming and REST users. This is not the April 2026 "V2" (CTF Exchange V2 and pUSD) described elsewhere in this README; see [Polymarket Protocol V2 markets](#polymarket-protocol-v2-markets).
+
+**In v0.14.1:** Every prepared user-owned order exposes its canonical V2 exchange `order_hash` before submission. This is the exact CLOB/open-order ID and fill `order_hash`; deposit-wallet orders hash the standard inner `Order`, not the POLY_1271 wallet-signing wrapper. Record it before the network attempt so timeouts can be reconciled without risking a duplicate.
 
 **In v0.14.0:** Web platforms can take a user from wallet authorization through an exact browser-signed user-owned order without exposing backend credentials. The SDK imports the shared versioned browser bundle into memory, produces a credential-free signing request with a complete order preview, supports one-time multi-worker state, validates canonical signatures and wallet identity, checks BUY collateral before prompting, and submits with exact zero builder attribution.
 
@@ -38,7 +42,6 @@ with PolyNode(api_key="pn_live_...") as pn:
     status = pn.status()
     connections = pn.connections()
     markets = pn.markets(count=10)
-    settlements = pn.recent_settlements(count=5)
     wallet_positions = pn.wallet_positions(
         address, redeemable=True, condition_id=condition_id
     )
@@ -93,7 +96,7 @@ asyncio.run(main())
 
 ### Complete V3 API
 
-V3 includes wallets, combos, rewards, credits, identities, markets, builders, profiles, perps, crypto, sports, backtesting, and other current product families. `execute()` gives you access to all 120 current V3 operations through one consistent Python interface.
+V3 includes wallets, combos, rewards, credits, identities, markets, events, builders, profiles, perps, crypto, sports, backtesting, and other current product families. `execute()` gives you access to all 129 current V3 operations through one consistent Python interface.
 
 ```python
 import asyncio
@@ -101,7 +104,7 @@ from polynode import AsyncPolyNode
 
 async def read_v3(address: str):
     async with AsyncPolyNode(api_key="pn_live_...") as pn:
-        print(len(pn.v3.operations))  # 120
+        print(len(pn.v3.operations))  # 128
 
         combo_activity = await pn.v3.execute(
             "GET /v3/combos/activity",
@@ -112,11 +115,76 @@ async def read_v3(address: str):
             path_params={"address": address},
             query={"limit": 100},
         )
-        return combo_activity, wallet_rewards
+        scopes = await pn.v3.execute(
+            "GET /v3/leaderboard/scopes",
+            query={"period": "7d", "scope": "category"},
+        )
+        markets = await pn.v3.execute(
+            "GET /v3/markets",
+            query={"status": "open", "limit": 100},
+        )
+        return combo_activity, wallet_rewards, scopes, markets
 
 asyncio.run(read_v3("0xabc..."))
 ```
 
+Use the typed Combo P&L helper for All Time realized, unrealized, and total
+P&L, or realized P&L over a fixed or custom half-open window:
+
+```python
+from polynode import PolyNodeV3
+
+with PolyNodeV3("pn_live_...") as v3:
+    all_time = v3.combo_pnl_leaderboard(
+        period="all",
+        sort_by="total_pnl",
+    )
+    custom = v3.combo_pnl_leaderboard(
+        period="custom",
+        after=1_788_134_400,
+        before=1_788_220_800,
+        sort_by="realized_pnl",
+    )
+```
+
+Wallets with incomplete arbitrary transfer basis or without a current mark are
+omitted rather than returned with zero P&L. Inspect `coverage` on every response
+before presenting the ranking.
+
+Market and event catalogs use opaque cursor pagination. Reward-market list
+rows include nullable title, slug, image, event, category, and tag fields.
+
+Named perps helpers accept the returned opaque cursor:
+
+```python
+from polynode import PolyNodeV3
+
+with PolyNodeV3(api_key="pn_live_...") as v3:
+    first = v3.perps_trades(
+        "BTC-USD",
+        after=1_787_875_200,
+        before=1_787_961_600,
+        limit=100,
+    )
+    if first.get("next_cursor"):
+        second = v3.perps_trades(
+            "BTC-USD",
+            after=1_787_875_200,
+            before=1_787_961_600,
+            limit=100,
+            cursor=first["next_cursor"],
+        )
+
+    events = v3.perps_events(address=address, limit=100)
+    liquidations = v3.perps_liquidations(min_notional=10_000)
+    flows = v3.perps_wallet_flows(address, limit=100)
+```
+
+Reuse the same route and filters on every cursor page. Wallet-flow totals and
+counts remain fixed during one traversal. Cumulative volume delta remains a
+bounded single-page series and has no cursor helper. Async clients expose the
+same methods with `await`.
+
 The SDK encodes path parameters for you. Read requests that are safe to repeat retry transient failures and honor `Retry-After`; requests that change data are never retried automatically. JSON decimals decode as `Decimal`, and `ApiError` exposes the status, request ID, retry details, and a request URL with credentials removed.
 
 Current presets include `dome`, `fills`, `combos`, `redemptions`, and `deposits`. Current filters include `since()`, `combo_condition_ids()`, `leg_position_ids()`, `event_ids()`, `module_ids()`, `action()`, and `direction()`.
@@ -267,6 +335,43 @@ For the V2 order flow, required approvals, and common failure modes, see [docs.p
 
 V2 fees are determined at match time and are not signed into an order, so V2 payloads omit `feeRateBps`, `nonce`, and `taker`. Explicit legacy V1 mode still signs `feeRateBps`; for that path the SDK fetches `/fee-rate` and fails closed if fee, tick-size, or neg-risk metadata is unavailable or malformed.
 
+#### Polymarket Protocol V2 markets
+
+> **Two different "V2"s.** Polymarket Protocol V2 (October 2026) is Polymarket's new position system: positions live in a new ledger (PositionManager), every market type trades on one new exchange (ExchangeV3, order signing domain version `"3"`), and split, merge and redeem go through a Router. It is **not** the April 2026 upgrade (CTF Exchange V2 with pUSD collateral) that `ExchangeVersion.V2` and the rest of this README call "V2". Current markets keep using the April exchanges.
+
+**When.** Polymarket's test markets for Protocol V2 trade from 2026-10-05 to 2026-10-30. New markets move to Protocol V2 from around 2026-11-02 (tentative, per Polymarket). Existing markets stay where they are.
+
+**What you need to do.**
+
+- Streaming and REST only: nothing. Same methods, same response shapes. Rows and events for Protocol V2 markets carry a few optional fields: `protocol_version: "v2"`, `module` (`"binary"` or `"neg_risk"`), `exchange_version: "v3"` on fills, and `payouts_ppm` / `derived` on oracle events. A row without them is a current market.
+- Trading: upgrade to `polynode` 0.15.0 before 2026-11-02 and place orders exactly as before. Older versions keep working on current markets, but Polymarket rejects their orders on Protocol V2 markets (no funds move).
+- Storing ids yourself: keep outcome ids as strings (up to 78 digits). Condition ids are returned in the 66-character form; the 64-character form is accepted as input.
+
+The first order on a Protocol V2 market grants the two approvals it needs (pUSD and PositionManager, both for ExchangeV3): one gasless batch for Safe and deposit wallets, or two transactions with a little POL gas for an EOA. To do it ahead of time, or for browser-signed user-owned orders, call `ensure_ready` once with `protocol_v2=True`. Plain `ensure_ready()` behaves exactly as before.
+
+```python
+from polynode.trading import MergeParams, RedeemParams, SplitParams
+
+await trader.ensure_ready("0xYourPrivateKey...", protocol_v2=True)  # optional
+version = await trader.get_market_protocol(token_id)  # "v1" (current) or "v2"
+
+# Same call for every market; the SDK picks the exchange and signing domain.
+await trader.order(OrderParams(token_id=token_id, side="BUY", price=0.5, size=10))
+
+# Position operations (user-owned execution) route through the Router on V2 markets.
+await trader.execute_split(SplitParams(condition_id=condition_id, amount=10))
+await trader.execute_merge(MergeParams(condition_id=condition_id, amount=10))
+await trader.execute_redeem(RedeemParams(condition_id=condition_id, outcome_index=0))  # 0 = YES, 1 = NO
+payout = await trader.preview_payout(position_id, 10)  # None until resolved
+
+status = await trader.check_approvals(protocol_v2=True)
+print(status.protocol_v2_ready, status.position_ops_v2_ready, status.auto_redeem_enabled)
+```
+
+The SDK learns a market's protocol from Polymarket's market data and caches it for 24 hours in a new local table (existing tables are unchanged). It never guesses from the shape of an id: if the protocol cannot be learned, the order is refused with a retryable `MarketProtocolError` instead of being signed for the wrong exchange. Pass `protocol_version="v2"` (or call `trader.hint_market_protocol(...)`) to skip the lookup; a value that contradicts what the SDK already knows is refused. Short-form streams pick `positionIds` for Protocol V2 markets and expose `market.protocol_version`, so orders on discovered markets skip the lookup.
+
+Results of Protocol V2 markets are shares of 1,000,000 (`[1000000, 0]` = YES won, `[500000, 500000]` = 50/50); `payouts` carries the same result in smallest whole numbers, like current markets. `RedemptionWatcher` handles both. Automatic redemption by Polymarket's AutoRedeemer is opt-in only (`enable_auto_redeem()` / `disable_auto_redeem()`); proceeds always return to your wallet. Converting neg-risk positions is not supported for Protocol V2 markets yet.
+
 #### Optional user-owned execution
 
 Set `execution_mode=ExecutionMode.USER_OWNED` when the signing wallet should trade with zero builder attribution and use its own gasless authorization. Builder mode remains the default and existing integrations are unchanged.

{polynode-0.14.1 → polynode-0.15.1}/core-contract-v1.json

@@ -237,7 +237,7 @@
         "never_drop_silently": true
       }
     },
-    "operation_count": 120,
+    "operation_count": 129,
     "operations": [
       {
         "method": "POST",
@@ -371,12 +371,48 @@
         "domain": "combos",
         "retry": "safe_read"
       },
+      {
+        "method": "GET",
+        "path": "/v3/combos/activity/daily",
+        "domain": "combos",
+        "retry": "safe_read"
+      },
+      {
+        "method": "GET",
+        "path": "/v3/combos/leaderboard",
+        "domain": "combos",
+        "retry": "safe_read"
+      },
       {
         "method": "GET",
         "path": "/v3/combos/redemptions",
         "domain": "combos",
         "retry": "safe_read"
       },
+      {
+        "method": "GET",
+        "path": "/v3/markets",
+        "domain": "markets",
+        "retry": "safe_read"
+      },
+      {
+        "method": "GET",
+        "path": "/v3/markets/stats",
+        "domain": "markets",
+        "retry": "safe_read"
+      },
+      {
+        "method": "GET",
+        "path": "/v3/events",
+        "domain": "events",
+        "retry": "safe_read"
+      },
+      {
+        "method": "GET",
+        "path": "/v3/events/stats",
+        "domain": "events",
+        "retry": "safe_read"
+      },
       {
         "method": "GET",
         "path": "/v3/markets/search",
@@ -485,6 +521,12 @@
         "domain": "global",
         "retry": "safe_read"
       },
+      {
+        "method": "GET",
+        "path": "/v3/leaderboard/scopes",
+        "domain": "global",
+        "retry": "safe_read"
+      },
       {
         "method": "GET",
         "path": "/v3/builders",
@@ -497,6 +539,12 @@
         "domain": "builders",
         "retry": "safe_read"
       },
+      {
+        "method": "GET",
+        "path": "/v3/builders/{code}/leaderboard",
+        "domain": "builders",
+        "retry": "safe_read"
+      },
       {
         "method": "GET",
         "path": "/v3/builders/{code}/trades",
@@ -887,6 +935,12 @@
         "domain": "perps",
         "retry": "safe_read"
       },
+      {
+        "method": "GET",
+        "path": "/v3/perps/activity/daily",
+        "domain": "perps",
+        "retry": "safe_read"
+      },
       {
         "method": "GET",
         "path": "/v3/perps/funding-pnl/{instrument}",

polynode-0.15.1/polynode/__init__.py

@@ -0,0 +1,161 @@
+"""PolyNode Python SDK — real-time prediction market data and trading."""
+
+from ._version import __version__
+from .client import AsyncPolyNode, PolyNode
+from .engine import EngineView, OrderbookEngine
+from .errors import ApiError, PolyNodeError, WsError
+from .market_protocol import (
+    MarketProtocolError,
+    MarketProtocolInfo,
+    MarketProtocolResolver,
+    ProtocolVersion,
+    get_market_protocol,
+    normalize_condition_id,
+    protocol_v2_position_ids,
+)
+from .orderbook import OrderbookWS
+from .orderbook_state import LocalOrderbook
+from .perps import PerpsChannels, PerpsWS, perps_channels, perps_websocket_url
+from .types.perps import (
+    PerpsConnected,
+    PerpsDecodeError,
+    PerpsEvent,
+    PerpsLagWarning,
+    PerpsMessage,
+    PerpsPositionEvent,
+    PerpsPositionEventsResponse,
+    PerpsPositionEventType,
+    PerpsPong,
+    PerpsQueueOverflow,
+    PerpsReconnectNotice,
+    PerpsRejectedChannel,
+    PerpsServerError,
+    PerpsSubscribed,
+    PerpsRestTrade,
+    PerpsTradesResponse,
+    PerpsUnknownMessage,
+    PerpsUnsubscribed,
+    PerpsWalletFlowEvent,
+    PerpsWalletFlowsResponse,
+)
+from .types.v3 import (
+    BuilderTraderLeaderboardCoverage,
+    BuilderTraderLeaderboardPeriod,
+    BuilderTraderLeaderboardResponse,
+    BuilderTraderLeaderboardRow,
+    BuilderTraderLeaderboardSort,
+    BuilderTraderLeaderboardWindow,
+    ComboActivityCountSemantics,
+    ComboActivityDailyResponse,
+    ComboActivityDay,
+    ComboPnlLeaderboardCoverage,
+    ComboPnlLeaderboardPeriod,
+    ComboPnlLeaderboardResponse,
+    ComboPnlLeaderboardRow,
+    ComboPnlLeaderboardSort,
+    ComboPnlLeaderboardWindow,
+    ComboPnlScope,
+    DailyActivityPeriod,
+    PerpsActivityDailyResponse,
+    PerpsActivityDay,
+    PerpsActivityTotal,
+    PerpsInstrumentActivityDay,
+    PerpsInstrumentActivitySeries,
+    ProtocolV2RowFields,
+)
+from .redemption_watcher import RedeemableAlert, RedemptionWatcher, TrackedPosition
+from .short_form import ShortFormStream, short_form_chainlink_feed, short_form_twap_window
+from .subscription import Subscription, SubscriptionBuilder
+from .testing import get_active_test_wallet, get_active_test_wallets
+from .v3 import AsyncPolyNodeV3, PolyNodeV3
+from .v3_operations import V3_OPERATIONS, V3_OPERATION_COUNT, V3Operation
+from .ws import PolyNodeWS
+
+__all__ = [
+    "MarketProtocolError",
+    "MarketProtocolInfo",
+    "MarketProtocolResolver",
+    "ProtocolVersion",
+    "ProtocolV2RowFields",
+    "get_market_protocol",
+    "normalize_condition_id",
+    "protocol_v2_position_ids",
+    "__version__",
+    # Clients
+    "PolyNode",
+    "AsyncPolyNode",
+    "PolyNodeV3",
+    "AsyncPolyNodeV3",
+    "PerpsWS",
+    "PerpsChannels",
+    "perps_channels",
+    "perps_websocket_url",
+    "PerpsConnected",
+    "PerpsRejectedChannel",
+    "PerpsSubscribed",
+    "PerpsUnsubscribed",
+    "PerpsPong",
+    "PerpsEvent",
+    "PerpsLagWarning",
+    "PerpsServerError",
+    "PerpsReconnectNotice",
+    "PerpsDecodeError",
+    "PerpsUnknownMessage",
+    "PerpsQueueOverflow",
+    "PerpsMessage",
+    "PerpsPositionEventType",
+    "PerpsRestTrade",
+    "PerpsTradesResponse",
+    "PerpsPositionEvent",
+    "PerpsPositionEventsResponse",
+    "PerpsWalletFlowEvent",
+    "PerpsWalletFlowsResponse",
+    "BuilderTraderLeaderboardPeriod",
+    "BuilderTraderLeaderboardSort",
+    "BuilderTraderLeaderboardRow",
+    "BuilderTraderLeaderboardWindow",
+    "BuilderTraderLeaderboardCoverage",
+    "BuilderTraderLeaderboardResponse",
+    "ComboPnlLeaderboardPeriod",
+    "ComboPnlLeaderboardSort",
+    "ComboPnlScope",
+    "ComboPnlLeaderboardWindow",
+    "ComboPnlLeaderboardCoverage",
+    "ComboPnlLeaderboardRow",
+    "ComboPnlLeaderboardResponse",
+    "DailyActivityPeriod",
+    "ComboActivityDay",
+    "ComboActivityCountSemantics",
+    "ComboActivityDailyResponse",
+    "PerpsActivityDay",
+    "PerpsInstrumentActivityDay",
+    "PerpsInstrumentActivitySeries",
+    "PerpsActivityTotal",
+    "PerpsActivityDailyResponse",
+    "V3Operation",
+    "V3_OPERATIONS",
+    "V3_OPERATION_COUNT",
+    # WebSocket
+    "PolyNodeWS",
+    "SubscriptionBuilder",
+    "Subscription",
+    # Orderbook
+    "OrderbookWS",
+    "LocalOrderbook",
+    "OrderbookEngine",
+    "EngineView",
+    # Streams
+    "ShortFormStream",
+    "short_form_chainlink_feed",
+    "short_form_twap_window",
+    "RedemptionWatcher",
+    "RedeemableAlert",
+    "TrackedPosition",
+    # Testing
+    "get_active_test_wallet",
+    "get_active_test_wallets",
+    # Errors
+    "PolyNodeError",
+    "ApiError",
+    "WsError",
+]

polynode-0.15.1/polynode/_version.py

@@ -0,0 +1 @@
+__version__ = "0.15.1"