feat(python): refactor SDK to use direct arguments and bump to v2.0.0

- Refactored fetch_markets, fetch_events, and create_order to accept direct arguments instead of parameter objects.
- Removed MarketFilterParams, EventFetchParams, and CreateOrderParams classes.
- Updated documentation (README, API_REFERENCE, QUICKREF, MIGRATION) and examples.
- Incremented version to 2.0.0 to match TypeScript SDK ergonomics.

Author: realfishsam

MIGRATION.md

@@ -9,7 +9,9 @@ If you're upgrading from v1.x to v2.0.0, use this checklist to ensure your code
 - [ ] **Replace `event.searchMarkets(query)`** with `exchange.filterMarkets(event.markets, query)`
 - [ ] **Replace all `outcome.id`** with `outcome.outcomeId`
 - [ ] **Replace all `market.id`** with `market.marketId`
-- [ ] **Python: Replace `HistoryFilterParams`** with direct kwargs in `fetch_ohlcv()` and `fetch_trades()`
+- [ ] **Python: Remove all parameter wrapper classes** (`HistoryFilterParams`, `MarketFilterParams`, `EventFetchParams`, `CreateOrderParams`)
+- [ ] **Python: Update `create_order()` calls** to use direct arguments instead of `CreateOrderParams`
+- [ ] **Python: Update `fetch_markets()` and `fetch_events()` calls** to remove `params=` argument
 - [ ] **Verify all examples** use the new unified API (`fetchMarkets`, `fetchEvents`)
 - [ ] **Update error handling** to use new error classes (if relying on error types)
 
@@ -19,7 +21,7 @@ If you already migrated to the unified API in v1.7.0, you only need to:
 
 - [ ] **Replace `event.searchMarkets(query)`** with `exchange.filterMarkets(event.markets, query)`
 - [ ] **Replace `.id`** with `.outcomeId` / `.marketId`
-- [ ] **Python only: Replace `HistoryFilterParams`** with kwargs
+- [ ] **Python only: Remove all parameter wrapper classes** and use direct kwargs/arguments
 
 ### Quick Migration Example
 
@@ -43,12 +45,14 @@ events = poly.fetch_events(query='Fed Chair')
 market = events[0].search_markets('Kevin Warsh')[0]  #  Removed
 outcome_id = market.yes.id  #  Removed
 candles = poly.fetch_ohlcv(outcome_id, pmxt.HistoryFilterParams(resolution='1h', limit=100))  #  Removed
+order = poly.create_order(pmxt.CreateOrderParams(market_id='...', outcome_id='...', side='buy', type='limit', amount=10, price=0.5))  #  Removed
 
 # v2.0.0 Code
 events = poly.fetch_events(query='Fed Chair')
 market = poly.filter_markets(events[0].markets, 'Kevin Warsh')[0]  # ✅
 outcome_id = market.yes.outcome_id  # ✅
 candles = poly.fetch_ohlcv(outcome_id, resolution='1h', limit=100)  # ✅
+order = poly.create_order(market_id='...', outcome_id='...', side='buy', type='limit', amount=10, price=0.5)  # ✅
 ```
 
 ### Testing Your Migration

sdks/python/API_REFERENCE.md

@@ -61,22 +61,20 @@ Fetch Markets
 **Signature:**
 
 ```python
-def fetch_markets(query: Optional[str] = None, params: Optional[MarketFilterParams] = None, **kwargs) -> List[UnifiedMarket]:
+def fetch_markets(query: Optional[str] = None, **kwargs) -> List[UnifiedMarket]:
 ```
 
 **Parameters:**
 
-- `params` (MarketFilterParams) - **Optional**: Filter parameters
+- `query` (str) - **Optional**: Search keyword
+- `**kwargs` - **Optional**: Additional parameters (limit, offset, sort, search_in)
 
 **Returns:** `List[UnifiedMarket]` - List of unified markets
 
 **Example:**
 
 ```python
-markets = poly.fetch_markets(pmxt.MarketFilterParams(
-    limit=20,
-    sort='volume'  # 'volume' | 'liquidity' | 'newest'
-))
+markets = poly.fetch_markets(query="Trump", limit=20, sort='volume')
 ```
 
 
@@ -201,19 +199,20 @@ Fetch Events
 **Signature:**
 
 ```python
