v0.9.1: Fix analytics endpoint paths to production API

Align analytics SDK calls with production endpoints by switching ratios and compare to /analytics routes, and return analytics responses in the API's native JSON shape without transformation.

Made-with: Cursor

Author: sahmk-sa

CHANGELOG.md

@@ -4,6 +4,17 @@ All notable changes to the `sahmk` Python SDK will be documented in this file.
 
 This project follows [Semantic Versioning](https://semver.org/).
 
+## [0.9.1] — 2026-04-30
+
+### Fixed
+
+- Fix analytics endpoint paths to match production API.
+- `ratios()` now calls `GET /analytics/ratios/{symbol}/`
+- `compare()` now calls `GET /analytics/compare/`
+- Analytics SDK methods now return the production response shape as-is:
+  - ratios: `symbol`, `ratios`, `meta`
+  - compare: `results`, `count`, `meta`
+
 ## [0.9.0] — 2026-04-30
 
 ### Added

README.md

@@ -223,8 +223,8 @@ Base URL: `https://app.sahmk.sa/api/v1`
 | `GET /companies/` | Free | Company directory and symbol discovery |
 | `GET /company/{symbol}/` | Free+ | Company info (tiered by plan) |
 | `GET /financials/{symbol}/` | Starter+ | Financial statements |
-| `GET /ratios/{symbol}/` | Starter+ | Analytics ratios for one company |
-| `GET /compare/` | Starter+ | Analytics comparison across companies |
+| `GET /analytics/ratios/{symbol}/` | Starter+ | Analytics ratios for one company |
+| `GET /analytics/compare/` | Starter+ | Analytics comparison across companies |
 | `GET /dividends/{symbol}/` | Starter+ | Dividend history and yield |
 | `GET /events/` | Pro+ | AI-generated stock events |
 

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sahmk"
-version = "0.9.0"
+version = "0.9.1"
 description = "Official Python SDK for Sahmk — Saudi market data and richer market workflows for developers."
 readme = "README.md"
 requires-python = ">=3.9"

sahmk/__init__.py

@@ -39,7 +39,7 @@
     Liquidity,
 )
 
