synmax-api-python-client 4.14.0__py3-none-any.whl → 4.16.0__py3-none-any.whl

synmax/hyperion/v4/hyperion_client.pyi

@@ -56,6 +56,9 @@ class HyperionApiClient:
     def fetch_tils(self) -> Result:
         """TIL monitoring data."""
         ...
+    def fetch_tils_expanded(self) -> Result:
+        """Expanded TIL monitoring data."""
+        ...
     def wells(self,aggregate_by: list[Literal['county', 'date_first_production', 'date_spud', 'operator', 'region_natgas', 'state_code', 'sub_region_natgas', 'produced_formation', 'produced_basin']] = ...,county: Union[list[str], str] = ...,date_spud_min: Any = ...,date_spud_max: Any = ...,date_first_production_min: Any = ...,date_first_production_max: Any = ...,depth_min: float = ...,depth_max: float = ...,horizontal_length_min: float = ...,horizontal_length_max: float = ...,lat_surface_min: float = ...,lat_surface_max: float = ...,lon_surface_min: float = ...,lon_surface_max: float = ...,operator: Union[list[str], str] = ...,region_natgas: Union[list[str], str] = ...,state_code: Union[list[str], str] = ...,sub_region_natgas: Union[list[str], str] = ...,well_id: Union[list[str], str] = ...,wellpad_id: Union[list[int], int] = ...,produced_formation: Union[list[str], str] = ...,produced_basin: Union[list[str], str] = ...,response_fields: list[str] = ...) -> Result:
         """Well level details. Well level data derived from all sources."""
         ...

synmax/hyperion/v4/openapi.yaml

@@ -777,6 +777,19 @@ paths:
               schema: { $ref: '#/components/schemas/TilsResponse' }
             application/x-ndjson:
               schema: { $ref: '#/components/schemas/TilsResponse' }
+  /tilsexpanded:
+    get:
+      x-method-name: fetch_tils_expanded
+      summary: Expanded TIL monitoring data.
+      security: [ApiKeyAuth: [dtil_expansion]]
+      responses:
+        '200':
+          description: Success
+          content:
+            application/json:
+              schema: { $ref: '#/components/schemas/TilsExpandedResponse' }
+            application/x-ndjson:
+              schema: { $ref: '#/components/schemas/TilsExpandedResponse' }
   /wells:
     post:
       x-method-name: wells
@@ -1785,6 +1798,22 @@ components:
         sub_region_natgas: { $ref: '#/components/schemas/sub_region_natgas' }
         wellpad_id: { type: string, description: "The unique identifier for the wellpad" }
         wells: { type: integer, description: "The number of wells" }
+    TilsExpandedResponse:
+      type: object
+      properties:
+        date_frac_end:
+          allOf:
+            - $ref: '#/components/schemas/date'
+          description: The date observed via satellite that the well crew completed fracking  in YYYY-MM-DD format
+        date_til: 
+          allOf:
+            - $ref: '#/components/schemas/date'
+          description: Expected TIL date in YYYY-MM-DD format
+        operator: { $ref: '#/components/schemas/operator' }
+        prod_wet_gas_bcf_day: { type: number, description: "Daily wet gas production in billion cubic feet" }
+        sub_region_natgas: { $ref: '#/components/schemas/sub_region_natgas' }
+        wellpad_id: { type: string, description: "The unique identifier for the wellpad" }
+        wells: { type: integer, description: "The number of wells" }
     TransactionsResponse:
       type: object
       properties:

synmax/hyperion/v4/start_hyperion_client.py

@@ -15,9 +15,13 @@ from synmax.hyperion.v4 import HyperionApiClient
 
 SYNMAX_ACCESS_TOKEN = "eyJwcm9qZWN0X2lkIjogIlN5bm1heCBjb21tZXJjaWFsIEFQSSIsICJwcml2YXRlX2tleSI6ICIwQndzX0ExMFpkdVQyaWlNLS1lbXh3Mk5BNUkxa09kdFNVai04RjVvNzU4IiwgImNsaWVudF9pZCI6ICJGZWxpeCBLZXkiLCAidHlwZSI6ICJvbmVfeWVhcl9saWNlbnNlZF9jdXN0b21lciIsICJzdGFydF9kYXRlIjogIjAzLzE5LzIwMjQiLCAiZW5kX2RhdGUiOiAiMDMvMTkvMjAyNSIsICJ0cmlhbF9saWNlbnNlIjogZmFsc2UsICJpc3N1ZV9kYXRldGltZSI6ICIxOS0wMy0yMDI0IDE0OjI0OjA4IiwgImFkbWluX3VzZXIiOiBmYWxzZSwgInVzZXJfcm9sZXMiOiBbImh5cGVyaW9uIiwgInZ1bGNhbiJdfQ=="
 hyperion_api_client = HyperionApiClient(access_token=SYNMAX_ACCESS_TOKEN)