-def fetch_events(query: Optional[str] = None, params: Optional[EventFetchParams] = None, **kwargs) -> List[UnifiedEvent]:
+def fetch_events(query: Optional[str] = None, **kwargs) -> List[UnifiedEvent]:
 ```
 
 **Parameters:**
 
-- `params` (EventFetchParams) - **Optional**: Filter parameters
+- `query` (str) - **Optional**: Search keyword
+- `**kwargs` - **Optional**: Additional parameters (limit, offset, search_in)
 
 **Returns:** `List[UnifiedEvent]` - List of unified events
 
 **Example:**
 
 ```python
-# No example available
+events = poly.fetch_events(query="Election", limit=10)
 ```
 
 
@@ -362,38 +361,52 @@ Create Order
 **Signature:**
 
 ```python
-def create_order(params: Optional[CreateOrderParams] = None) -> Order:
+def create_order(
+    market_id: str,
+    outcome_id: str,
+    side: Literal["buy", "sell"],
+    type: Literal["market", "limit"],
+    amount: float,
+    price: Optional[float] = None,
+    fee: Optional[int] = None
+) -> Order:
 ```
 
 **Parameters:**
 
-- `params` (CreateOrderParams) - **Optional**: Filter parameters
+- `market_id` (str): Market ID
+- `outcome_id` (str): Outcome ID
+- `side` (Literal["buy", "sell"]): Order side
+- `type` (Literal["market", "limit"]): Order type
+- `amount` (float): Number of contracts
+- `price` (float) - **Optional**: Limit price (required for limit orders, 0.0-1.0)
+- `fee` (int) - **Optional**: Fee rate (e.g., 1000 for 0.1%)
 
 **Returns:** `Order` - Order created
 
 **Example:**
 
 ```python
 # Limit Order Example
-order = poly.create_order(pmxt.CreateOrderParams(
+order = poly.create_order(
     market_id='663583',
     outcome_id='109918492287...',
     side='buy',
     type='limit',
     amount=10,        # Number of contracts
     price=0.55        # Required for limit orders (0.0-1.0)
-))
+)
 
 print(f'Order {order.id}: {order.status}')
 
 # Market Order Example
-order = kalshi.create_order(pmxt.CreateOrderParams(
+order = kalshi.create_order(
     market_id='FED-25JAN',
     outcome_id='FED-25JAN-YES',
     side='sell',
     type='market',
     amount=5          # Price not needed for market orders
-))
+)
 ```
 
 
@@ -619,10 +632,11 @@ def search_markets() -> Any:
 **Example:**
 
 ```python
-results = kalshi.search_markets('Fed rates', pmxt.MarketFilterParams(
+results = kalshi.fetch_markets(
+    query='Fed rates',
     limit=10,
     search_in='title'  # 'title' (default) | 'description' | 'both'
-))
+)
 ```
 
 
@@ -771,19 +785,19 @@ if balances:
     print(f'Available: ${balance.available}')
 
 # 2. Search for a market
-markets = exchange.search_markets('Trump')
+markets = exchange.fetch_markets(query='Trump')
 market = markets[0]
 outcome = market.outcomes[0]
 
 # 3. Place a limit order
-order = exchange.create_order(pmxt.CreateOrderParams(
-    market_id=market.id,
-    outcome_id=outcome.id,
+order = exchange.create_order(
+    market_id=market.market_id,
+    outcome_id=outcome.outcome_id,
     side='buy',
     type='limit',
     amount=10,
     price=0.50
-))
+)
 
 print(f'Order placed: {order.id}')
 
@@ -1008,62 +1022,3 @@ signature_type: Any # Signature type (0=EOA, 1=Poly Proxy, 2=Gnosis Safe, or nam
 ```
 
 ---
-
-## Filter Parameters
-
-### `BaseRequest`
-
-Base request structure with optional credentials
-
-```python
-@dataclass
-class BaseRequest:
-credentials: ExchangeCredentials # 
-```
-
----
-### `MarketFilterParams`
-
-
-
-```python
-@dataclass
-class MarketFilterParams:
-limit: int # 
-offset: int # 
-sort: str # 
-search_in: str # 
-```
-
----
-### `EventFetchParams`
-
-
-
-```python
-@dataclass
-class EventFetchParams:
-query: str # 
-limit: int # 
-offset: int # 
-search_in: str # 
-```
-
----
-### `CreateOrderParams`
-
-
-
-```python
-@dataclass
-class CreateOrderParams:
-market_id: str # 
-outcome_id: str # 
-side: str # 
-type: str # 
-amount: float # 
-price: float # 
-fee: float # 
-```
-
----