-__version__ = "0.9.0"
+__version__ = "0.9.1"
 __all__ = [
     "SahmkClient",
     "SahmkError",

sahmk/client.py

@@ -728,12 +728,11 @@ def ratios(self, symbol, history="latest", period="annual", metrics="core"):
         Get analytics ratios for a symbol.
 
         Returns:
-            RatiosResponse object
+            Raw API response dict
         """
-        from .models import RatiosResponse
-        data = self._request(
+        return self._request(
             "GET",
-            f"/ratios/{symbol}/",
+            f"/analytics/ratios/{symbol}/",
             params=self._clean_params(
                 {
                     "history": history,
@@ -742,7 +741,6 @@ def ratios(self, symbol, history="latest", period="annual", metrics="core"):
                 }
             ),
         )
-        return RatiosResponse.from_dict(data)
 
     def compare(self, symbols, metrics="core"):
         """
@@ -753,21 +751,19 @@ def compare(self, symbols, metrics="core"):
             metrics: Optional metrics set selector.
 
         Returns:
-            CompareResponse object
+            Raw API response dict
         """
-        from .models import CompareResponse
         joined_symbols = ",".join(self._normalize_symbols(symbols))
-        data = self._request(
+        return self._request(
             "GET",
-            "/compare/",
+            "/analytics/compare/",
             params=self._clean_params(
                 {
                     "symbols": joined_symbols,
                     "metrics": metrics,
                 }
             ),
         )
-        return CompareResponse.from_dict(data)
 
     def dividends(self, symbol):
         """

tests/test_client.py

@@ -858,10 +858,10 @@ class TestAnalyticsEndpoints:
     def test_ratios_url_and_params(self, mock_client):
         responses.add(
             responses.GET,
-            f"{mock_client.base_url}/ratios/1120/",
+            f"{mock_client.base_url}/analytics/ratios/1120/",
             json={
                 "symbol": "1120",
-                "rows": [],
+                "ratios": [],
                 "meta": {"history": "latest", "period": "annual", "metrics": "core"},
             },
             status=200,
@@ -879,17 +879,18 @@ def test_ratios_url_and_params(self, mock_client):
     def test_compare_url_and_params(self, mock_client):
         responses.add(
             responses.GET,
-            f"{mock_client.base_url}/compare/",
+            f"{mock_client.base_url}/analytics/compare/",
             json={
-                "rows": [],
+                "results": [],
+                "count": 0,
                 "meta": {"metrics": "core"},
             },
             status=200,
         )
 
         result = mock_client.compare(["1120", "1180", "1010"])
 
-        assert "rows" in result
+        assert "results" in result
         request_url = responses.calls[0].request.url
         assert (
             "symbols=1120%2C1180%2C1010" in request_url
@@ -901,8 +902,8 @@ def test_compare_url_and_params(self, mock_client):
     def test_compare_accepts_comma_string_symbols(self, mock_client):
         responses.add(
             responses.GET,
-            f"{mock_client.base_url}/compare/",
-            json={"rows": [], "meta": {}},
+            f"{mock_client.base_url}/analytics/compare/",
+            json={"results": [], "count": 0, "meta": {}},
             status=200,
         )
 
@@ -919,9 +920,9 @@ def test_compare_accepts_comma_string_symbols(self, mock_client):
     def test_compare_includes_coverage_in_response(self, mock_client):
         responses.add(
             responses.GET,
-            f"{mock_client.base_url}/compare/",
+            f"{mock_client.base_url}/analytics/compare/",
             json={
-                "rows": [
+                "results": [
                     {
                         "symbol": "1120",
                         "company_name": "Al Rajhi",
@@ -933,14 +934,15 @@ def test_compare_includes_coverage_in_response(self, mock_client):
                         "key_metrics": {"revenue_growth": 0.12},
                     }
                 ],
+                "count": 1,
                 "meta": {"metrics": "core"},
             },
             status=200,
         )
 
         result = mock_client.compare(["1120"])
 
-        assert result.rows[0].coverage["quality"] == "full"
+        assert result["results"][0]["coverage"]["quality"] == "full"
 
 
 class TestEventsEndpoint:

tests/test_models.py

@@ -477,25 +477,36 @@ def test_compare_includes_coverage(self):
     def test_client_returns_ratios(self, client):
         responses.add(
             responses.GET,
-            f"{client.base_url}/ratios/1120/",
-            json=self.RATIOS_DATA,
+            f"{client.base_url}/analytics/ratios/1120/",
+            json={
+                "symbol": "1120",
+                "ratios": self.RATIOS_DATA["rows"],
+                "meta": self.RATIOS_DATA["meta"],
+            },
             status=200,
         )
         result = client.ratios("1120")
-        assert isinstance(result, RatiosResponse)
-        assert result.rows[0].report_date == "2025-12-31"
+        assert isinstance(result, dict)
+        assert result["symbol"] == "1120"
+        assert "ratios" in result
+        assert "meta" in result
 
     @responses.activate
     def test_client_returns_compare(self, client):
         responses.add(
             responses.GET,
-            f"{client.base_url}/compare/",
-            json=self.COMPARE_DATA,
+            f"{client.base_url}/analytics/compare/",
+            json={
+                "results": self.COMPARE_DATA["rows"],
+                "count": len(self.COMPARE_DATA["rows"]),
+                "meta": self.COMPARE_DATA["meta"],
+            },
             status=200,
         )
         result = client.compare(["1120", "1180"])
-        assert isinstance(result, CompareResponse)
-        assert result.rows[0].company_name == "Al Rajhi Bank"
+        assert isinstance(result, dict)
+        assert "results" in result
+        assert result["results"][0]["company_name"] == "Al Rajhi Bank"
 
 
 class TestEventsModel: