polymarket-apis 0.3.0__py3-none-any.whl → 0.3.2__py3-none-any.whl

polymarket_apis/types/websockets_types.py

@@ -5,9 +5,11 @@ from pydantic import AliasChoices, BaseModel, Field, field_validator
 
 from ..types.clob_types import MakerOrder, OrderBookSummary, TickSize
 from ..types.common import EthAddress, Keccak256, TimeseriesPoint
+from ..types.gamma_types import Comment, Reaction
 
 # wss://ws-subscriptions-clob.polymarket.com/ws/market types
 
+
 class PriceChange(BaseModel):
     best_ask: float = Field(validation_alias=AliasChoices("ba", "best_ask"))
     best_bid: float = Field(validation_alias=AliasChoices("bb", "best_bid"))
@@ -17,17 +19,22 @@ class PriceChange(BaseModel):
     token_id: str = Field(validation_alias=AliasChoices("a", "asset_id"))
     hash: str = Field(validation_alias=AliasChoices("h", "hash"))
 
+
 class PriceChanges(BaseModel):
     condition_id: Keccak256 = Field(validation_alias=AliasChoices("m", "market"))
-    price_changes: list[PriceChange] = Field(validation_alias=AliasChoices("pc", "price_changes"))
+    price_changes: list[PriceChange] = Field(
+        validation_alias=AliasChoices("pc", "price_changes")
+    )
     timestamp: datetime = Field(validation_alias=AliasChoices("t", "timestamp"))
 
+
 class TickSizeChange(BaseModel):
     token_id: str = Field(alias="asset_id")
     condition_id: Keccak256 = Field(alias="market")
     old_tick_size: TickSize
     new_tick_size: TickSize
 
+
 class LastTradePrice(BaseModel):
     price: float
     size: float
@@ -36,31 +43,37 @@ class LastTradePrice(BaseModel):
     condition_id: Keccak256 = Field(alias="market")
     fee_rate_bps: float
 
+
 class OrderBookSummaryEvent(OrderBookSummary):
     event_type: Literal["book"]
 
+
 class PriceChangeEvent(PriceChanges):
     event_type: Literal["price_change"]
 
+
 class TickSizeChangeEvent(TickSizeChange):
     side: Literal["BUY", "SELL"]
     timestamp: datetime
     event_type: Literal["tick_size_change"]
 
+
 class LastTradePriceEvent(LastTradePrice):
     timestamp: datetime
     event_type: Literal["last_trade_price"]
 
+
 # wss://ws-subscriptions-clob.polymarket.com/ws/user types
 
+
 class OrderEvent(BaseModel):
     token_id: str = Field(alias="asset_id")
     condition_id: Keccak256 = Field(alias="market")
     order_id: Keccak256 = Field(alias="id")
-    associated_trades: Optional[list[str]] = None # list of trade ids which
+    associated_trades: Optional[list[str]] = None  # list of trade ids which
     maker_address: EthAddress
-    order_owner: str = Field(alias="owner") # api key of order owner
-    event_owner: Optional[str] = Field(None, alias="owner") # api key of event owner
+    order_owner: str = Field(alias="owner")  # api key of order owner
+    event_owner: Optional[str] = Field(None, alias="owner")  # api key of event owner
 
     price: float
     side: Literal["BUY", "SELL"]
@@ -71,7 +84,7 @@ class OrderEvent(BaseModel):
 
     created_at: datetime
     expiration: Optional[datetime] = None
-    timestamp: Optional[datetime] = None # time of event
+    timestamp: Optional[datetime] = None  # time of event
 
     event_type: Optional[Literal["order"]] = None
     type: Literal["PLACEMENT", "UPDATE", "CANCELLATION"]
@@ -84,35 +97,42 @@ class OrderEvent(BaseModel):
             return None
         return v
 
+
 class TradeEvent(BaseModel):
     token_id: str = Field(alias="asset_id")
     condition_id: Keccak256 = Field(alias="market")
     taker_order_id: Keccak256
     maker_orders: list[MakerOrder]
     trade_id: str = Field(alias="id")
