mangroveai 0.1.0__tar.gz

mangroveai-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,118 @@
+name: Release to PyPI
+
+on:
+  workflow_dispatch:
+    inputs:
+      bump:
+        description: "Version bump type"
+        required: true
+        type: choice
+        options:
+          - patch
+          - minor
+          - major
+        default: patch
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          fetch-tags: true
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Run tests
+        run: pytest tests/ --ignore=tests/integration -v
+
+      - name: Compute next version
+        id: version
+        env:
+          BUMP_TYPE: ${{ github.event.inputs.bump }}
+        run: |
+          LATEST_TAG=$(git tag -l 'v*' --sort=-v:refname | head -1)
+          if [ -z "$LATEST_TAG" ]; then
+            LATEST_TAG="v0.0.0"
+          fi
+
+          CURRENT="${LATEST_TAG#v}"
+          IFS='.' read -r MAJOR MINOR PATCH <<< "$CURRENT"
+
+          case "$BUMP_TYPE" in
+            major) MAJOR=$((MAJOR + 1)); MINOR=0; PATCH=0 ;;
+            minor) MINOR=$((MINOR + 1)); PATCH=0 ;;
+            patch) PATCH=$((PATCH + 1)) ;;
+          esac
+
+          NEW_VERSION="${MAJOR}.${MINOR}.${PATCH}"
+          echo "version=${NEW_VERSION}" >> "$GITHUB_OUTPUT"
+          echo "tag=v${NEW_VERSION}" >> "$GITHUB_OUTPUT"
+          echo "previous=${LATEST_TAG}" >> "$GITHUB_OUTPUT"
+          echo "Releasing: ${LATEST_TAG} -> v${NEW_VERSION}"
+
+      - name: Update version in pyproject.toml
+        env:
+          NEW_VERSION: ${{ steps.version.outputs.version }}
+        run: |
+          sed -i "s/^version = .*/version = \"${NEW_VERSION}\"/" pyproject.toml
+          sed -i "s/^__version__ = .*/__version__ = \"${NEW_VERSION}\"/" src/mangroveai/_version.py
+
+      - name: Create and push tag
+        env:
+          VERSION_TAG: ${{ steps.version.outputs.tag }}
+          NEW_VERSION: ${{ steps.version.outputs.version }}
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add pyproject.toml src/mangroveai/_version.py
+          git diff --cached --quiet || git commit -m "release: v${NEW_VERSION}"
+          git tag -a "$VERSION_TAG" -m "Release $VERSION_TAG"
+          git push origin HEAD:main --follow-tags
+
+      - name: Build package
+        run: |
+          pip install build
+          python -m build
+
+      - name: Verify built version
+        env:
+          EXPECTED_VERSION: ${{ steps.version.outputs.version }}
+        run: |
+          echo "Expected: ${EXPECTED_VERSION}"
+          BUILT=$(unzip -p dist/*.whl '*/METADATA' | grep '^Version:' | cut -d' ' -f2)
+          echo "Built:    ${BUILT}"
+          if [ "$BUILT" != "$EXPECTED_VERSION" ]; then
+            echo "ERROR: Version mismatch!"
+            exit 1
+          fi
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ steps.version.outputs.tag }}
+          name: ${{ steps.version.outputs.tag }}
+          generate_release_notes: true
+          body: |
+            ## mangroveai ${{ steps.version.outputs.version }}
+
+            ```bash
+            pip install mangroveai==${{ steps.version.outputs.version }}
+            ```

mangroveai-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+__pycache__/
+*.pyc
+*.egg-info/
+dist/
+build/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+*.log
+.env

mangroveai-0.1.0/CHANGELOG.md

