Add 4 resources (ai, platform, chart, subscription) — v0.3.0a1

Ports the A2 roadmap wave to Python. Ecosystem/platform domains beyond
the A1 trader-first extensions.

- ai: LLM analysis flow + credit balance/history + buy credits.
  Server-prefix `ai*` dropped where redundant under the `ai.` namespace
  (getaicredits → get_credits, aillmresults → llm_results, etc).
- platform: 9 public reads (blog, docs, countries, languages, etc).
- chart: list/get/save/delete + share_save/share_get.
- subscription: hopper + account get, plans, remap/assign, getCredits,
  orderSub/stopSubscription.

50 tests passing (10 new), ruff clean, mypy --strict clean.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: pimfeltkamp

CHANGELOG.md

@@ -3,7 +3,17 @@
 All notable changes to the `cryptohopper` Python package are documented in this file.
 The format is loosely based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
-## 0.2.0a1 — Unreleased
+## 0.3.0a1 — Unreleased
+
+Adds four more API domains: `ai`, `platform`, `chart`, `subscription`.
+
+### Added
+- **`ai`** — `list`, `get`, `available_models`, `get_credits`, `credit_invoices`, `credit_transactions`, `buy_credits`, `llm_analyze_options`, `llm_analyze`, `llm_analyze_results`, `llm_results`.
+- **`platform`** — `latest_blog`, `documentation`, `promo_bar`, `search_documentation`, `countries`, `country_allowlist`, `ip_country`, `languages`, `bot_types` (all public).
+- **`chart`** — `list`, `get`, `save`, `delete`, `share_save`, `share_get`.
+- **`subscription`** — `hopper`, `get`, `plans`, `remap`, `assign`, `get_credits`, `order_sub`, `stop_subscription`.
+
+## 0.2.0a1 — 2026-04-24
 
 Adds four more API domains: `signals`, `arbitrage`, `marketmaker`, `template`.
 

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "cryptohopper"
-version = "0.2.0a1"
+version = "0.3.0a1"
 description = "Official Python SDK for the Cryptohopper API"
 readme = "README.md"
 requires-python = ">=3.10"

src/cryptohopper/_client.py

@@ -24,14 +24,18 @@
 HttpMethod = Literal["GET", "POST", "PATCH", "DELETE", "PUT"]
 
 if TYPE_CHECKING:
+    from .resources.ai import AI
     from .resources.arbitrage import Arbitrage
     from .resources.backtest import Backtests
+    from .resources.chart import Chart
     from .resources.exchange import Exchange
     from .resources.hoppers import Hoppers
     from .resources.market import Market
     from .resources.marketmaker import MarketMaker
+    from .resources.platform import Platform
     from .resources.signals import Signals
     from .resources.strategy import Strategies
+    from .resources.subscription import Subscription
     from .resources.template import Templates
     from .resources.user import User
 
@@ -70,6 +74,10 @@ class CryptohopperClient:
     arbitrage: Arbitrage
     marketmaker: MarketMaker
     template: Templates