-    trade_owner: Optional[str] = Field(None, alias="owner") # api key of trade owner
-    event_owner: str = Field(alias="owner") # api key of event owner
+    trade_owner: Optional[str] = Field(None, alias="owner")  # api key of trade owner
+    event_owner: str = Field(alias="owner")  # api key of event owner
 
     price: float
     size: float
     side: Literal["BUY", "SELL"]
     outcome: str
 
-    last_update: datetime # time of last update to trade
-    matchtime: Optional[datetime] = None # time trade was matched
-    timestamp: Optional[datetime] = None # time of event
+    last_update: datetime  # time of last update to trade
+    matchtime: Optional[datetime] = None  # time trade was matched
+    timestamp: Optional[datetime] = None  # time of event
 
     event_type: Optional[Literal["trade"]] = None
     type: Optional[Literal["TRADE"]] = None
 
     status: Literal["MATCHED", "MINED", "CONFIRMED", "RETRYING", "FAILED"]
 
+
 # wss://ws-live-data.polymarket.com types
 
+
 # Payload models
 class ActivityTrade(BaseModel):
-    token_id: str = Field(alias="asset") # ERC1155 token ID of conditional token being traded
-    condition_id: str = Field(alias="conditionId")  # Id of market which is also the CTF condition ID
+    token_id: str = Field(
+        alias="asset"
+    )  # ERC1155 token ID of conditional token being traded
+    condition_id: str = Field(
+        alias="conditionId"
+    )  # Id of market which is also the CTF condition ID
     event_slug: str = Field(alias="eventSlug")  # Slug of the event
     outcome: str  # Human readable outcome of the market
     outcome_index: int = Field(alias="outcomeIndex")  # Index of the outcome
@@ -131,66 +151,81 @@ class ActivityTrade(BaseModel):
     profile_image: str = Field(alias="profileImage")  # URL to the user profile image
     profile_image_optimized: Optional[str] = Field(None, alias="profileImageOptimized")
 
-class Comment(BaseModel):
-    id: str  # Unique identifier of comment
-    body: str  # Content of the comment
-    parent_entity_type: str = Field(alias="parentEntityType")  # Type of the parent entity (Event or Series)
-    parent_entity_id: int = Field(alias="parentEntityID")  # ID of the parent entity
-    parent_comment_id: Optional[str] = Field(None, alias="parentCommentID")  # ID of the parent comment
-    user_address: str = Field(alias="userAddress")  # Address of the user
-    reply_address: Optional[str] = Field(None, alias="replyAddress")  # Address of the reply user
-    created_at: datetime = Field(alias="createdAt")  # Creation timestamp
-    updated_at: Optional[datetime] = Field(None, alias="updatedAt")  # Last update timestamp
-
-class Reaction(BaseModel):
-    id: str  # Unique identifier of reaction
-    comment_id: int = Field(alias="commentID")  # ID of the comment
-    reaction_type: str = Field(alias="reactionType")  # Type of the reaction
-    icon: Optional[str] = None  # Icon representing the reaction
-    user_address: str = Field(alias="userAddress")  # Address of the user
-    created_at: datetime = Field(alias="createdAt")  # Creation timestamp
 
 class Request(BaseModel):
     request_id: str = Field(alias="requestId")  # Unique identifier for the request
     proxy_address: str = Field(alias="proxyAddress")  # Proxy address
     user_address: str = Field(alias="userAddress")  # User address
-    condition_id: Keccak256 = Field(alias="market")  # Id of market which is also the CTF condition ID
-    token_id: str = Field(alias="token")  # ERC1155 token ID of conditional token being traded
-    complement_token_id: str = Field(alias="complement")  # Complement ERC1155 token ID of conditional token being traded
-    state: Literal["STATE_REQUEST_EXPIRED", "STATE_USER_CANCELED", "STATE_REQUEST_CANCELED", "STATE_MAKER_CANCELED", "STATE_ACCEPTING_QUOTES", "STATE_REQUEST_QUOTED", "STATE_QUOTE_IMPROVED"]  # Current state of the request
+    condition_id: Keccak256 = Field(
+        alias="market"
+    )  # Id of market which is also the CTF condition ID
+    token_id: str = Field(
+        alias="token"
+    )  # ERC1155 token ID of conditional token being traded
+    complement_token_id: str = Field(
+        alias="complement"
+    )  # Complement ERC1155 token ID of conditional token being traded
+    state: Literal[
+        "STATE_REQUEST_EXPIRED",
+        "STATE_USER_CANCELED",
+        "STATE_REQUEST_CANCELED",
+        "STATE_MAKER_CANCELED",
+        "STATE_ACCEPTING_QUOTES",
+        "STATE_REQUEST_QUOTED",
+        "STATE_QUOTE_IMPROVED",
+    ]  # Current state of the request
     side: Literal["BUY", "SELL"]  # Indicates buy or sell side
     price: float  # Price from in/out sizes
     size_in: float = Field(alias="sizeIn")  # Input size of the request
     size_out: float = Field(alias="sizeOut")  # Output size of the request
     expiry: Optional[datetime] = None
 