@@ -0,0 +1,45 @@
+# Changelog
+
+All notable changes to the MangroveAI Python SDK will be documented in this file.
+
+Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+This project uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-04-12
+
+### Added
+
+**Layer 1 -- MangroveAI Core API (45 methods)**
+- `client.auth` -- login, refresh, API key management (5 methods)
+- `client.strategies` -- CRUD, status updates, execution state (8 methods)
+- `client.backtesting` -- sync, async, bulk backtesting with polling (7 methods)
+- `client.signals` -- discovery, search, match, evaluate, validate (7 methods)
+- `client.crypto_assets` -- assets, exchanges, OHLCV, market data, trending (8 methods)
+- `client.execution` -- accounts, positions, trades, strategy evaluation (8 methods)
+- `client.docs` -- documentation listing and content (2 methods)
+
+**Layer 2 -- Knowledge Base API (15 methods)**
+- `client.kb.documents` -- document listing, content, sections (3 methods)
+- `client.kb.search` -- full-text search with BM25 ranking (1 method)
+- `client.kb.tags` -- tag listing and filtering (2 methods)
+- `client.kb.glossary` -- glossary terms and backlinks (3 methods)
+- `client.kb.signals` -- signal metadata from KB (2 methods)
+- `client.kb.indicators` -- indicator metadata from KB (2 methods)
+- `client.kb.compute` -- x402 paid signal/indicator computation (2 methods)
+
+**Layer 3 -- Stubs (12 methods)**
+- `client.on_chain` -- smart money, whale activity, exchange flows (6 methods, raises NotImplementedLayerError)
+- `client.defi` -- protocol TVL, chain TVL, stablecoin metrics (3 methods, raises NotImplementedLayerError)
+- `client.social` -- sentiment, mentions, influence scoring (3 methods, raises NotImplementedLayerError)
+
+**Infrastructure**
+- Transport layer with httpx, retry logic, and exponential backoff
+- Auth strategies: API key, JWT with auto-refresh, x402 wallet, NoAuth
+- Environment auto-detection from API key prefix (dev/prod)
+- Multi-service routing (MangroveAI API + KB API with separate base URLs)
+- PaginatedResponse with auto-pagination iterators
+- Custom exception hierarchy matching server error format
+- MockTransport for unit testing
+- 41 Pydantic v2 response/request models with forward compatibility (extra="allow")
+- 72 unit tests, 24 integration tests against live API
+- Quickstart example verified against production

mangroveai-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mangrove Technologies Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mangroveai-0.1.0/PKG-INFO