+    ai: AI
+    platform: Platform
+    chart: Chart
+    subscription: Subscription
 
     def __init__(
         self,
@@ -94,14 +102,18 @@ def __init__(
         self._owns_http = http_client is None
 
         # Import here to avoid a circular at module import time.
+        from .resources.ai import AI
         from .resources.arbitrage import Arbitrage
         from .resources.backtest import Backtests
+        from .resources.chart import Chart
         from .resources.exchange import Exchange
         from .resources.hoppers import Hoppers
         from .resources.market import Market
         from .resources.marketmaker import MarketMaker
+        from .resources.platform import Platform
         from .resources.signals import Signals
         from .resources.strategy import Strategies
+        from .resources.subscription import Subscription
         from .resources.template import Templates
         from .resources.user import User
 
@@ -115,6 +127,10 @@ def __init__(
         self.arbitrage = Arbitrage(self)
         self.marketmaker = MarketMaker(self)
         self.template = Templates(self)
+        self.ai = AI(self)
+        self.platform = Platform(self)
+        self.chart = Chart(self)
+        self.subscription = Subscription(self)
 
     def __enter__(self) -> CryptohopperClient:
         return self

src/cryptohopper/_version.py

@@ -1 +1 @@
-CURRENT_VERSION = "0.2.0a1"
+CURRENT_VERSION = "0.3.0a1"

src/cryptohopper/resources/ai.py

@@ -0,0 +1,70 @@
+"""``client.ai`` — AI assistant: credits + LLM analysis."""
+
+from __future__ import annotations
+
+from collections.abc import Sequence
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from .._client import CryptohopperClient
+
+
+class AI:
+    def __init__(self, client: CryptohopperClient) -> None:
+        self._client = client
+
+    def list(self, **params: Any) -> Sequence[dict[str, Any]]:
+        """List AI assistant items / sessions. Requires ``read``."""
+        return self._client._request("GET", "/ai/list", params=params or None)
+
+    def get(self, id: int | str) -> dict[str, Any]:
+        """Fetch a single AI item / session. Requires ``read``."""
+        return self._client._request("GET", "/ai/get", params={"id": id})
+
+    def available_models(self) -> Sequence[dict[str, Any]]:
+        """Models available to the authenticated user."""
+        return self._client._request("GET", "/ai/availablemodels")
+
+    # ─── Credits ─────────────────────────────────────────────────────────
+
+    def get_credits(self) -> dict[str, Any]:
+        """Remaining AI credit balance. Requires ``read``."""
+        return self._client._request("GET", "/ai/getaicredits")
+
+    def credit_invoices(self, **params: Any) -> Sequence[dict[str, Any]]:
+        """Past invoices for AI-credit purchases. Requires ``read``."""
+        return self._client._request(
+            "GET", "/ai/aicreditinvoices", params=params or None
+        )
+
+    def credit_transactions(self, **params: Any) -> Sequence[dict[str, Any]]:
+        """Credit spend/top-up transaction history. Requires ``read``."""
+        return self._client._request(
+            "GET", "/ai/aicredittransactions", params=params or None
+        )
+
+    def buy_credits(self, data: dict[str, Any]) -> dict[str, Any]:
+        """Start a purchase of additional credits. Requires ``user``."""
+        return self._client._request("POST", "/ai/buyaicredits", json=data)
+
+    # ─── LLM analysis ────────────────────────────────────────────────────
+
+    def llm_analyze_options(self) -> dict[str, Any]:
+        """Options/metadata for the LLM analyse endpoint. Requires ``read``."""
+        return self._client._request("GET", "/ai/aillmanalyzeoptions")
+
+    def llm_analyze(self, data: dict[str, Any]) -> dict[str, Any]:
+        """Run an LLM analysis. Usually async — returns a job id. Requires ``manage``."""
+        return self._client._request("POST", "/ai/doaillmanalyze", json=data)
+
+    def llm_analyze_results(self, **params: Any) -> dict[str, Any]:
+        """Fetch the result(s) of an LLM analysis. Requires ``read``."""
+        return self._client._request(
+            "GET", "/ai/aillmanalyzeresults", params=params or None
+        )
+
+    def llm_results(self, **params: Any) -> Sequence[dict[str, Any]]:
+        """Historical LLM analysis results. Requires ``read``."""
+        return self._client._request(
+            "GET", "/ai/aillmresults", params=params or None
+        )

src/cryptohopper/resources/chart.py

@@ -0,0 +1,46 @@
+"""``client.chart`` — saved chart layouts + shared-chart links."""
+
+from __future__ import annotations
+
+from collections.abc import Sequence
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from .._client import CryptohopperClient
+
+ChartId = int | str
+
+
+class Chart:
+    def __init__(self, client: CryptohopperClient) -> None:
+        self._client = client
+
+    def list(self) -> Sequence[dict[str, Any]]:
+        """List the user's saved charts. Requires ``read``."""
+        return self._client._request("GET", "/chart/list")
+
+    def get(self, chart_id: ChartId) -> dict[str, Any]:
+        """Fetch a single saved chart. Requires ``read``."""
+        return self._client._request(
+            "GET", "/chart/get", params={"chart_id": chart_id}
+        )
+
+    def save(self, data: dict[str, Any]) -> dict[str, Any]:
+        """Save a new chart layout. Requires ``manage``."""
+        return self._client._request("POST", "/chart/save", json=data)
+
+    def delete(self, chart_id: ChartId) -> dict[str, Any]:
+        """Delete a saved chart. Requires ``manage``."""
+        return self._client._request(
+            "POST", "/chart/delete", json={"chart_id": chart_id}
+        )
+
+    def share_save(self, data: dict[str, Any]) -> dict[str, Any]:
+        """Save a shared (public-link) chart. Requires ``manage``."""
+        return self._client._request("POST", "/chart/share-save", json=data)
+
+    def share_get(self, share_id: str) -> dict[str, Any]:
+        """Fetch a shared chart by its share id / key. Public."""
+        return self._client._request(
+            "GET", "/chart/share-get", params={"share_id": share_id}
+        )

src/cryptohopper/resources/platform.py

@@ -0,0 +1,56 @@
+"""``client.platform`` — marketing / i18n / discovery reads (all public)."""
+
+from __future__ import annotations
+
+from collections.abc import Sequence
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from .._client import CryptohopperClient
+
+
+class Platform:
+    def __init__(self, client: CryptohopperClient) -> None:
+        self._client = client
+
+    def latest_blog(self, **params: Any) -> Sequence[dict[str, Any]]:
+        """Latest blog posts. Public."""
+        return self._client._request(
+            "GET", "/platform/latestblog", params=params or None
+        )
+
+    def documentation(self, **params: Any) -> dict[str, Any]:
+        """Documentation articles. Public."""
+        return self._client._request(
+            "GET", "/platform/documentation", params=params or None
+        )
+
+    def promo_bar(self) -> dict[str, Any]:
+        """Active promo bar content. Public."""
+        return self._client._request("GET", "/platform/promobar")
+
+    def search_documentation(self, query: str) -> Sequence[dict[str, Any]]:
+        """Full-text search across public documentation. Public."""
+        return self._client._request(
+            "GET", "/platform/searchdocumentation", params={"q": query}
+        )
+
+    def countries(self) -> Sequence[dict[str, Any]]:
+        """Full list of countries (ISO codes + display names). Public."""
+        return self._client._request("GET", "/platform/countries")
+
+    def country_allowlist(self) -> Sequence[dict[str, Any]]:
+        """Countries the platform currently allows. Public."""
+        return self._client._request("GET", "/platform/countryallowlist")
+
+    def ip_country(self) -> dict[str, Any]:
+        """Country resolved from the caller's IP. Public."""
+        return self._client._request("GET", "/platform/ipcountry")
+
+    def languages(self) -> Sequence[dict[str, Any]]:
+        """Supported UI languages. Public."""
+        return self._client._request("GET", "/platform/languages")
+
+    def bot_types(self) -> Sequence[dict[str, Any]]:
+        """Enumeration of available bot types. Public."""
+        return self._client._request("GET", "/platform/bottypes")

src/cryptohopper/resources/subscription.py

@@ -0,0 +1,54 @@
+"""``client.subscription`` — plans, per-hopper state, credits, billing."""
+
+from __future__ import annotations
+
+from collections.abc import Sequence
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from .._client import CryptohopperClient
+
+HopperId = int | str
+
+
+class Subscription:
+    def __init__(self, client: CryptohopperClient) -> None:
+        self._client = client
+
+    def hopper(self, hopper_id: HopperId) -> dict[str, Any]:
+        """Subscription state for a specific hopper. Requires ``read``."""
+        return self._client._request(
+            "GET", "/subscription/hopper", params={"hopper_id": hopper_id}
+        )
+
+    def get(self) -> dict[str, Any]:
+        """Account-level subscription state. Requires ``read``."""
+        return self._client._request("GET", "/subscription/get")
+
+    def plans(self) -> Sequence[dict[str, Any]]:
+        """List available subscription plans. Public."""
+        return self._client._request("GET", "/subscription/plans")
+
+    def remap(self, data: dict[str, Any]) -> dict[str, Any]:
+        """Move a subscription slot from one hopper to another. Requires ``manage``."""
+        return self._client._request("POST", "/subscription/remap", json=data)
+
+    def assign(self, data: dict[str, Any]) -> dict[str, Any]:
+        """Assign a subscription slot to a hopper. Requires ``manage``."""
+        return self._client._request("POST", "/subscription/assign", json=data)
+
+    def get_credits(self) -> dict[str, Any]:
+        """Remaining platform credits on the account. Requires ``read``."""
+        return self._client._request("GET", "/subscription/getcredits")
+
+    def order_sub(self, data: dict[str, Any]) -> dict[str, Any]:
+        """Start a subscription purchase. Requires ``user``."""
+        return self._client._request("POST", "/subscription/ordersub", json=data)
+
+    def stop_subscription(
+        self, data: dict[str, Any] | None = None
+    ) -> dict[str, Any]:
+        """Cancel / stop an active subscription. Requires ``user``."""
+        return self._client._request(
+            "POST", "/subscription/stopsubscription", json=data or {}
+        )