pmxt 1.6.0__py3-none-any.whl → 1.7.0__py3-none-any.whl

pmxt/__init__.py

@@ -49,7 +49,7 @@ def restart_server():
     """
     _default_manager.restart()
 
-__version__ = "1.6.0"
+__version__ = "1.7.0"
 __all__ = [
     # Exchanges
     "Polymarket",

pmxt/_server/server/bundled.js

@@ -24419,13 +24419,118 @@ var require_BaseExchange = __commonJS({
         this.credentials = credentials;
       }
       /**
+       * Fetch markets with optional filtering, search, or slug lookup.
+       * This is the primary method for retrieving markets in CCXT-style.
+       *
+       * @param params - Optional parameters for filtering and search
+       * @param params.query - Search keyword to filter markets
+       * @param params.slug - Market slug/ticker for direct lookup
+       * @param params.limit - Maximum number of results
+       * @param params.offset - Pagination offset
+       * @param params.sort - Sort order
+       * @param params.searchIn - Where to search (title, description, or both)
+       * @returns Array of unified markets
+       *
+       * @example Fetch all markets
+       * await exchange.fetchMarkets()
+       *
+       * @example Search markets
+       * await exchange.fetchMarkets({ query: 'Trump' })
+       *
+       * @example Get market by slug
+       * await exchange.fetchMarkets({ slug: 'will-trump-win' })
+       */
+      async fetchMarkets(params) {
+        if (params?.slug) {
+          return this.fetchMarketsBySlugImpl(params.slug);
+        }
+        if (params?.query) {
+          return this.searchMarketsImpl(params.query, params);
+        }
+        return this.fetchMarketsImpl(params);
+      }
+      /**
+       * Fetch events with optional keyword search.
+       * Events group related markets together.
+       *
+       * @param params - Optional parameters for search and filtering
+       * @param params.query - Search keyword to filter events
+       * @param params.limit - Maximum number of results
+       * @param params.offset - Pagination offset
+       * @param params.searchIn - Where to search (title, description, or both)
+       * @returns Array of unified events
+       *
+       * @example Search events
+       * await exchange.fetchEvents({ query: 'Election' })
+       */
+      async fetchEvents(params) {
+        if (params?.query) {
+          return this.searchEventsImpl(params.query, params);
+        }
+        throw new Error("fetchEvents() requires a query parameter");
+      }
+      // ----------------------------------------------------------------------------
+      // Implementation methods (to be overridden by exchanges)
+      // ----------------------------------------------------------------------------
+      /**
+       * @internal
+       * Implementation for fetching all markets.
+       */
+      async fetchMarketsImpl(params) {
+        throw new Error("Method fetchMarketsImpl not implemented.");
+      }
+      /**
+       * @internal
+       * Implementation for searching markets by keyword.
+       */
+      async searchMarketsImpl(query, params) {
+        throw new Error("Method searchMarketsImpl not implemented.");
+      }
+      /**
+       * @internal
+       * Implementation for fetching markets by slug/ticker.
+       */
+      async fetchMarketsBySlugImpl(slug) {
+        throw new Error("Method fetchMarketsBySlugImpl not implemented.");
+      }
+      /**
+       * @internal
+       * Implementation for searching events by keyword.
+       */
+      async searchEventsImpl(query, params) {
+        throw new Error("Method searchEventsImpl not implemented.");
+      }
+      // ----------------------------------------------------------------------------
+      // Deprecated methods (kept for backward compatibility)
+      // ----------------------------------------------------------------------------
+      /**
+       * @deprecated Use fetchMarkets({ query: '...' }) instead. Will be removed in v2.0
+       * Search for markets matching a keyword query.
+       * By default, searches only in market titles. Use params.searchIn to search descriptions or both.
+       */
+      async searchMarkets(query, params) {
+        console.warn('\u26A0\uFE0F  searchMarkets() is deprecated. Use fetchMarkets({ query: "..." }) instead.');
+        return this.fetchMarkets({ ...params, query });
+      }
+      /**
+       * @deprecated Use fetchMarkets({ slug: '...' }) instead. Will be removed in v2.0
+       * Fetch markets by URL slug (Polymarket) or ticker (Kalshi).
+       * @param slug - Market slug or ticker
+       */
+      async getMarketsBySlug(slug) {
+        console.warn('\u26A0\uFE0F  getMarketsBySlug() is deprecated. Use fetchMarkets({ slug: "..." }) instead.');
+        return this.fetchMarkets({ slug });
+      }
+      /**
+       * @deprecated Use fetchEvents({ query: '...' }) instead. Will be removed in v2.0
        * Search for events matching a keyword query.
        * Returns grouped events, each containing related markets.
        * @param query - Search term
        * @param params - Optional filter parameters
        */
       async searchEvents(query, params) {
-        throw new Error("Method searchEvents not implemented.");
+        console.warn('\u26A0\uFE0F  searchEvents() is deprecated. Use fetchEvents({ query: "..." }) instead.');
+        return this.fetchEvents({ ...params, query });
       }
       /**
        * Fetch historical price data for a specific market outcome.
@@ -105150,18 +105255,21 @@ var require_polymarket = __commonJS({
       get name() {
         return "Polymarket";
       }
-      async fetchMarkets(params) {
+      // ----------------------------------------------------------------------------
+      // Implementation methods for CCXT-style API
+      // ----------------------------------------------------------------------------
+      async fetchMarketsImpl(params) {
         return (0, fetchMarkets_1.fetchMarkets)(params);
       }
-      async searchMarkets(query, params) {
+      async searchMarketsImpl(query, params) {
         return (0, searchMarkets_1.searchMarkets)(query, params);
       }
-      async searchEvents(query, params) {
-        return (0, searchEvents_1.searchEvents)(query, params);
-      }
-      async getMarketsBySlug(slug) {
+      async fetchMarketsBySlugImpl(slug) {
         return (0, getMarketsBySlug_1.getMarketsBySlug)(slug);
       }
+      async searchEventsImpl(query, params) {
+        return (0, searchEvents_1.searchEvents)(query, params);
+      }
       async fetchOHLCV(id, params) {
         return (0, fetchOHLCV_1.fetchOHLCV)(id, params);
       }
@@ -106135,18 +106243,21 @@ var require_limitless = __commonJS({
       get name() {
         return "Limitless";
       }
-      async fetchMarkets(params) {
+      // ----------------------------------------------------------------------------
+      // Implementation methods for CCXT-style API
+      // ----------------------------------------------------------------------------
+      async fetchMarketsImpl(params) {
         return (0, fetchMarkets_1.fetchMarkets)(params);
       }
-      async searchMarkets(query, params) {
+      async searchMarketsImpl(query, params) {
         return (0, searchMarkets_1.searchMarkets)(query, params);
       }
-      async searchEvents(query, params) {
-        return (0, searchEvents_1.searchEvents)(query, params);
-      }
-      async getMarketsBySlug(slug) {
+      async fetchMarketsBySlugImpl(slug) {
         return (0, getMarketsBySlug_1.getMarketsBySlug)(slug);
       }
+      async searchEventsImpl(query, params) {
+        return (0, searchEvents_1.searchEvents)(query, params);
+      }
       async fetchOHLCV(id, params) {
         return (0, fetchOHLCV_1.fetchOHLCV)(id, params);
       }
@@ -107347,20 +107458,20 @@ var require_kalshi = __commonJS({
         return this.auth;
       }
       // ----------------------------------------------------------------------------
-      // Market Data Methods
+      // Market Data Methods - Implementation for CCXT-style API
       // ----------------------------------------------------------------------------
-      async fetchMarkets(params) {
+      async fetchMarketsImpl(params) {
         return (0, fetchMarkets_1.fetchMarkets)(params);
       }
-      async searchMarkets(query, params) {
+      async searchMarketsImpl(query, params) {
         return (0, searchMarkets_1.searchMarkets)(query, params);
       }
-      async searchEvents(query, params) {
-        return (0, searchEvents_1.searchEvents)(query, params);
-      }
-      async getMarketsBySlug(slug) {
+      async fetchMarketsBySlugImpl(slug) {
         return (0, getMarketsBySlug_1.getMarketsBySlug)(slug);
       }
+      async searchEventsImpl(query, params) {
+        return (0, searchEvents_1.searchEvents)(query, params);
+      }
       async fetchOHLCV(id, params) {
         return (0, fetchOHLCV_1.fetchOHLCV)(id, params);
       }

{pmxt-1.6.0.dist-info → pmxt-1.7.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pmxt
-Version: 1.6.0
+Version: 1.7.0
 Summary: Unified prediction market data API - The ccxt for prediction markets
 Author: PMXT Contributors
 License: MIT
@@ -69,14 +69,14 @@ print(markets[0].title)
 outcome = markets[0].outcomes[0]
 print(f"{outcome.label}: {outcome.price * 100:.1f}%")
 
-# Fetch historical data (use outcome.id!)
+# Fetch historical data (use outcome.outcome_id!)
 candles = poly.fetch_ohlcv(
-    outcome.id,
+    outcome.outcome_id,
     pmxt.HistoryFilterParams(resolution="1d", limit=30)
 )
 
 # Get current order book
-order_book = poly.fetch_order_book(outcome.id)
+order_book = poly.fetch_order_book(outcome.outcome_id)
 spread = order_book.asks[0].price - order_book.bids[0].price
 print(f"Spread: {spread * 100:.2f}%")
 ```
@@ -182,7 +182,7 @@ All methods return clean Python dataclasses:
 ```python
 @dataclass
 class UnifiedMarket:
-    id: str
+    market_id: str       # Use this for create_order
     title: str
     outcomes: List[MarketOutcome]
     volume_24h: float
@@ -192,7 +192,7 @@ class UnifiedMarket:
 
 @dataclass
 class MarketOutcome:
-    id: str              # Use this for fetch_ohlcv/fetch_order_book
+    outcome_id: str      # Use this for fetch_ohlcv/fetch_order_book/fetch_trades
     label: str           # "Trump", "Yes", etc.
     price: float         # 0.0 to 1.0 (probability)
     # ... more fields
@@ -202,16 +202,16 @@ See the [full API reference](../../API_REFERENCE.md) for complete documentation.
 
 ## Important Notes
 
-### Use `outcome.id`, not `market.id`
+### Use `outcome.outcome_id`, not `market.market_id`
 
 For deep-dive methods like `fetch_ohlcv()`, `fetch_order_book()`, and `fetch_trades()`, you must use the **outcome ID**, not the market ID:
 
 ```python
 markets = poly.search_markets("Trump")
-outcome_id = markets[0].outcomes[0].id  # Correct
+outcome_id = markets[0].outcomes[0].outcome_id  # Correct
 
 candles = poly.fetch_ohlcv(outcome_id, ...)  # Works
-candles = poly.fetch_ohlcv(markets[0].id, ...)  # Wrong!
+candles = poly.fetch_ohlcv(markets[0].market_id, ...)  # Wrong!
 ```
 
 ### Prices are 0.0 to 1.0

{pmxt-1.6.0.dist-info → pmxt-1.7.0.dist-info}/RECORD

@@ -1,15 +1,15 @@
-pmxt/__init__.py,sha256=kbtmNd7bfDO-SNmmsJ0D11RuTWmX1gYBrJiVyTTRdgo,1520
+pmxt/__init__.py,sha256=mALOMPFV9BEkIwUqZ4_SAytlq9Lh3WVjSuAlTzLFFaY,1520
 pmxt/client.py,sha256=lpDT0zDw1OXal_hbjcV69DidlgyyzKMmPMqvm4waNGg,43488
 pmxt/models.py,sha256=LYfbd_SEtvqI9gYnVz6wAqlijJkSODrodE7v0owbyok,10291
 pmxt/server_manager.py,sha256=kkbvQOgCBBDUbe0X4KGLZsWpuHxz3Yvb9ECDhjQxMOE,12050
 pmxt/_server/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pmxt/_server/bin/pmxt-ensure-server,sha256=kXIond0UbxS52FAVQD7kHmSBaL_s6cbIyapLRr4KZJw,4544
 pmxt/_server/bin/pmxt-ensure-server.js,sha256=kXIond0UbxS52FAVQD7kHmSBaL_s6cbIyapLRr4KZJw,4544
-pmxt/_server/server/bundled.js,sha256=ZfMpYAXX5UZECbkYlvCB5mGPvhorSrkw-h4m0ZeRdEk,4251928
-pmxt_internal/__init__.py,sha256=CEpTnAT2C0rjNGAaRZbClTn4UvDWuHTe3AeC5n7AuBE,7756
-pmxt_internal/api_client.py,sha256=nNG9x5sU703c-iI5McO1R21TNLikw9sHxn5osmiSmkk,27889
+pmxt/_server/server/bundled.js,sha256=PoH6oBCeXSAFINx7AAPeVY89xbAoxjlWt3WWwbrZaLI,4256943
+pmxt_internal/__init__.py,sha256=kB1112bowIVIz803gTxnoVVXdPoBOkZ7Hr3uUb4JTss,7756
+pmxt_internal/api_client.py,sha256=Z4IcjvppvcZGKSah_BCFI8WZIyUX_rP05XLtSNIYklI,27889
 pmxt_internal/api_response.py,sha256=eMxw1mpmJcoGZ3gs9z6jM4oYoZ10Gjk333s9sKxGv7s,652
-pmxt_internal/configuration.py,sha256=QzLqWzVIo7r9XwfJKlfaHgWg7cbgNmERylbCO6Ja4b8,18320
+pmxt_internal/configuration.py,sha256=UxpBcHmAuuTBdl-1wAY8GVGyebJursuyndZjrFeCQk4,18320
 pmxt_internal/exceptions.py,sha256=txF8A7vlan57JS69kFPs-IZF-Qhp7IZobBTJVa4fOaM,6644
 pmxt_internal/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pmxt_internal/rest.py,sha256=FMj4yaV6XLr842u_ScWHSzQsTFdk0jaUeuWLJoRbogQ,9760
@@ -66,7 +66,7 @@ pmxt_internal/models/unified_market.py,sha256=0y917aPCUNtlToDhfJWwVh3lGT-1VRFh_p
 pmxt_internal/models/watch_order_book_request.py,sha256=kavGUI-SLz2-Kam_jcJ_h0GDe0-9UkxqCmVsAi6Uios,3726
 pmxt_internal/models/watch_order_book_request_args_inner.py,sha256=ZHrjmFDGxRG5MXbuz4mUp9KFfo3XS7zuXWTyMNgi4xI,5464
 pmxt_internal/models/watch_trades_request.py,sha256=brrg8JbEe-aeg7mIe_Y2HzRPogp-IfRhkXChrxzqoLU,3722
-pmxt-1.6.0.dist-info/METADATA,sha256=aglrK1EbEVfA2fdanlMDKDCmRdHd8ONF8mcUOuvf9h8,6449
-pmxt-1.6.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-pmxt-1.6.0.dist-info/top_level.txt,sha256=J_jrcouJ-x-5lpcXMxeW0GOSi1HsBVR5_PdSfvigVrw,19
-pmxt-1.6.0.dist-info/RECORD,,
+pmxt-1.7.0.dist-info/METADATA,sha256=Q3N8stoYU3EiOESPB60W8cfG2D3TsRg0FKYLE1p6P38,6557
+pmxt-1.7.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+pmxt-1.7.0.dist-info/top_level.txt,sha256=J_jrcouJ-x-5lpcXMxeW0GOSi1HsBVR5_PdSfvigVrw,19
+pmxt-1.7.0.dist-info/RECORD,,

pmxt_internal/__init__.py

@@ -14,7 +14,7 @@
 """  # noqa: E501
 
 
-__version__ = "1.6.0"
+__version__ = "1.7.0"
 
 # Define package exports
 __all__ = [

pmxt_internal/api_client.py

@@ -91,7 +91,7 @@ class ApiClient:
             self.default_headers[header_name] = header_value
         self.cookie = cookie
         # Set default User-Agent.
-        self.user_agent = 'OpenAPI-Generator/1.6.0/python'
+        self.user_agent = 'OpenAPI-Generator/1.7.0/python'
         self.client_side_validation = configuration.client_side_validation
 
     def __enter__(self):

pmxt_internal/configuration.py

@@ -506,7 +506,7 @@ class Configuration:
                "OS: {env}\n"\
                "Python Version: {pyversion}\n"\
                "Version of the API: 0.4.4\n"\
-               "SDK Package Version: 1.6.0".\
+               "SDK Package Version: 1.7.0".\
                format(env=sys.platform, pyversion=sys.version)
 
     def get_host_settings(self) -> List[HostSetting]: