polymarket-apis 0.3.5__py3-none-any.whl → 0.3.7__py3-none-any.whl

polymarket_apis/types/clob_types.py

@@ -221,7 +221,7 @@ class ClobMarket(BaseModel):
     @classmethod
     def validate_neg_risk_fields(
         cls, value: str, handler: ValidatorFunctionWrapHandler, info: ValidationInfo
-    ) -> Optional[str]:
+    ) -> str | None:
         try:
             return handler(value)
         except ValidationError as e:
@@ -238,6 +238,7 @@ class ClobMarket(BaseModel):
                         f" Question: {info.data.get('question')}; Market slug: {info.data.get('market_slug')} \n"
                     )
                     logger.warning(msg)
+            return None
 
     @field_validator("condition_id", "question_id", mode="wrap")
     @classmethod
@@ -323,8 +324,8 @@ class DropNotificationParams(BaseModel):
 
 
 class OrderSummary(BaseModel):
-    price: Optional[float] = None
-    size: Optional[float] = None
+    price: float
+    size: float
 
 
 class PriceLevel(OrderSummary):
@@ -505,7 +506,7 @@ class OrderPostResponse(BaseModel):
     order_id: Union[Keccak256, Literal[""]] = Field(alias="orderID")
     taking_amount: str = Field(alias="takingAmount")
     making_amount: str = Field(alias="makingAmount")
-    status: str = Literal["live", "matched", "delayed"]
+    status: Literal["live", "matched", "delayed"]
     success: bool
 
 

polymarket_apis/types/common.py

@@ -19,7 +19,11 @@ def parse_flexible_datetime(v: str | datetime) -> datetime:
         return datetime.fromtimestamp(0, tz=UTC)
 
     if isinstance(v, str):
-        return parser.parse(v)
+        parsed = parser.parse(v)
+        if not isinstance(parsed, datetime):
+            msg = f"Failed to parse '{v}' as datetime, got {type(parsed)}"
+            raise TypeError(msg)
+        return parsed
     return v
 
 

polymarket_apis/types/data_types.py

@@ -1,11 +1,43 @@
 from datetime import UTC, datetime
 from typing import Literal, Optional
 
-from pydantic import BaseModel, Field, field_validator
+from pydantic import BaseModel, Field, field_validator, model_validator
 
 from .common import EmptyString, EthAddress, Keccak256
 
 
+class GQLPosition(BaseModel):
+    user: EthAddress
+    token_id: str
+    complementary_token_id: str
+    condition_id: Keccak256
+    outcome_index: int
+    balance: float
+
+    @model_validator(mode="before")
+    def _flatten(cls, values):
+        asset = values.get("asset")
+        if isinstance(asset, dict):
+            if "id" in asset:
+                values.setdefault("token_id", asset["id"])
+            if "complement" in asset:
+                values.setdefault("complementary_token_id", asset["complement"])
+            condition = asset.get("condition")
+            if isinstance(condition, dict) and "id" in condition:
+                values.setdefault("condition_id", condition["id"])
+            if "outcomeIndex" in asset:
+                values.setdefault("outcome_index", asset["outcomeIndex"])
+            values.pop("asset", None)
+        return values
+
+    @field_validator("balance", mode="before")
+    @classmethod
+    def _parse_balance(cls, value):
+        if isinstance(value, str):
+            value = int(value)
+        return value / 10**6
+
+
 class Position(BaseModel):
     # User identification
     proxy_wallet: EthAddress = Field(alias="proxyWallet")

polymarket_apis/utilities/constants.py

@@ -1,3 +1,5 @@
+from typing import Literal
+
 # Access levels
 L0 = 0
 L1 = 1
@@ -17,9 +19,8 @@ L2_AUTH_UNAVAILABLE = "API Credentials are needed to interact with this endpoint
 ADDRESS_ZERO = "0x0000000000000000000000000000000000000000"
 HASH_ZERO = "0x0000000000000000000000000000000000000000000000000000000000000000"
 
-AMOY = 80002
-POLYGON = 137
-
+AMOY: Literal[80002] = 80002
+POLYGON: Literal[137] = 137
 END_CURSOR = "LTE="
 
 BUY = "BUY"