@@ -0,0 +1,189 @@
+Metadata-Version: 2.4
+Name: mangroveai
+Version: 0.1.0
+Summary: Python SDK for the MangroveAI trading strategy platform
+Project-URL: Homepage, https://mangrovedeveloper.ai
+Project-URL: Repository, https://github.com/MangroveTechnologies/MangroveAI-SDK
+Project-URL: Documentation, https://github.com/MangroveTechnologies/MangroveAI-SDK#readme
+Project-URL: Changelog, https://github.com/MangroveTechnologies/MangroveAI-SDK/blob/main/CHANGELOG.md
+Author: Mangrove Technologies Inc.
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: httpx<1.0,>=0.27.0
+Requires-Dist: pydantic<3.0,>=2.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: respx>=0.22; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# MangroveAI Python SDK
+
+Python SDK for the [MangroveAI](https://mangrovedeveloper.ai) trading strategy platform.
+
+## Install
+
+```bash
+pip install mangroveai
+```
+
+## Setup
+
+1. Create an account at [mangrovedeveloper.ai](https://mangrovedeveloper.ai)
+2. Navigate to **Settings > API Keys**
+3. Generate a new API key
+4. Set it as an environment variable:
+
+```bash
+export MANGROVE_API_KEY=prod_your_key_here
+```
+
+## Quickstart
+
+```python
+from mangroveai import MangroveAI
+
+client = MangroveAI()  # reads MANGROVE_API_KEY from environment
+
+# List trading signals
+signals = client.signals.list(limit=10)
+for s in signals.items:
+    print(f"{s.name} ({s.category}, {s.signal_type})")
+
+# Get market data
+btc = client.crypto_assets.get_market_data("BTC")
+print(f"BTC: ${btc.data['current_price']:,.2f}")
+
+# Create a strategy
+from mangroveai.models import CreateStrategyRequest
+
+strategy = client.strategies.create(CreateStrategyRequest(
+    name="RSI Momentum",
+    asset="BTC",
+    entry=[{"name": "rsi_oversold", "signal_type": "TRIGGER",
+            "timeframe": "1d", "params": {"window": 14, "threshold": 30}}],
+))
+
+# Run a backtest
+import json
+from mangroveai.models import BacktestRequest
+
+result = client.backtesting.run(BacktestRequest(
+    asset="BTC",
+    interval="1d",
+    strategy_json=json.dumps({"name": "test", "asset": "BTC",
+        "entry": [{"name": "rsi_oversold", "signal_type": "TRIGGER",
+                    "timeframe": "1d", "params": {"window": 14, "threshold": 30}}],
+        "exit": []}),
+    lookback_months=3,
+    initial_balance=10000,
+    min_balance_threshold=0.1, min_trade_amount=25,
+    max_open_positions=3, max_trades_per_day=10,
+    max_risk_per_trade=0.02, max_units_per_trade=1000000,
+    max_trade_amount=10000000, volatility_window=24,
+    target_volatility=0.1,
+))
+print(f"Trades: {result.trade_count}, Sharpe: {result.metrics.get('sharpe_ratio')}")
+```
+
+## Services
+
+### Layer 1: MangroveAI Core API
+
+| Service | Access | Methods | Description |
+|---------|--------|---------|-------------|
+| `client.auth` | `auth.*` | 5 | Login, refresh, API key management |
+| `client.strategies` | `strategies.*` | 8 | Strategy CRUD, status, execution state |
+| `client.backtesting` | `backtesting.*` | 7 | Sync/async/bulk backtesting |
+| `client.signals` | `signals.*` | 7 | Signal discovery, evaluation, validation |
+| `client.crypto_assets` | `crypto_assets.*` | 8 | Assets, exchanges, OHLCV, market data |
+| `client.execution` | `execution.*` | 8 | Accounts, positions, trades, evaluation |
+| `client.docs` | `docs.*` | 2 | Documentation listing and content |
+
+### Layer 2: Knowledge Base API
+
+| Service | Access | Methods | Description |
+|---------|--------|---------|-------------|
+| `client.kb.documents` | `kb.documents.*` | 3 | Document listing, content, sections |
+| `client.kb.search` | `kb.search.*` | 1 | Full-text search with BM25 ranking |
+| `client.kb.tags` | `kb.tags.*` | 2 | Tag listing and filtering |
+| `client.kb.glossary` | `kb.glossary.*` | 3 | Glossary terms and backlinks |
+| `client.kb.signals` | `kb.signals.*` | 2 | Signal metadata from KB |
+| `client.kb.indicators` | `kb.indicators.*` | 2 | Indicator metadata from KB |
+| `client.kb.compute` | `kb.compute.*` | 2 | x402 paid signal/indicator computation |
+
+### Layer 3: Coming Soon
+
+On-chain analytics (`client.on_chain`), DeFi data (`client.defi`), and social signals (`client.social`) are defined but not yet available. Calling these methods raises `NotImplementedLayerError`.
+
+## Environment Detection
+
+The SDK auto-detects the environment from your API key prefix:
+
+| Prefix | Environment | API Base URL |
+|--------|-------------|-------------|
+| `prod_` | Production | `https://api.mangrovedeveloper.ai/api/v1` |
+| `dev_` | Development | `https://devapi.mangrove.trade/api/v1` |
+
+Override with explicit parameters:
+
+```python
+client = MangroveAI(api_key="...", base_url="http://localhost:5001/api/v1")
+```
+
+## Error Handling
+
+```python
+from mangroveai import MangroveAI, NotFoundError, RateLimitError, APIError
+
+client = MangroveAI()
+
+try:
+    strategy = client.strategies.get("nonexistent-id")
+except NotFoundError as e:
+    print(f"Not found: {e.message} (correlation_id={e.correlation_id})")
+except RateLimitError as e:
+    print(f"Rate limited, retry after {e.retry_after}s")
+except APIError as e:
+    print(f"[{e.status_code}] {e.code}: {e.message}")
+```
+
+## Pagination
+
+Paginated endpoints return `PaginatedResponse[T]`:
+
+```python
+# Single page
+page = client.strategies.list(skip=0, limit=10)
+print(f"Showing {len(page.items)} of {page.total}")
+
+# Auto-paginate all items
+for strategy in client.strategies.list_iter():
+    print(strategy.name)
+```
+
+## Examples
+
+See the [`examples/`](examples/) directory for working scripts.
+
+## Development
+
+```bash
+git clone https://github.com/MangroveTechnologies/MangroveAI-SDK.git
+cd MangroveAI-SDK
+pip install -e ".[dev]"
+pytest tests/ --ignore=tests/integration  # unit tests
+MANGROVE_API_KEY=... pytest tests/integration/ -m integration  # live tests
+```

mangroveai-0.1.0/README.md

@@ -0,0 +1,158 @@
+# MangroveAI Python SDK
+
+Python SDK for the [MangroveAI](https://mangrovedeveloper.ai) trading strategy platform.
+
+## Install
+
+```bash
+pip install mangroveai
+```
+
+## Setup
+
+1. Create an account at [mangrovedeveloper.ai](https://mangrovedeveloper.ai)
+2. Navigate to **Settings > API Keys**
+3. Generate a new API key
+4. Set it as an environment variable:
+
+```bash
+export MANGROVE_API_KEY=prod_your_key_here
+```
+
+## Quickstart
+
+```python
+from mangroveai import MangroveAI
+
+client = MangroveAI()  # reads MANGROVE_API_KEY from environment
+
+# List trading signals
+signals = client.signals.list(limit=10)
+for s in signals.items:
+    print(f"{s.name} ({s.category}, {s.signal_type})")
+
+# Get market data
+btc = client.crypto_assets.get_market_data("BTC")
+print(f"BTC: ${btc.data['current_price']:,.2f}")
+
+# Create a strategy
+from mangroveai.models import CreateStrategyRequest
+
+strategy = client.strategies.create(CreateStrategyRequest(
+    name="RSI Momentum",
+    asset="BTC",
+    entry=[{"name": "rsi_oversold", "signal_type": "TRIGGER",
+            "timeframe": "1d", "params": {"window": 14, "threshold": 30}}],
+))
+
+# Run a backtest
+import json
+from mangroveai.models import BacktestRequest
+
+result = client.backtesting.run(BacktestRequest(
+    asset="BTC",
+    interval="1d",
+    strategy_json=json.dumps({"name": "test", "asset": "BTC",
+        "entry": [{"name": "rsi_oversold", "signal_type": "TRIGGER",
+                    "timeframe": "1d", "params": {"window": 14, "threshold": 30}}],
+        "exit": []}),
+    lookback_months=3,
+    initial_balance=10000,
+    min_balance_threshold=0.1, min_trade_amount=25,
+    max_open_positions=3, max_trades_per_day=10,
+    max_risk_per_trade=0.02, max_units_per_trade=1000000,
+    max_trade_amount=10000000, volatility_window=24,
+    target_volatility=0.1,
+))
+print(f"Trades: {result.trade_count}, Sharpe: {result.metrics.get('sharpe_ratio')}")
+```
+
+## Services
+
+### Layer 1: MangroveAI Core API
+
+| Service | Access | Methods | Description |
+|---------|--------|---------|-------------|
+| `client.auth` | `auth.*` | 5 | Login, refresh, API key management |
+| `client.strategies` | `strategies.*` | 8 | Strategy CRUD, status, execution state |
+| `client.backtesting` | `backtesting.*` | 7 | Sync/async/bulk backtesting |
+| `client.signals` | `signals.*` | 7 | Signal discovery, evaluation, validation |
+| `client.crypto_assets` | `crypto_assets.*` | 8 | Assets, exchanges, OHLCV, market data |
+| `client.execution` | `execution.*` | 8 | Accounts, positions, trades, evaluation |
+| `client.docs` | `docs.*` | 2 | Documentation listing and content |
+
+### Layer 2: Knowledge Base API
+
+| Service | Access | Methods | Description |
+|---------|--------|---------|-------------|
+| `client.kb.documents` | `kb.documents.*` | 3 | Document listing, content, sections |
+| `client.kb.search` | `kb.search.*` | 1 | Full-text search with BM25 ranking |
+| `client.kb.tags` | `kb.tags.*` | 2 | Tag listing and filtering |
+| `client.kb.glossary` | `kb.glossary.*` | 3 | Glossary terms and backlinks |
+| `client.kb.signals` | `kb.signals.*` | 2 | Signal metadata from KB |
+| `client.kb.indicators` | `kb.indicators.*` | 2 | Indicator metadata from KB |
+| `client.kb.compute` | `kb.compute.*` | 2 | x402 paid signal/indicator computation |
+
+### Layer 3: Coming Soon
+
+On-chain analytics (`client.on_chain`), DeFi data (`client.defi`), and social signals (`client.social`) are defined but not yet available. Calling these methods raises `NotImplementedLayerError`.
+
+## Environment Detection
+
+The SDK auto-detects the environment from your API key prefix:
+
+| Prefix | Environment | API Base URL |
+|--------|-------------|-------------|
+| `prod_` | Production | `https://api.mangrovedeveloper.ai/api/v1` |
+| `dev_` | Development | `https://devapi.mangrove.trade/api/v1` |
+
+Override with explicit parameters:
+
+```python
+client = MangroveAI(api_key="...", base_url="http://localhost:5001/api/v1")
+```
+
+## Error Handling
+
+```python
+from mangroveai import MangroveAI, NotFoundError, RateLimitError, APIError
+
+client = MangroveAI()
+
+try:
+    strategy = client.strategies.get("nonexistent-id")
+except NotFoundError as e:
+    print(f"Not found: {e.message} (correlation_id={e.correlation_id})")
+except RateLimitError as e:
+    print(f"Rate limited, retry after {e.retry_after}s")
+except APIError as e:
+    print(f"[{e.status_code}] {e.code}: {e.message}")
+```
+
+## Pagination
+
+Paginated endpoints return `PaginatedResponse[T]`:
+
+```python
+# Single page
+page = client.strategies.list(skip=0, limit=10)
+print(f"Showing {len(page.items)} of {page.total}")
+
+# Auto-paginate all items
+for strategy in client.strategies.list_iter():
+    print(strategy.name)
+```
+
+## Examples
+
+See the [`examples/`](examples/) directory for working scripts.
+
+## Development
+
+```bash
+git clone https://github.com/MangroveTechnologies/MangroveAI-SDK.git
+cd MangroveAI-SDK
+pip install -e ".[dev]"
+pytest tests/ --ignore=tests/integration  # unit tests
+MANGROVE_API_KEY=... pytest tests/integration/ -m integration  # live tests
+```

mangroveai-0.1.0/examples/quickstart.py

@@ -0,0 +1,119 @@
+"""MangroveAI SDK Quickstart
+
+Getting started:
+1. Create an account at https://mangrovedeveloper.ai
+2. Navigate to Settings > API Keys
+3. Generate a new API key
+4. Set it as an environment variable:
+   export MANGROVE_API_KEY=prod_your_key_here
+
+Then run this script:
+   python examples/quickstart.py
+"""
+
+from mangroveai import MangroveAI
+from mangroveai.models import CreateStrategyRequest, BacktestRequest
+
+
+def main() -> None:
+    # Initialize client -- reads MANGROVE_API_KEY from environment
+    # Auto-detects prod/dev from key prefix
+    client = MangroveAI()
+
+    # ---- Signals ----
+    # List available trading signals
+    signals = client.signals.list(limit=10)
+    print(f"Available signals: {signals.total}")
+    for s in signals.items[:5]:
+        print(f"  {s.name} ({s.category}, {s.signal_type})")
+
+    # Search for specific signals
+    from mangroveai.models import SearchSignalsRequest
+    results = client.signals.search(SearchSignalsRequest(query="rsi", search_type="name"))
+    print(f"\nRSI signals: {results.total}")
+    for s in results.items:
+        print(f"  {s.name}")
+
+    # Get signal details
+    rsi = client.signals.get("rsi_oversold")
+    print(f"\n{rsi.name}: {rsi.metadata.description}")
+    print(f"  Params: {rsi.metadata.params}")
+
+    # ---- Market Data ----
+    # Current price and market data
+    btc = client.crypto_assets.get_market_data("BTC")
+    print(f"\nBTC price: ${btc.data['current_price']:,.2f}")
+    print(f"  Market cap: ${btc.data['market_cap']:,.0f}")
+    print(f"  24h volume: ${btc.data['volume_24h']:,.0f}")
+
+    # Global market overview
+    global_data = client.crypto_assets.get_global_market()
+    print(f"\nGlobal market cap: ${global_data.data['total_market_cap_usd']:,.0f}")
+    print(f"  BTC dominance: {global_data.data['btc_dominance']:.1f}%")
+
+    # ---- Strategies ----
+    # Create a strategy
+    strategy = client.strategies.create(CreateStrategyRequest(
+        name="SDK Quickstart - RSI Momentum",
+        asset="BTC",
+        strategy_type="momentum",
+        description="Buys BTC when RSI crosses below 30 while price is above 50-period SMA",
+        entry=[
+            {"name": "rsi_oversold", "signal_type": "TRIGGER", "timeframe": "1d", "params": {"window": 14, "threshold": 30}},
+            {"name": "is_above_sma", "signal_type": "FILTER", "timeframe": "1d", "params": {"window": 50}},
+        ],
+        exit=[],
+        reward_factor=2.0,
+    ))
+    print(f"\nCreated strategy: {strategy.name} (id={strategy.id})")
+
+    # ---- Backtesting ----
+    # Backtest the strategy
+    import json
+    result = client.backtesting.run(BacktestRequest(
+        asset="BTC",
+        interval="1d",
+        strategy_json=json.dumps({
+            "name": strategy.name,
+            "asset": "BTC",
+            "entry": [
+                {"name": "rsi_oversold", "signal_type": "TRIGGER", "timeframe": "1d", "params": {"window": 14, "threshold": 30}},
+                {"name": "is_above_sma", "signal_type": "FILTER", "timeframe": "1d", "params": {"window": 50}},
+            ],
+            "exit": [],
+        }),
+        lookback_months=3,
+        initial_balance=10000,
+        min_balance_threshold=0.1,
+        min_trade_amount=25,
+        max_open_positions=3,
+        max_trades_per_day=10,
+        max_risk_per_trade=0.02,
+        max_units_per_trade=1000000,
+        max_trade_amount=10000000,
+        volatility_window=24,
+        target_volatility=0.1,
+    ))
+
+    if result.success:
+        print(f"\nBacktest results ({result.trade_count} trades):")
+        for key, value in (result.metrics or {}).items():
+            if isinstance(value, float):
+                print(f"  {key}: {value:.4f}")
+            else:
+                print(f"  {key}: {value}")
+    else:
+        print(f"\nBacktest failed: {result.error}")
+
+    # ---- Cleanup ----
+    try:
+        client.strategies.delete(strategy.id)
+        print(f"\nCleaned up strategy {strategy.id}")
+    except Exception as e:
+        print(f"\nNote: could not delete strategy (may require strategy:delete permission): {e}")
+
+    client.close()
+
+
+if __name__ == "__main__":
+    main()