-
-wells_resp = hyperion_api_client.wells(response_fields=["county", "date_completion", "date_first_production", "date_permit", "date_spud", "depth_measured", "depth_tvd", "horizontal_length", "lat_bottomhole", "lon_bottomhole", "lat_surface", "lon_surface", "operator", "region_natgas", "state_code", "sub_region_natgas", "well_id", "wellbore_type", "wellpad_id", "produced_formation", "produced_basin"], date_first_production_min="2023-01-31", date_first_production_max="2024-09-01")
-
-wells_df = wells_resp.df()
-wells_df.head()
-print(wells_df)
+hyperion_api_client._write_stub()
+
+# wells_resp = hyperion_api_client.wells(response_fields=["county", "date_completion", "date_first_production", "date_permit", "date_spud", "depth_measured", "depth_tvd", "horizontal_length", "lat_bottomhole", "lon_bottomhole", "lat_surface", "lon_surface", "operator", "region_natgas", "state_code", "sub_region_natgas", "well_id", "wellbore_type", "wellpad_id", "produced_formation", "produced_basin"], date_first_production_min="2023-01-31", date_first_production_max="2024-09-01")
+results = hyperion_api_client.fetch_tils_expanded()
+results_df = results.df()
+results_df.head()
+print(results_df)
+# wells_df = wells_resp.df()
+# wells_df.head()
+# print(wells_df)

synmax/vulcan/v2/openapi.yaml

@@ -197,12 +197,34 @@ paths:
           content:
             application/json:
               schema: { $ref: '#/components/schemas/ErrorResponse' }
+
+  /infrastructure_watch_extended:
+    get:
+      operationId: routes.v2.infrastructure_watch_extended.get
+      x-method-name: infrastructure_watch_extended
+      summary: Get infrastructure watch extended data (Middle East conflict)
+      security: [ApiKeyAuth: [vulcan_infrastructure_watch_extended]]
+      responses:
+        '200':
+          description: Infrastructure watch extended data
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: '#/components/schemas/InfrastructureWatchExtendedResponse'
+        '500':
+          description: Internal Server Error - Database error
+          content:
+            application/json:
+              schema: { $ref: '#/components/schemas/ErrorResponse' }
+
   /beta/query_datalinks:
     post:
       x-method-name: beta_query_datalinks
       security: [ApiKeyAuth: [hyperion]]
       summary: Execute SQL queries against SynMax datalinks
-      description: Execute T-SQL queries directly against SynMax's 5 datalinks (19 tables). Returns query results as structured data.
+      description: Execute T-SQL queries directly against SynMax's datalinks. Returns query results as structured data.
       requestBody:
         required: true
         content:
@@ -215,7 +237,7 @@ paths:
                 query:
                   type: string
                   description: SQL query to execute. Tables must use {linkid}_{table} format. Use ANSI SQL (LIMIT not TOP).
-                  example: "SELECT * FROM 1005_v_pipeline_flow WHERE gas_day >= '2024-01-01' LIMIT 100"
+                  example: "SELECT * FROM v_pipeline_flow WHERE gas_day >= '2024-01-01' LIMIT 100"
                 session_id:
                   type: string
                   description: Optional session ID for logging/tracking. Auto-generated if not provided.
@@ -479,6 +501,11 @@ components:
           description: ISO date on which the record was created
           example: "2023-01-01T12:00:00Z"
           nullable: true
+        btm_generation:
+          type: boolean
+          description: Indicates if the data center has behind-the-meter generation
+          example: true
+          nullable: true
       required:
         - synmax_id
 