+
 class Quote(BaseModel):
     quote_id: str = Field(alias="quoteId")  # Unique identifier for the quote
     request_id: str = Field(alias="requestId")  # Associated request identifier
     proxy_address: str = Field(alias="proxyAddress")  # Proxy address
     user_address: str = Field(alias="userAddress")  # User address
-    condition_id: Keccak256 = Field(alias="condition")  # Id of market which is also the CTF condition ID
-    token_id: str = Field(alias="token")  # ERC1155 token ID of conditional token being traded
-    complement_token_id: str = Field(alias="complement")  # Complement ERC1155 token ID of conditional token being traded
-    state: Literal["STATE_REQUEST_EXPIRED", "STATE_USER_CANCELED", "STATE_REQUEST_CANCELED", "STATE_MAKER_CANCELED", "STATE_ACCEPTING_QUOTES", "STATE_REQUEST_QUOTED", "STATE_QUOTE_IMPROVED"]  # Current state of the quote
+    condition_id: Keccak256 = Field(
+        alias="condition"
+    )  # Id of market which is also the CTF condition ID
+    token_id: str = Field(
+        alias="token"
+    )  # ERC1155 token ID of conditional token being traded
+    complement_token_id: str = Field(
+        alias="complement"
+    )  # Complement ERC1155 token ID of conditional token being traded
+    state: Literal[
+        "STATE_REQUEST_EXPIRED",
+        "STATE_USER_CANCELED",
+        "STATE_REQUEST_CANCELED",
+        "STATE_MAKER_CANCELED",
+        "STATE_ACCEPTING_QUOTES",
+        "STATE_REQUEST_QUOTED",
+        "STATE_QUOTE_IMPROVED",
+    ]  # Current state of the quote
     side: Literal["BUY", "SELL"]  # Indicates buy or sell side
     size_in: float = Field(alias="sizeIn")  # Input size of the quote
     size_out: float = Field(alias="sizeOut")  # Output size of the quote
     expiry: Optional[datetime] = None
 
+
 class CryptoPriceSubscribe(BaseModel):
     data: list[TimeseriesPoint]
     symbol: str
 
+
 class CryptoPriceUpdate(TimeseriesPoint):
     symbol: str
     full_accuracy_value: str
 
+
 class AggOrderBookSummary(OrderBookSummary):
     min_order_size: float
     tick_size: TickSize
     neg_risk: bool
 
+
 class LiveDataClobMarket(BaseModel):
     token_ids: list[str] = Field(alias="asset_ids")
     condition_id: Keccak256 = Field(alias="market")
@@ -198,6 +233,7 @@ class LiveDataClobMarket(BaseModel):
     tick_size: TickSize
     neg_risk: bool
 
+
 # Event models
 class ActivityTradeEvent(BaseModel):
     payload: ActivityTrade
@@ -205,36 +241,44 @@ class ActivityTradeEvent(BaseModel):
     type: Literal["trades"]
     topic: Literal["activity"]
 
+
 class ActivityOrderMatchEvent(BaseModel):
     payload: ActivityTrade
     timestamp: datetime
     type: Literal["orders_matched"]
     topic: Literal["activity"]
 
+
 class CommentEvent(BaseModel):
     payload: Comment
     timestamp: datetime
     type: Literal["comment_created", "comment_removed"]
     topic: Literal["comments"]
 
+
 class ReactionEvent(BaseModel):
     payload: Reaction
     timestamp: datetime
     type: Literal["reaction_created", "reaction_removed"]
     topic: Literal["comments"]
 
+
 class RequestEvent(BaseModel):
     payload: Request
     timestamp: datetime