polymarket_apis/utilities/order_builder/builder.py

@@ -221,10 +221,10 @@ class OrderBuilder:
             msg = "No ask orders available"
             raise LiquidityError(msg)
 
-        sum = 0
+        amount = 0.0
         for p in reversed(asks):
-            sum += float(p.size) * float(p.price)
-            if sum >= amount_to_match:
+            amount += float(p.size) * float(p.price)
+            if amount >= amount_to_match:
                 return float(p.price)
 
         if order_type == OrderType.FOK:
@@ -245,10 +245,10 @@ class OrderBuilder:
             msg = "No bid orders available"
             raise LiquidityError(msg)
 
-        sum = 0
+        amount = 0.0
         for p in reversed(bids):
-            sum += float(p.size)
-            if sum >= amount_to_match:
+            amount += float(p.size)
+            if amount >= amount_to_match:
                 return float(p.price)
 
         if order_type == OrderType.FOK:

polymarket_apis/utilities/signing/signer.py

@@ -11,7 +11,7 @@ class Signer:
             raise ValueError(msg)
 
         self.private_key = private_key
-        self.account = Account.from_key(private_key)
+        self.account = Account.from_key(private_key)  # type: ignore[misc]
         self.chain_id = chain_id
 
     def address(self):
@@ -22,4 +22,4 @@ class Signer:
 
     def sign(self, message_hash):
         """Signs a message hash."""
-        return Account.unsafe_sign_hash(message_hash, self.private_key).signature.hex()
+        return Account.unsafe_sign_hash(message_hash, self.private_key).signature.hex()  # type: ignore[misc]