@@ -662,6 +689,11 @@ components:
           example: "4/14/2025"
           description: Date of the latest available satellite image
           nullable: true
+        county:
+          type: string
+          example: "Fayette"
+          description: Plant county - Provided by EIA
+          nullable: true
         latitude:
           type: number
           format: float
@@ -1379,6 +1411,100 @@ components:
           example: "2025-11-17"
           description: ISO date on which the record was last modified
           nullable: true
+          
+    InfrastructureWatchExtendedResponse:
+      type: object
+      properties:
+        site_id:
+          type: string
+          format: uuid
+          example: "f47ac10b-58cc-4372-a567-0e02b2c3d479"
+          description: Unique UUID identifying the infrastructure site.
+          nullable: false
+        site_name:
+          type: string
+          example: "South Pars"
+          description: Name of the tracked infrastructure site.
+          nullable: false
+        vulcan_assessment:
+          type: string
+          example: "visual change"
+          description: The latest visual or operational assessment of the site (e.g., no change, visual change).
+          nullable: false
+        vulcan_assessment_datetime:
+          type: string
+          format: date-time
+          example: "2026-03-05T20:00:00Z"
+          description: ISO-8601 timestamp of when the assessment was conducted.
+          nullable: false
+        additional_notes:
+          type: string
+          example: "site fires and scarring detected near LNG trains"
+          description: Additional context or observations regarding the assessment.
+          nullable: true
+        country:
+          type: string
+          example: "Iran"
+          description: Country where the infrastructure is located.
+          nullable: false
+        country_code:
+          type: string
+          example: "IR"
+          description: ISO country code of the location.
+          nullable: false
+        technology:
+          type: string
+          example: "Oil/Gas Processing"
+          description: The primary industry or technology type of the site.
+          nullable: true
+        capacity:
+          type: number
+          format: float
+          example: 730.0
+          description: Operational capacity of the infrastructure.
+          nullable: true
+        capacity_unit:
+          type: string
+          example: "MMcm/d"
+          description: Unit of measurement for the capacity.
+          nullable: true
+        latitude:
+          type: number
+          format: double
+          example: 27.508
+          description: Latitude of the site in decimal degrees.
+          nullable: false
+        longitude:
+          type: number
+          format: double
+          example: 52.575
+          description: Longitude of the site in decimal degrees.
+          nullable: false
+        location_wkt:
+          type: string
+          example: "POINT(52.575 27.508)"
+          description: Well-Known Text (WKT) spatial representation of the site coordinates (Longitude Latitude).
+          nullable: false
+        image_benchmark_datetime:
+          type: string
+          format: date-time
+          example: "2026-03-05T21:00:00Z"
+          description: ISO-8601 timestamp of the baseline image used for comparison.
+          nullable: true
+        image_acquisition_datetime:
+          type: string
+          format: date-time
+          example: "2026-03-05T20:00:00Z"
+          description: ISO-8601 timestamp of when the newest satellite image was acquired.
+          nullable: true
+        image_source:
+          type: string
+          example: "Planet"
+          description: Provider of the satellite imagery.
+          nullable: true
+        image_resolution:
+          type: string
+          example: "10m"
 
     ErrorResponse:
       type: object

synmax/vulcan/v2/start_vulcan_client.py

@@ -11,17 +11,18 @@ claims_dict = {
         {"claim_name": "vulcan_lng_projects", "claim_json": {"name": "vulcan_lng_projects", "type": "api", "filters": {}}},
         {"claim_name": "vulcan_metadata_history", "claim_json": {"name": "vulcan_metadata_history", "type": "api", "filters": {}}},
         {"claim_name": "vulcan_project_rankings", "claim_json": {"name": "vulcan_project_rankings", "type": "api", "filters": {}}},
+        {"claim_name": "vulcan_iir_data", "claim_json": {"name": "vulcan_iir_data", "type": "api", "filters": {}}},
+        {"claim_name": "vulcan_infrastructure_watch_extended", "claim_json": {"name": "vulcan_infrastructure_watch_extended", "type": "api", "filters": {}}},
     ]
 }
 
