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

polymarket_apis/__init__.py

@@ -10,7 +10,7 @@ This package provides a comprehensive interface to Polymarket's APIs including:
 - GraphQL API for flexible data queries
 """
 
-__version__ = "0.3.3"
+__version__ = "0.3.5"
 __author__ = "Razvan Gheorghe"
 __email__ = "razvan@gheorghe.me"
 

polymarket_apis/clients/clob_client.py

@@ -1,6 +1,6 @@
 import json
 import logging
-from datetime import UTC, datetime
+from datetime import UTC, datetime, timedelta
 from typing import Literal, Optional
 from urllib.parse import urljoin
 
@@ -349,12 +349,21 @@ class PolymarketClobClient:
     def get_recent_history(
         self,
         token_id: str,
-        interval: Optional[Literal["1d", "6h", "1h"]] = "1d",
+        interval: Literal["1h", "6h", "1d", "1w", "1m", "max"] = "1d",
         fidelity: int = 1,  # resolution in minutes
     ) -> PriceHistory:
-        """Get the recent price history of a token (up to now) - 1h, 6h, 1d."""
-        if fidelity < 1:
-            msg = f"invalid filters: minimum 'fidelity' for '{interval}' range is 1"
+        """Get the recent price history of a token (up to now) - 1h, 6h, 1d, 1w, 1m."""
+        min_fidelities: dict[str, int] = {
+            "1h": 1,
+            "6h": 1,
+            "1d": 1,
+            "1w": 5,
+            "1m": 10,
+            "max": 2,
+        }
+
+        if fidelity < min_fidelities.get(interval):
+            msg = f"invalid filters: minimum 'fidelity' for '{interval}' range is {min_fidelities.get(interval)}"
             raise ValueError(msg)
 
         params = {
@@ -371,38 +380,41 @@ class PolymarketClobClient:
         token_id: str,
         start_time: Optional[datetime] = None,
         end_time: Optional[datetime] = None,
-        interval: Literal["max", "1m", "1w"] = "max",
         fidelity: int = 2,  # resolution in minutes
     ) -> PriceHistory:
-        """Get the price history of a token between selected dates - 1m, 1w, max."""
-        min_fidelities: dict[str, int] = {"1m": 10, "1w": 5, "max": 2}
-
-        if fidelity is None or fidelity < min_fidelities[interval]:
-            msg = f"invalid filters: minimum 'fidelity' for '{interval}' range is {min_fidelities[interval]}"
-            raise ValueError(msg)
-
+        """Get the price history of a token between a selected date range of max 15 days or from start_time to now."""
         if start_time is None and end_time is None:
-            msg = "At least one of 'start_time' or 'end_time' must be provided."
+            msg = "At least 'start_time' or ('start_time' and 'end_time') must be provided"
             raise ValueError(msg)
 
-        # Default values for timestamps if one is not provided
-
-        if start_time is None:
-            start_time = datetime(2020, 1, 1, tzinfo=UTC)  # Default start time
-        if end_time is None:
-            end_time = datetime.now(UTC)  # Default end time
+        if (
+            start_time
+            and end_time
+            and start_time + timedelta(days=15, seconds=1) < end_time
+        ):
+            msg = "'start_time' - 'end_time' range cannot exceed 15 days. Remove 'end_time' to get prices up to now or set a shorter range."
+            raise ValueError(msg)
 
         params = {
             "market": token_id,
-            "startTs": int(start_time.timestamp()),
-            "endTs": int(end_time.timestamp()),
-            "interval": interval,
             "fidelity": fidelity,
         }
+        if start_time:
+            params["startTs"] = int(start_time.timestamp())
+        if end_time:
+            params["endTs"] = int(end_time.timestamp())
+
         response = self.client.get(self._build_url("/prices-history"), params=params)
         response.raise_for_status()
         return PriceHistory(**response.json(), token_id=token_id)
 
+    def get_all_history(self, token_id: str) -> PriceHistory:
+        """Get the full price history of a token."""
+        return self.get_history(
+            token_id=token_id,
+            start_time=datetime(2020, 1, 1, tzinfo=UTC),
+        )
+
     def get_orders(
         self,
         order_id: Optional[str] = None,

polymarket_apis/types/common.py

@@ -3,7 +3,7 @@ from datetime import UTC, datetime
 from typing import Annotated
 
 from dateutil import parser
-from pydantic import AfterValidator, BaseModel, BeforeValidator, Field
+from pydantic import AfterValidator, BaseModel, BeforeValidator, ConfigDict, Field
 
 
 def validate_keccak256(v: str) -> str:
@@ -30,5 +30,7 @@ EmptyString = Annotated[str, Field(pattern=r"^$", description="An empty string")
 
 
 class TimeseriesPoint(BaseModel):
-    value: float
-    timestamp: datetime
+    model_config = ConfigDict(populate_by_name=True)
+
+    value: float = Field(alias="p")
+    timestamp: datetime = Field(alias="t")

polymarket_apis/utilities/web3/helpers.py

@@ -28,7 +28,7 @@ def _pack_primitive(typ: str, val: Any) -> bytes:
         raw = val
 
     if typ == "string":
-        if not isinstance(raw, (bytes, str)):
+        if not isinstance(raw, bytes | str):
             msg = "string value must be str or bytes"
             raise TypeError(msg)
         return raw.encode() if isinstance(raw, str) else raw
@@ -47,7 +47,7 @@ def _pack_primitive(typ: str, val: Any) -> bytes:
             b = raw.to_bytes(n, "big")
         elif isinstance(raw, str) and raw.startswith("0x"):
             b = bytes.fromhex(raw[2:])
-        elif isinstance(raw, (bytes, bytearray)):
+        elif isinstance(raw, bytes | bytearray):
             b = bytes(raw)
         else:
             msg = f"unsupported value for {typ}"
@@ -63,7 +63,7 @@ def _pack_primitive(typ: str, val: Any) -> bytes:
             addr = raw[2:]
         elif isinstance(raw, str):
             addr = raw
-        elif isinstance(raw, (bytes, bytearray)):
+        elif isinstance(raw, bytes | bytearray):
             return bytes(raw[-20:])
         else:
             msg = "address must be hex string or bytes"
@@ -75,7 +75,7 @@ def _pack_primitive(typ: str, val: Any) -> bytes:
     if m:
         bits = int(m.group(1)) if m.group(1) else 256
         size = bits // 8
-        if isinstance(raw, (bytes, bytearray)):
+        if isinstance(raw, bytes | bytearray):
             intval = int.from_bytes(raw, "big")
         elif isinstance(raw, str) and raw.startswith("0x"):
             intval = int(raw, 16)

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

@@ -1,7 +1,8 @@
 Metadata-Version: 2.4
 Name: polymarket-apis
-Version: 0.3.3
+Version: 0.3.5
 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>
 Requires-Python: >=3.12
 Requires-Dist: gql[httpx]>=4.0.0
@@ -10,6 +11,7 @@ Requires-Dist: lomond>=0.3.3
 Requires-Dist: poly-eip712-structs>=0.0.1
 Requires-Dist: py-order-utils>=0.3.2
 Requires-Dist: pydantic>=2.10.5
+Requires-Dist: python-dateutil>=2.9.0
 Requires-Dist: web3>=7.0
 Requires-Dist: wsaccel>=0.6.7
 Description-Content-Type: text/markdown
@@ -87,7 +89,9 @@ flowchart LR
     - check if a **Market** offers rewards by `condition_id` - **get_market_rewards()**
     - get all active markets that offer rewards sorted by different metrics and ordered, filtered by a query, show your favourites from the web app  - **get_reward_markets()** (*naming would do with some work*)
   - #### Miscellaneous
-    - get price history
+    - get recent price history by `token_id` in the last 1h, 6h, 1d, 1w, 1m
+    - get price history by `token_id` in start/end interval
+    - get all price history by `token_id` in 2 min increments
     - get **ClobMarket** by `condition_id`
     - get all **ClobMarkets**
 

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

@@ -1,6 +1,6 @@
-polymarket_apis/__init__.py,sha256=hhFBeFCjzptC4uFwwYbCYjh_-8URUhOUeP_elZeCbVw,1126
+polymarket_apis/__init__.py,sha256=Qsw7dvWt7VBTSIGwDJ-TFkWTa1pgTAYCqz9WFnlQGwg,1126
 polymarket_apis/clients/__init__.py,sha256=ruMvFEA4HNkbWEYqbnrCuYXR4PUwkV1XWG0w63we-LA,759
-polymarket_apis/clients/clob_client.py,sha256=dDXkEf31tQnLHC7KsN7UIMfnLDJJFHrJ4VD_WwaTFbI,32102
+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/graphql_client.py,sha256=KgjxbXNWEXp82ZEz464in5mCn1PydnZqWq-g11xu9YU,1839
@@ -8,7 +8,7 @@ polymarket_apis/clients/web3_client.py,sha256=J3j7T39cgZVb4PrYs7FoPoasO3PBP_7SbS
 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=RYu6Dfh0HUIogpK_kZ1AQQQEiqQD3hHACU5fMKSUoMU,1003
+polymarket_apis/types/common.py,sha256=zFo10eBj4_3alOhYSilCm6Dh5ZkzhrdR9nuRSDQ_od8,1107
 polymarket_apis/types/data_types.py,sha256=F6GDhWNtIoQ8kvLvUdlRt596aUfnuc1aHg8m8UweT_M,4641
 polymarket_apis/types/gamma_types.py,sha256=MoIUI6csqEp_vij7mkFi2IlIA99c5UNzI3zODSONWzQ,30641
 polymarket_apis/types/websockets_types.py,sha256=XGTpfix2rFFQg-97ZkPagS_tHJJpSnB5mCMf_sT2MOI,11180
@@ -27,7 +27,7 @@ polymarket_apis/utilities/signing/hmac.py,sha256=1VPfO2yT8nyStk6U4AQeyTzQTt5-69P
 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=QEpBaA_g7DRzFUZAfiKr6kg5T5_u5FaVZ0mGGNzo6mo,4698
+polymarket_apis/utilities/web3/helpers.py,sha256=qzQA-n9rHbuFk57olvBa8P_T6IzrUsaQ2Vv0887EX4o,4694
 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
@@ -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.3.dist-info/METADATA,sha256=5jvX-fOSD09sCoWwBuBEPh_LFDhB4u3nzGVKfPXzRPk,12193
-polymarket_apis-0.3.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-polymarket_apis-0.3.3.dist-info/RECORD,,
+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,,