{polymarket_apis-0.3.5.dist-info → polymarket_apis-0.3.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: polymarket-apis
-Version: 0.3.5
+Version: 0.3.7
 Summary: Unified Polymarket APIs with Pydantic data validation - Clob, Gamma, Data, Web3, Websockets, GraphQL clients.
 Project-URL: repository, https://github.com/qualiaenjoyer/polymarket-apis
 Author-email: Razvan Gheorghe <razvan@gheorghe.me>
@@ -155,7 +155,10 @@ flowchart LR
     - get top users on the profit/volume leaderboards (at most 100) for a recent window (1d, 7d, 30d, all)
 
   ### PolymarketWeb3Client - Blockchain related operations
-  - #### Supporting both Email/Magic wallets (signature_type=1) and Safe/Gnosis wallets (signature_type=2)
+  - #### Supporting EOA(signature_type=0), Email/Magic wallets (signature_type=1) and Safe/Gnosis wallets (signature_type=2)
+  - #### Approvals
+    - set approvals for all needed usdc and conditional token spenders (needed for full trading functionality)
+      - Safe/Gnosis wallets need to be deployed beforehand, either via "Enable Trading" pop-up on the web UI or by calling createProxy on the SafeWalletFactory contract (wip)
   - #### Balance
     - get usdc balance by user address
     - get token balance by `token_id` and user address

{polymarket_apis-0.3.5.dist-info → polymarket_apis-0.3.7.dist-info}/RECORD

@@ -1,31 +1,31 @@
-polymarket_apis/__init__.py,sha256=Qsw7dvWt7VBTSIGwDJ-TFkWTa1pgTAYCqz9WFnlQGwg,1126
+polymarket_apis/__init__.py,sha256=OzhWc-PqnHoGyrcRwclQG2mLGSu0cz7QLuhx-jenzgk,1126
 polymarket_apis/clients/__init__.py,sha256=ruMvFEA4HNkbWEYqbnrCuYXR4PUwkV1XWG0w63we-LA,759
-polymarket_apis/clients/clob_client.py,sha256=jtPt3xOrywUSKRKDqChpKgTABlIOBQdV7tbfxsBl008,32400
-polymarket_apis/clients/data_client.py,sha256=SAPxgfWwPK_YuNBOvDxKgUIzdh-hMo2YlnTZ0rFDMXE,12000
-polymarket_apis/clients/gamma_client.py,sha256=tBR_z03c3wh1_sxFbjNx54DcrFEjFB0TmJiOYNUc_pk,27632
+polymarket_apis/clients/clob_client.py,sha256=Eo5zXYtI_Ct0EByzjJnH6h7FLHOqheXDujBA57CtINw,32485
+polymarket_apis/clients/data_client.py,sha256=0--2W6_DZtC7cRud8OYS7bH2heWzn2NwvcUVK3PyEwU,13242
+polymarket_apis/clients/gamma_client.py,sha256=iDfuaClhRK2Y5v8ZA03Qbne3CnIM4JJolHo-qUrQV78,27633
 polymarket_apis/clients/graphql_client.py,sha256=KgjxbXNWEXp82ZEz464in5mCn1PydnZqWq-g11xu9YU,1839
-polymarket_apis/clients/web3_client.py,sha256=J3j7T39cgZVb4PrYs7FoPoasO3PBP_7SbSuQzA--m64,20162
+polymarket_apis/clients/web3_client.py,sha256=Xsk1APsnMDRu9daLKZnf6LW41LdocuRV9rqjKnZjYmw,26400
 polymarket_apis/clients/websockets_client.py,sha256=gaGcsjqp1ZRyxrL6EWvZ9XaTv7koTPDzlcShj0u0B2A,7737
 polymarket_apis/types/__init__.py,sha256=cyrAPNX0ty0wkMwZqB0lNA7n3JoOJCSeTpclmamMh9k,3258
-polymarket_apis/types/clob_types.py,sha256=PmD_afx7zowX0cFJ39PQQ4jywGtwNjLfoke1H7iZZnI,11744
-polymarket_apis/types/common.py,sha256=zFo10eBj4_3alOhYSilCm6Dh5ZkzhrdR9nuRSDQ_od8,1107
-polymarket_apis/types/data_types.py,sha256=F6GDhWNtIoQ8kvLvUdlRt596aUfnuc1aHg8m8UweT_M,4641
+polymarket_apis/types/clob_types.py,sha256=WZs370ni2B2UsLW-yIPGA2C-z8dfbywX26vADuu2YFc,11725
+polymarket_apis/types/common.py,sha256=OYvn-BIbLM5YHNiZCi9ttqbqfPjRdvFhBE192EsBIdQ,1284
+polymarket_apis/types/data_types.py,sha256=vBElvARw8LkH2xXwJkVErpQo0FkXJA3b44hKD5clSOI,5729
 polymarket_apis/types/gamma_types.py,sha256=MoIUI6csqEp_vij7mkFi2IlIA99c5UNzI3zODSONWzQ,30641
 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=rGX-XXu5tLy2yUurFQCQNRtSvZPPcRAUCmjlqVtTAvY,580
+polymarket_apis/utilities/constants.py,sha256=TzFVtN8zNgvEa4yjLWjpvPYsAi1LLV5oPEnHlbwxSDQ,637
 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/builder.py,sha256=dyxKhMeNjGyHXEIFBBZhWwI8TaQQcE_ErQ4sF6BcMX0,8476
 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/signing/signer.py,sha256=cxjcYRn1a0ApVcir1AvamsFcLZ0rYNlEEX4sPUz_Nrw,776
 polymarket_apis/utilities/web3/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 polymarket_apis/utilities/web3/helpers.py,sha256=qzQA-n9rHbuFk57olvBa8P_T6IzrUsaQ2Vv0887EX4o,4694
 polymarket_apis/utilities/web3/abis/CTFExchange.json,sha256=zt8fZnUaOrD8Vh5njM0EEUpeITWhuu0SZrIZigWxgV8,38499
@@ -38,6 +38,6 @@ polymarket_apis/utilities/web3/abis/SafeProxyFactory.json,sha256=bdr2WdYCRClXLTT
 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.5.dist-info/METADATA,sha256=omavoehsTPIj6xjEvkp5gbU5TSZhUG827ROn9_S6xNk,12479
-polymarket_apis-0.3.5.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-polymarket_apis-0.3.5.dist-info/RECORD,,
+polymarket_apis-0.3.7.dist-info/METADATA,sha256=Z3jOxzSY7thon83qiZQbeZ_8sCebx2BKCVRKR-acFjA,12802
+polymarket_apis-0.3.7.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+polymarket_apis-0.3.7.dist-info/RECORD,,