-client = VulcanApiClient(access_token='PSq8zWS3FgHnVGcE2Yz4ZNOBk4SRpUPI')
+client = VulcanApiClient(access_token='eyJwcm9qZWN0X2lkIjogIlN5bm1heCBjb21tZXJjaWFsIEFQSSIsICJwcml2YXRlX2tleSI6ICIwQndzX0ExMFpkdVQyaWlNLS1lbXh3Mk5BNUkxa09kdFNVai04RjVvNzU4IiwgImNsaWVudF9pZCI6ICJGZWxpeCBLZXkiLCAidHlwZSI6ICJvbmVfeWVhcl9saWNlbnNlZF9jdXN0b21lciIsICJzdGFydF9kYXRlIjogIjAzLzE5LzIwMjQiLCAiZW5kX2RhdGUiOiAiMDMvMTkvMjAyNSIsICJ0cmlhbF9saWNlbnNlIjogZmFsc2UsICJpc3N1ZV9kYXRldGltZSI6ICIxOS0wMy0yMDI0IDE0OjI0OjA4IiwgImFkbWluX3VzZXIiOiBmYWxzZSwgInVzZXJfcm9sZXMiOiBbImh5cGVyaW9uIiwgInZ1bGNhbiJdfQ==')
 
 
 payload = {}
 
-got = client.lng_projects()
+got = client.infrastructure_watch_extended()
 df = got.df()
 print(df)
 
-print(got)
-breakpoint()
+print(got)

synmax/vulcan/v2/vulcan_client.pyi

@@ -23,6 +23,9 @@ class VulcanApiClient:
     def iir_data(self) -> Result:
         """Get IIR data"""
         ...
+    def infrastructure_watch_extended(self) -> Result:
+        """Get infrastructure watch extended data (Middle East conflict)"""
+        ...
     def beta_query_datalinks(self,query: str,session_id: str = ...) -> Result:
         """Execute SQL queries against SynMax datalinks"""
         ...