sdks/python/QUICKREF.py

@@ -12,12 +12,13 @@
     import pmxt
 
     poly = pmxt.Polymarket()
-    markets = poly.search_markets("Trump")
+    markets = poly.fetch_markets(query="Trump")
 
     outcome = markets[0].outcomes[0]
     candles = poly.fetch_ohlcv(
         outcome.outcome_id,
-        pmxt.HistoryFilterParams(resolution="1d", limit=30)
+        resolution="1d",
+        limit=30
     )
 
 Authentication:
@@ -33,17 +34,16 @@
     )
 
 Market Data Methods:
-    fetch_markets(params?)              # Get active markets
-    search_markets(query, params?)      # Search by keyword
-    get_markets_by_slug(slug)           # Get by URL slug/ticker
-    fetch_ohlcv(outcome_id, params)     # Historical candles
+    fetch_markets(query?, **kwargs)     # Get active markets
+    fetch_events(query?, **kwargs)      # Get events
+    fetch_ohlcv(outcome_id, **kwargs)   # Historical candles
     fetch_order_book(outcome_id)        # Current order book
-    fetch_trades(outcome_id, params)    # Trade history
+    fetch_trades(outcome_id, **kwargs)  # Trade history
     watch_order_book(outcome_id)        # WebSocket order book updates
-    watch_trades(outcome_id)           # WebSocket trade updates
+    watch_trades(outcome_id)            # WebSocket trade updates
 
 Trading Methods (require auth):
-    create_order(params)                # Place order
+    create_order(...)                   # Place order (direct args)
     cancel_order(order_id)              # Cancel order
     fetch_order(order_id)               # Get order details
     fetch_open_orders(market_id?)       # Get open orders
@@ -60,29 +60,29 @@
 
 Example - Complete Workflow:
     import pmxt
-    
+
     # Initialize
     poly = pmxt.Polymarket(private_key=os.getenv("POLYMARKET_PRIVATE_KEY"))
-    
+
     # Search
-    markets = poly.search_markets("Trump")
+    markets = poly.fetch_markets(query="Trump")
     market = markets[0]
     outcome = market.outcomes[0]
-    
+
     # Check balance
     balance = poly.fetch_balance()[0]
     print(f"Available: ${balance.available}")
-    
+
     # Place order
-    order = poly.create_order(pmxt.CreateOrderParams(
+    order = poly.create_order(
         market_id=market.market_id,
         outcome_id=outcome.outcome_id,
         side="buy",
         type="limit",
         amount=10,
         price=0.50
-    ))
-    
+    )
+
     # Check positions
     positions = poly.fetch_positions()
     for pos in positions:

sdks/python/README.md

@@ -88,14 +88,14 @@ balances = poly.fetch_balance()
 print(f"Available: ${balances[0].available}")
 
 # Place order
-order = poly.create_order(pmxt.CreateOrderParams(
+order = poly.create_order(
     market_id="663583",
     outcome_id="10991849...",
     side="buy",
     type="limit",
     amount=10,
     price=0.55
-))
+)
 ```
 
 ### Kalshi

sdks/python/examples/trading/place_limit_order.py

@@ -3,15 +3,15 @@
 
 def main():
     client = pmxt.Polymarket(private_key=os.getenv("POLYMARKET_PRIVATE_KEY"))
-    
-    order = client.create_order(pmxt.CreateOrderParams(
+
+    order = client.create_order(
         market_id='663583',
         outcome_id='10991849228756847439673778874175365458450913336396982752046655649803657501964',
         side='buy',
         type='limit',
         amount=10,
         price=0.10
-    ))
+    )
     print(order)
 
 if __name__ == "__main__":

sdks/python/examples/trading/place_market_order.py

@@ -3,14 +3,14 @@
 
 def main():
     client = pmxt.Polymarket(private_key=os.getenv("POLYMARKET_PRIVATE_KEY"))
-    
-    order = client.create_order(pmxt.CreateOrderParams(
+
+    order = client.create_order(
         market_id='663583',
         outcome_id='10991849228756847439673778874175365458450913336396982752046655649803657501964',
         side='buy',
         type='market',
         amount=10
-    ))
+    )
     print(order)
 
 if __name__ == "__main__":