-    type: Literal["request_created", "request_edited", "request_canceled", "request_expired"]
+    type: Literal[
+        "request_created", "request_edited", "request_canceled", "request_expired"
+    ]
     topic: Literal["rfq"]
 
+
 class QuoteEvent(BaseModel):
     payload: Quote
     timestamp: datetime
     type: Literal["quote_created", "quote_edited", "quote_canceled", "quote_expired"]
     topic: Literal["rfq"]
 
+
 class CryptoPriceUpdateEvent(BaseModel):
     payload: CryptoPriceUpdate
     timestamp: datetime
@@ -242,12 +286,14 @@ class CryptoPriceUpdateEvent(BaseModel):
     type: Literal["update"]
     topic: Literal["crypto_prices", "crypto_prices_chainlink"]
 
+
 class CryptoPriceSubscribeEvent(BaseModel):
     payload: CryptoPriceSubscribe
     timestamp: datetime
     type: Literal["subscribe"]
     topic: Literal["crypto_prices", "crypto_prices_chainlink"]
 
+
 class LiveDataOrderBookSummaryEvent(BaseModel):
     payload: list[AggOrderBookSummary] | AggOrderBookSummary
     timestamp: datetime
@@ -255,6 +301,7 @@ class LiveDataOrderBookSummaryEvent(BaseModel):
     type: Literal["agg_orderbook"]
     topic: Literal["clob_market"]
 
+
 class LiveDataPriceChangeEvent(BaseModel):
     payload: PriceChanges
     timestamp: datetime
@@ -262,6 +309,7 @@ class LiveDataPriceChangeEvent(BaseModel):
     type: Literal["price_change"]
     topic: Literal["clob_market"]
 
+
 class LiveDataLastTradePriceEvent(BaseModel):
     payload: LastTradePrice
     timestamp: datetime
@@ -269,6 +317,7 @@ class LiveDataLastTradePriceEvent(BaseModel):
     type: Literal["last_trade_price"]
     topic: Literal["clob_market"]
 
+
 class LiveDataTickSizeChangeEvent(BaseModel):
     payload: TickSizeChange
     timestamp: datetime
@@ -276,6 +325,7 @@ class LiveDataTickSizeChangeEvent(BaseModel):
     type: Literal["tick_size_change"]
     topic: Literal["clob_market"]
 
+
 class MarketStatusChangeEvent(BaseModel):
     payload: LiveDataClobMarket
     timestamp: datetime
@@ -283,6 +333,7 @@ class MarketStatusChangeEvent(BaseModel):
     type: Literal["market_created", "market_resolved"]
     topic: Literal["clob_market"]
 
+
 class LiveDataOrderEvent(BaseModel):
     payload: OrderEvent
     timestamp: datetime
@@ -290,6 +341,7 @@ class LiveDataOrderEvent(BaseModel):
     type: Literal["order"]
     topic: Literal["clob_user"]
 
+
 class LiveDataTradeEvent(BaseModel):
     payload: TradeEvent
     timestamp: datetime
@@ -297,9 +349,8 @@ class LiveDataTradeEvent(BaseModel):
     type: Literal["trade"]
     topic: Literal["clob_user"]
 
+
 class ErrorEvent(BaseModel):
     message: str
     connection_id: str = Field(alias="connectionId")
     request_id: str = Field(alias="requestId")
-
-

polymarket_apis/utilities/config.py

@@ -26,6 +26,7 @@ NEG_RISK_CONFIG = {
     ),
 }
 
+
 def get_contract_config(chain_id: int, neg_risk: bool = False) -> ContractConfig:
     """Get the contract configuration for the chain."""
     config = NEG_RISK_CONFIG.get(chain_id) if neg_risk else CONFIG.get(chain_id)

polymarket_apis/utilities/exceptions.py

@@ -1,17 +1,22 @@
 class InvalidPriceError(Exception):
     pass
 
+
 class InvalidTickSizeError(Exception):
     pass
 
+
 class InvalidFeeRateError(Exception):
     pass
 
+
 class LiquidityError(Exception):
     pass
 
+
 class MissingOrderbookError(Exception):
     pass
 
+
 class AuthenticationRequiredError(ValueError):
     """Raised when authentication credentials are required but not provided."""