{synmax_api_python_client-4.14.0.dist-info → synmax_api_python_client-4.16.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: synmax-api-python-client
-Version: 4.14.0
+Version: 4.16.0
 Summary: Synmax API client
 Home-page: https://github.com/SynMaxDev/synmax-api-python-client.git
 Author: SynMax Inc.

{synmax_api_python_client-4.14.0.dist-info → synmax_api_python_client-4.16.0.dist-info}/RECORD

@@ -15,9 +15,9 @@ synmax/hyperion/process_api.py,sha256=y3sNiM2X_h-QVRRsrW4VmkABfGKxPqqZGMiYNrpRrK
 synmax/hyperion/process_inputs.py,sha256=Dij1FTzdyv0yGvwQNYZ9yJTJ6vBf-9B4P2zmJeCo6UU,10796
 synmax/hyperion/v4/__init__.py,sha256=VpXU-_FP836dXUDcUFYr-0y0-ZrSM8aCtGE97Z2qbS4,55
 synmax/hyperion/v4/hyperion_client.py,sha256=mhYL3QiOoD2viCI60grLMFvGdHx8iD8IF05NWC6-HS0,868
-synmax/hyperion/v4/hyperion_client.pyi,sha256=9yfaspyAiPCiSDWNTkOpkHafCevLqyhGokwnN1DQ_Po,11938
-synmax/hyperion/v4/openapi.yaml,sha256=iTCcWfzBT9DT7ZbMEWS4WLnrmmlMf77Zuyv8FXSVDtw,98989
-synmax/hyperion/v4/start_hyperion_client.py,sha256=R9NvCfqWriXk2awJ0pmmDfEXTKn0QaGaDai9JLGyyGE,2340
+synmax/hyperion/v4/hyperion_client.pyi,sha256=yNgEmWzZWKPeQ4Y-ilfBOr8e_lMD4GIMwWe3UCHu438,12039
+synmax/hyperion/v4/openapi.yaml,sha256=RU4mACjWtL3yNwN5tEyZHYcJ37-pg7F3Y84UyBDfveE,100266
+synmax/hyperion/v4/start_hyperion_client.py,sha256=0Cs6qgy8yYuhrVhSVZqa7TKKR9PHFkEomA26MTQUJlU,2495
 synmax/leviaton/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 synmax/leviaton/start_leviaton_client.py,sha256=XrgEHoYTsLgwyuBWkHxsCzeEGoj4C40RuDVD_0QZ_ks,4101
 synmax/leviaton/start_leviaton_client2.py,sha256=JdN0FJV67yqjptxw769CjRqgFdzqIdCvmpNclmnErzg,3107
@@ -32,18 +32,18 @@ synmax/theia/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 synmax/vulcan/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 synmax/vulcan/start_vulcan_python_client.py,sha256=cx4DQyrNpIR6UyzOdEFreZWVLCwHE1Z1II5dfN6SPMg,746
 synmax/vulcan/v2/__init__.py,sha256=AGMAxDs93mZ_9zF1fFAufUsu9w9Ep94lO1vbLGbD-LU,81
-synmax/vulcan/v2/openapi.yaml,sha256=AkSc97bLX9hdR3OSSJqH_hF1TDCP7oghUk1uTsSmPNo,48866
-synmax/vulcan/v2/start_vulcan_client.py,sha256=XWHXzwCu6gK33Pw0FKfGjwXiEadg-G6VQI5UsqBlVHc,1002
+synmax/vulcan/v2/openapi.yaml,sha256=NzIGFtgqH5fd7ekSjXoTl6aQAkt2Fjk2kDaqDj-0z9M,53272
+synmax/vulcan/v2/start_vulcan_client.py,sha256=KaCH0B71-d5Px1BUizgV5NEQk_zBmXl_3ejq79WaKcg,1708
 synmax/vulcan/v2/start_vulcan_client2.py,sha256=z59_ZLZ3NX7nO-50cEx7bqeuzYRj-pA4WEMlLf304qs,1833
 synmax/vulcan/v2/vulcan_client.py,sha256=aeCaISqNyJ0bezbvCcxVgdGmUPp2Lv0SFqDbFCt9TXQ,879
-synmax/vulcan/v2/vulcan_client.pyi,sha256=N8hgva9k2xdIikxnaZwsAPNb_S_ve_UVgpxfrHl7Od4,1120
+synmax/vulcan/v2/vulcan_client.pyi,sha256=PwWS5qexlEWzwF3oK0N7_mgCP1ne8PFSwrlWyCd5b00,1263
 test/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 test/test_api_client.py,sha256=HFWCu_xBgqQXc9p6k6YmP2gVrdCFwuhoDVqlxpN1Yoc,4713
 test/test_hyperion_client.py,sha256=aCb4bMBXWofa82MInXoU9tJ5wWsg5sBRv7B_CHvkrcg,1380
 test/test_hyperion_e2e.py,sha256=BPhZH7eVQZSsFcvPdonKjmLahnfsLy37Z2DHp0LGeHc,6247
 test/test_hyperion_helpers.py,sha256=R0G7oqKaoz6jLRACODJ1Cf2gA0gaMPQhOZRjKp4a6-s,2006
-synmax_api_python_client-4.14.0.dist-info/LICENSE,sha256=vKvn9cDVfJhNepCuIXLWaHnnUoDPX26KD-iWb7NAZ4M,44
-synmax_api_python_client-4.14.0.dist-info/METADATA,sha256=IYxcI2IOhWJxnfvvLEwwb0_HbuBSpTABZXVtfz5YgqI,4994
-synmax_api_python_client-4.14.0.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
-synmax_api_python_client-4.14.0.dist-info/top_level.txt,sha256=SAjmDfHlJzUmjoGCT1SnS4qGSLN_ZF-p58UN1yW5kB0,17
-synmax_api_python_client-4.14.0.dist-info/RECORD,,
+synmax_api_python_client-4.16.0.dist-info/LICENSE,sha256=vKvn9cDVfJhNepCuIXLWaHnnUoDPX26KD-iWb7NAZ4M,44
+synmax_api_python_client-4.16.0.dist-info/METADATA,sha256=8mwiRFK5IHJfXhnkIXJ2FT0JzTYeuPohhSQQBIKax_M,4994
+synmax_api_python_client-4.16.0.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
+synmax_api_python_client-4.16.0.dist-info/top_level.txt,sha256=SAjmDfHlJzUmjoGCT1SnS4qGSLN_ZF-p58UN1yW5kB0,17
+synmax_api_python_client-4.16.0.dist-info/RECORD,,