polymarket_apis/utilities/order_builder/builder.py

@@ -54,7 +54,11 @@ class OrderBuilder:
         self.funder = funder if funder is not None else self.signer.address()
 
     def get_order_amounts(
-            self, side: str, size: float, price: float, round_config: RoundConfig,
+        self,
+        side: str,
+        size: float,
+        price: float,
+        round_config: RoundConfig,
     ):
         raw_price = round_normal(price, round_config.price)
 
@@ -88,7 +92,11 @@ class OrderBuilder:
         raise ValueError(msg)
 
     def get_market_order_amounts(
-            self, side: str, amount: float, price: float, round_config: RoundConfig,
+        self,
+        side: str,
+        amount: float,
+        price: float,
+        round_config: RoundConfig,
     ):
         raw_price = round_normal(price, round_config.price)
 
@@ -122,7 +130,9 @@ class OrderBuilder:
         raise ValueError(msg)
 
     def create_order(
-            self, order_args: OrderArgs, options: CreateOrderOptions,
+        self,
+        order_args: OrderArgs,
+        options: CreateOrderOptions,
     ) -> SignedOrder:
         """Creates and signs an order."""
         side, maker_amount, taker_amount = self.get_order_amounts(
@@ -147,7 +157,8 @@ class OrderBuilder:
         )
 
         contract_config = get_contract_config(
-            self.signer.get_chain_id(), options.neg_risk,
+            self.signer.get_chain_id(),
+            options.neg_risk,
         )
 
         order_builder = UtilsOrderBuilder(
@@ -159,7 +170,9 @@ class OrderBuilder:
         return order_builder.build_signed_order(data)
 
     def create_market_order(
-            self, order_args: MarketOrderArgs, options: CreateOrderOptions,
+        self,
+        order_args: MarketOrderArgs,
+        options: CreateOrderOptions,
     ) -> SignedOrder:
         """Creates and signs a market order."""
         side, maker_amount, taker_amount = self.get_market_order_amounts(
@@ -184,7 +197,8 @@ class OrderBuilder:
         )
 
         contract_config = get_contract_config(
-            self.signer.get_chain_id(), options.neg_risk,
+            self.signer.get_chain_id(),
+            options.neg_risk,
         )
 
         order_builder = UtilsOrderBuilder(
@@ -196,10 +210,12 @@ class OrderBuilder:
         return order_builder.build_signed_order(data)
 
     def calculate_buy_market_price(
-            self,
-            asks: list[OrderSummary], # expected to be sorted from worst to best price (high to low)
-            amount_to_match: float, # in usdc
-            order_type: OrderType,
+        self,
+        asks: list[
+            OrderSummary
+        ],  # expected to be sorted from worst to best price (high to low)
+        amount_to_match: float,  # in usdc
+        order_type: OrderType,
     ) -> float:
         if not asks:
             msg = "No ask orders available"
@@ -218,10 +234,12 @@ class OrderBuilder:
         return float(asks[0].price)
 
     def calculate_sell_market_price(
-            self,
-            bids: list[OrderSummary], # expected to be sorted from worst to best price (low to high)
-            amount_to_match: float, # in shares
-            order_type: OrderType,
+        self,
+        bids: list[
+            OrderSummary
+        ],  # expected to be sorted from worst to best price (low to high)
+        amount_to_match: float,  # in shares
+        order_type: OrderType,
     ) -> float:
         if not bids:
             msg = "No bid orders available"
@@ -231,10 +249,8 @@ class OrderBuilder:
         for p in reversed(bids):
             sum += float(p.size)
             if sum >= amount_to_match:
-                print(f"market order price {p.price}")
                 return float(p.price)
 
-
         if order_type == OrderType.FOK:
             msg = "no match"
             raise ValueError(msg)

polymarket_apis/utilities/order_builder/helpers.py

@@ -39,7 +39,6 @@ def decimal_places(x: float) -> int:
     return max(0, -exponent)
 
 
-
 def generate_orderbook_summary_hash(orderbook: OrderBookSummary) -> str:
     """Compute hash while forcing empty string for hash field."""
     server_hash = orderbook.hash

polymarket_apis/utilities/signing/hmac.py

@@ -4,7 +4,11 @@ import hmac
 
 
 def build_hmac_signature(
-    secret: str, timestamp: str, method: str, request_path: str, body=None,
+    secret: str,
+    timestamp: str,
+    method: str,
+    request_path: str,
+    body=None,
 ):
     """Creates an HMAC signature by signing a payload with the secret."""
     base64_secret = base64.urlsafe_b64decode(secret)

polymarket_apis/utilities/web3/abis/custom_contract_errors.py

@@ -28,4 +28,4 @@ CUSTOM_ERROR_DICT = {
     "0xcd7769ff": "NotApprovedForAll()",
     "0x80fee105": "OnlyOracle()",
     "0x155a4b5c": "UnexpectedCollateralToken()",
-    }
+}

polymarket_apis/utilities/web3/helpers.py

@@ -2,6 +2,7 @@ def get_market_index(question_id: str) -> int:
     """Extract the market index from a question ID (last 2 hex characters)."""
     return int(question_id[-2:], 16)
 
+
 def get_index_set(question_ids: list[str]) -> int:
     """Calculate bitwise index set from question IDs."""
     indices = [get_market_index(question_id) for question_id in question_ids]

{polymarket_apis-0.3.0.dist-info → polymarket_apis-0.3.2.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: polymarket-apis
-Version: 0.3.0
-Summary: Unified Polymarket APIs - clob, gamma, data, web3, websockets
+Version: 0.3.2
+Summary: Unified Polymarket APIs with Pydantic data validation - Clob, Gamma, Data, Web3, Websockets, GraphQL clients.
 Author-email: Razvan Gheorghe <razvan@gheorghe.me>
 Requires-Python: >=3.12
 Requires-Dist: gql[httpx]>=4.0.0
@@ -16,7 +16,7 @@ Description-Content-Type: text/markdown
 
 # polymarket-apis [![PyPI version](https://img.shields.io/pypi/v/polymarket-apis.svg)](https://pypi.org/project/polymarket-apis/)
 
-Polymarket CLOB, Gamma, Data, Web3, Websockets and GraphQL clients.
+Unified Polymarket APIs with Pydantic data validation - Clob, Gamma, Data, Web3, Websockets, GraphQL clients.
 
 ## Polymarket Mental Models
 
@@ -47,6 +47,9 @@ flowchart LR
 - **Outcome** — represents a binary option related to a market. (most commonly `Yes`/`No`, but can be e.g. `Paris Saint-Germain`/`Inter Milan` in the case of a match where draws are not possible)
   - Identified by a **`token id`** (e.g. `15353185604353847122370324954202969073036867278400776447048296624042585335546` for the `Yes` outcome in the 1 rate cut in 2025 market)
 
+- The different APIs represent Events/Markets differently (e.g. Event, QueryEvent / ClobMarket, GammaMarket, RewardsMarket) but they all use to the same underlying identifiers.
+
+
 ### Tokens
 - **Tokens** are the blockchain implementation of **Outcomes** - tradable digital assets on the Polygon blockchain that users buy, hold and sell on Polygon. 
 - This helps ensure the logic of binary outcome prediction markets through smart contracts (e.g. collateralization, token prices going to $1.00 or $0.00 after resolution, splits/merges).
@@ -91,15 +94,36 @@ flowchart LR
   ### PolymarketGammaClient - Market/Event related operations
     - #### Market
       - get **GammaMarket** by `market_id`
+      - get **GammaMarket** by `slug`
       - get **GammaMarkets** with pagination (offset and limit), filter by `slug`s, `market_id`s, `token_id`s, `condition_id`s, `tag_id` or filtered by active, closed, archived, liquidity window, volume window, start date window, end date window and ordered
+      - get **Tags** for a **Market** by `market_id`
     - #### Event
       - get **Event** by `event_id`
+      - get **Event** by `slug`
       - get **Events** with pagination, filter by `slug`s, `event_id`s, `tag_id` or filtered by active, closed, archived, liquidity window, volume window, start date window, end date window and ordered
       - get all **Events** given some filtration
-      - search **Events**, filter by text query, active/resolved, sort by volume/volume_24hr/liquidity/start_date/end_date/competitive (tries to mimic the web app search bar)
-    - #### Miscellaneous
+      - search **Events**, **Tags**, **Profiles**, filter by text query, tags, active/resolved, recurrence, sort by volume/volume_24hr/liquidity/start_date/end_date/competitive
       - grok event summary by **Event** `slug`
       - grok election market explanation by candidate name and election title
+      - get **Tags** for an **Event** by `event_id`
+    - #### Tag
+      - get **Tags** with pagination, order by any **Tag** field
+      - get all **Tags**
+      - get **Tag** by `tag_id`
+      - get **Tag** relations by `tag_id` or `slug`
+      - get **Tags** related to a **Tag** by `tag_id` or `slug`
+    - #### Sport
+      - get **Teams** with pagination, filter by `league`, `name`, `abbreviation`
+      - get all **Teams** given some filtration
+      - get **Sports** with pagination, filter by `name`
+      - get **Sports** metadata
+    - #### Series
+      - get **Series** with pagination, filter by `slug`, closed status, order by any **Series** field
+      - get all **Series** given some filtration
+    - #### Comments
+      - get comments by `parent_entity_type` and `parent_entity_id` with pagination, order by any **Comment** field
+      - get comments by `comment_id` - gets all comments in a thread.
+      - get comments by user base address (not proxy address) with pagination, order by any **Comment** field
 
   ### PolymarketDataClient - Portfolio related operations
   - #### Positions
@@ -115,7 +139,12 @@ flowchart LR
       - `condition_ids` is ***None*** → total value of positions
       - `condition_ids` is ***str*** → value of positions on a market
       - `condition_ids` is ***list[str]*** → sum of values of positions on multiple markets
+  - #### Closed positions
+    - get closed positions, filter by condition_ids
   - #### Miscellaneous
+    - get total number of markets traded by user address
+    - get open interest for a list of condition_ids
+    - get live volume for an event by `event_id`
     - get pnl timeseries by user address for a period (1d, 1w, 1m, all) with frequency (1h, 3h, 12h, 1d)
     - get overall pnl/volume by user address for a recent window (1d, 7d, 30d, all)
     - get user rank on the profit/volume leaderboards by user address for a recent window (1d, 7d, 30d, all)

polymarket_apis-0.3.2.dist-info/RECORD

@@ -0,0 +1,41 @@
+polymarket_apis/__init__.py,sha256=UATdxksEshjBCHE_f8Jk666sKjoFUxHIn0T1yDKnfqs,1098
+polymarket_apis/clients/__init__.py,sha256=ruMvFEA4HNkbWEYqbnrCuYXR4PUwkV1XWG0w63we-LA,759
+polymarket_apis/clients/clob_client.py,sha256=dDXkEf31tQnLHC7KsN7UIMfnLDJJFHrJ4VD_WwaTFbI,32102
+polymarket_apis/clients/data_client.py,sha256=SAPxgfWwPK_YuNBOvDxKgUIzdh-hMo2YlnTZ0rFDMXE,12000
+polymarket_apis/clients/gamma_client.py,sha256=_wY5gU-H-qLBHNjaIxxFY7XilYapqUT70hLNRiVFCJI,27566
+polymarket_apis/clients/graphql_client.py,sha256=KgjxbXNWEXp82ZEz464in5mCn1PydnZqWq-g11xu9YU,1839
+polymarket_apis/clients/web3_client.py,sha256=spCZzftMS19D62GBBpIN5I8JosZuNITNXDr7MrGoHwc,12191
+polymarket_apis/clients/websockets_client.py,sha256=gaGcsjqp1ZRyxrL6EWvZ9XaTv7koTPDzlcShj0u0B2A,7737
+polymarket_apis/types/__init__.py,sha256=cyrAPNX0ty0wkMwZqB0lNA7n3JoOJCSeTpclmamMh9k,3258
+polymarket_apis/types/clob_types.py,sha256=xWnHmsYoilJWfkw2Fxga8cUm9JXuymDRYggJhPKt50Q,11744
+polymarket_apis/types/common.py,sha256=RYu6Dfh0HUIogpK_kZ1AQQQEiqQD3hHACU5fMKSUoMU,1003
+polymarket_apis/types/data_types.py,sha256=F6GDhWNtIoQ8kvLvUdlRt596aUfnuc1aHg8m8UweT_M,4641
+polymarket_apis/types/gamma_types.py,sha256=BqoVOfHvTFII3sYkNmjT1S-J-0_R90bVdx_9d5urmMQ,30159
+polymarket_apis/types/websockets_types.py,sha256=XGTpfix2rFFQg-97ZkPagS_tHJJpSnB5mCMf_sT2MOI,11180
+polymarket_apis/utilities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+polymarket_apis/utilities/config.py,sha256=kQymQRy9fVg5jt8CcQJxsSgIZFbfjPx2q_gNnZI5b24,2449
+polymarket_apis/utilities/constants.py,sha256=OdxaAsyYzAK1RXty5VtvidMgan8YW-JfHS3Rdxp6n_U,580
+polymarket_apis/utilities/endpoints.py,sha256=bxZyrJBPbVauWc-eR0RMh6KDqU-SmO_3LfQwVMNJ6vE,1235
+polymarket_apis/utilities/exceptions.py,sha256=nLVkwGNkX8mBhOi3L3lLEJ5UCPd5OBjl2f7kcct3K3A,368
+polymarket_apis/utilities/headers.py,sha256=Cc5WEnIBLYAgfwvmCXRBwA2zUYME8fDy4PbwlwlB6Oo,1510
+polymarket_apis/utilities/order_builder/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+polymarket_apis/utilities/order_builder/builder.py,sha256=1SXgJlKlutRqMA1iBtZcw5K6CWI379d4wXZ5pdNgs0M,8454
+polymarket_apis/utilities/order_builder/helpers.py,sha256=2-UYDLntYOXjyN0ZDQI13jW2zwXwIODEK-smBRFTYRk,1943
+polymarket_apis/utilities/signing/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+polymarket_apis/utilities/signing/eip712.py,sha256=fGLurznnfY5M0VCP1Txyq_FYQRfggyHoTwz-PGIK2Eg,895
+polymarket_apis/utilities/signing/hmac.py,sha256=1VPfO2yT8nyStk6U4AQeyTzQTt5-69PTw24Gdt5YOMo,718
+polymarket_apis/utilities/signing/model.py,sha256=kVduuJGth7WSCUDCVVydCgPd4yEVI85gEmMxohXsvp0,191
+polymarket_apis/utilities/signing/signer.py,sha256=7-nFALFrz0qg4F4lZRyHI41S7IWxr7t0WMLOHqHzJcg,732
+polymarket_apis/utilities/web3/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+polymarket_apis/utilities/web3/helpers.py,sha256=EZ5FiU54vCMeRQMSXbCDWAiGqrFRd1rS7D_CtUn8fHQ,404
+polymarket_apis/utilities/web3/abis/CTFExchange.json,sha256=zt8fZnUaOrD8Vh5njM0EEUpeITWhuu0SZrIZigWxgV8,38499
+polymarket_apis/utilities/web3/abis/ConditionalTokens.json,sha256=3TUcX7He74VMkoL1kxbDbtULZ70VY_EBe01pfByprsk,12584
+polymarket_apis/utilities/web3/abis/NegRiskAdapter.json,sha256=HABIoRF1s1NgctpRTdaaNDqzODzgdZLE-s2E6ef4nAY,18867
+polymarket_apis/utilities/web3/abis/NegRiskCtfExchange.json,sha256=QOgLKekWnPVcMGXExcLjEIOHLS89tPUoZFkVm-yRnbY,38612
+polymarket_apis/utilities/web3/abis/ProxyWalletFactory.json,sha256=5KjBHUWdkc_kdlWPNax84o1vStpFuLgZKTMn3jc4zvU,5553
+polymarket_apis/utilities/web3/abis/UChildERC20Proxy.json,sha256=ZyQC38U0uxInlmnW2VXDVD3TJfTIRmSNMkTxQsaG7oA,27396
+polymarket_apis/utilities/web3/abis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+polymarket_apis/utilities/web3/abis/custom_contract_errors.py,sha256=GjCVn2b6iRheT7s-kc8Po9uwH9LfaHA1yRpJyjXRcxs,1172
+polymarket_apis-0.3.2.dist-info/METADATA,sha256=9ov4uwnSra_kcTD31KLg977T82YnN56HPiPKqQ6ERVY,12086
+polymarket_apis-0.3.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+polymarket_apis-0.3.2.dist-info/RECORD,,