heyremora 0.5.1__tar.gz

heyremora-0.5.1/.gitignore

@@ -0,0 +1,70 @@
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# Data cache
+data_cache/
+data_cache/*.json
+
+# Ignore JSON files except in frontend
+*.json
+!frontend/*.json
+!frontend/**/*.json
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+venv/
+env/
+ENV/
+env.bak/
+venv.bak/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Logs
+*.log
+logs/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+friday_options_income/*.db
+*.db
+
+# Python cache
+__pycache__/
+*.py[cod]
+*$py.class

heyremora-0.5.1/CHANGELOG.md

@@ -0,0 +1,58 @@
+# Changelog
+
+## 0.5.0 — 2026-06-10
+
+- New: `analyze_strategy` tool — payoff analysis for any multi-leg strategy (up to 24 legs): max gain/loss, breakevens, net debit/credit, detected strategy name.
+- New: `save_screener_config` tool — save the current filter set as a named preset (pairs with `list_saved_screeners`).
+- New: `get_trade_dna` tool — the user's trading-style profile built from their own closed trades (sweet-spot delta/DTE/IV, best underlyings); use it to tailor screens.
+- 30 tools and 2 resources total (was 27).
+
+## 0.4.0 — 2026-06-05
+
+- New: `get_technicals` tool — trend, 50/200-day MAs, 13-week range, and support/resistance levels for any ticker.
+- New: `get_unusual_activity` tool — options flow showing where big premium is moving, by ticker or market-wide.
+- New: `scan_stocks` tool — scan stocks by IV rank, valuation, market cap, dividend, sector, signal, and earnings proximity.
+- New: `get_portfolio_analytics` tool — track-record analytics: win rate, avg P&L, and which entry conditions (delta/DTE/IV/ticker/sector) are working.
+- New: `list_portfolios` tool — list your portfolios with their IDs, for discovery by the portfolio-scoped tools.
+- New: `get_morning_briefing` tool — daily snapshot of open positions, unrealized P&L, expirations, and action items.
+- New: `list_saved_screeners` tool — list your saved screener configs and their filter settings.
+- 27 tools and 2 resources total (was 20).
+
+## 0.3.0 — 2026-06-04
+
+- Rebrand: package renamed from `options-trader-x-mcp` to `heyremora`. Install with `pip install heyremora`; import as `heyremora`.
+- Rebrand: env vars renamed to `REMORA_API_KEY` / `REMORA_API_URL`. The legacy `OTX_API_KEY` / `OTX_API_URL` names are still accepted as a fallback, so existing setups keep working.
+- Rebrand: MCP server display name is now "Remora"; resource URIs moved from `otx://` to `remora://`.
+- No tool signatures, endpoints, or behavior changed — this is a naming-only release.
+
+## 0.2.1 — 2026-05-18
+
+- Fix: `get_chain` default sort changed from volume to strike — ATM strikes were crowded out by deep OTM high-volume contracts
+- Fix: `get_chain` default `top` increased from 50 to 200 for better strike coverage
+- New: `sort` parameter on `get_chain` — choose 'strike' (default), 'volume', or 'oi'
+- Fix: Polygon API now queries with `sort=strike_price&order=asc` for complete chain data
+
+## 0.2.0 — 2026-05-18
+
+- New: `get_chain` tool — browse raw options chains with strike/expiry/type filters
+- New: `get_option_quote` tool — detailed quote for a single contract
+- New: staleness timestamps (`as_of`) on all read tool responses
+- New: filter summaries explaining why results were filtered out
+- Fix: earnings calendar returned empty — wrong dict keys for upstream response
+- Fix: `get_chain` crashed on None strike/IV values — added null guards
+- Fix: `_fmt_filter_summary` KeyError on malformed data — switched to `.get()` with defaults
+- Fix: MCP screener `max_bid_ask_spread_pct` default relaxed from 0.15 to 0.25 (less aggressive filtering)
+- Fix: `find_trades` progressive fallback — widens DTE, tries all strategies before returning empty
+- Fix: earnings data 5-level fallback chain (yfinance calendar → earnings_dates → info → Polygon → quarterly estimate)
+
+## 0.1.1 — 2026-05-15
+
+- Fix: `screen_long_calls` and `screen_long_puts` DTE parameter names now match backend (`dte_min`/`dte_max` instead of `min_dte`/`max_dte`). Previously, custom DTE values were silently ignored.
+- Fix: DTE defaults updated from 60/730 to 30/180 to match the web screener.
+- Fix: `compare_strategies` tool refactored to use the trade finder endpoint.
+- Remove dead `compare_strategies()` client method.
+
+## 0.1.0 — 2026-05-15
+
+- Initial release.
+- Tools: `screen_csps`, `screen_covered_calls`, `screen_long_calls`, `screen_long_puts`, `screen_credit_spreads`, `screen_debit_spreads`, `find_trades`, `compare_strategies`, `get_portfolio`, `get_positions`, `get_open_trades`, `get_closed_trades`, `get_metrics`.

heyremora-0.5.1/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.4
+Name: heyremora
+Version: 0.5.1
+Summary: MCP server for Remora — options screening, portfolio analytics, and strategy comparison via Claude Desktop
+License-Expression: MIT
+Requires-Python: >=3.10
+Requires-Dist: httpx<1.0,>=0.24
+Requires-Dist: mcp<2.0,>=1.6
+Provides-Extra: test
+Requires-Dist: anyio; extra == 'test'
+Requires-Dist: pytest; extra == 'test'
+Requires-Dist: pytest-anyio; extra == 'test'
+Description-Content-Type: text/markdown
+
+# Remora MCP Server
+
+MCP server for Remora — 30 tools and 2 resources for options screening, chain browsing, trade finding, portfolio management, analytics, and market data. Connect Claude Desktop, Cursor, or any MCP-compatible AI assistant.
+
+## Tools (30)
+
+| Category | Tool | Description |
+|----------|------|-------------|
+| Screening | `screen_csp` | Screen for cash-secured puts |
+| Screening | `screen_cc` | Screen for covered calls |
+| Screening | `screen_credit_spreads` | Screen for credit spreads (bull put / bear call) |
+| Screening | `screen_long_calls` | Screen for long call options |
+| Screening | `screen_long_puts` | Screen for long put options |
+| Screening | `screen_debit_spreads` | Screen for debit spreads (bull call / bear put) |
+| Screening | `list_saved_screeners` | List your saved screener configs and their filter settings |
+| Trade Finding | `find_trades` | Find best strategies for a ticker given thesis, goal, and capital. Progressive fallback — never returns empty. |
+| Trade Finding | `compare_strategies` | Compare CSP vs LEAP strategies side-by-side |
+| Market Data | `get_chain` | Browse raw options chain for a ticker with filtering by expiration, type, volume, and open interest |
+| Market Data | `get_option_quote` | Get detailed quote for a single option contract — pricing, greeks, activity, valuation, probabilities |
+| Market Data | `get_iv_rank` | Get IV rank and IV percentile for any ticker |
+| Market Data | `get_technicals` | Get trend, 50/200-day MAs, 13-week range, and support/resistance levels |
+| Market Data | `get_earnings` | Get earnings data or upcoming earnings calendar. 5-level fallback chain for reliable data. |
+| Market Data | `get_unusual_activity` | Options flow — where big premium is moving, by ticker or market-wide |
+| Market Data | `scan_stocks` | Scan stocks by IV rank, valuation, market cap, dividend, sector, signal, and earnings proximity |
+| Portfolio | `list_portfolios` | List your portfolios with their IDs (discovery for the tools below) |
+| Portfolio | `get_portfolio` | Get portfolio details, metrics, open trades, positions, and spreads |
+| Portfolio | `get_positions` | Get stock positions (shares held) |
+| Portfolio | `get_portfolio_analytics` | Track-record analytics — win rate, avg P&L, and what entry conditions are working |
+| Portfolio | `get_morning_briefing` | Daily snapshot — open positions, unrealized P&L, expirations, and action items |
+| Portfolio | `add_trade` | Add a trade (BUY/SELL, PUT/CALL) |
+| Portfolio | `close_trade` | Close a trade with exit price |
+| Portfolio | `add_spread` | Add a spread (12 types supported) |
+| Portfolio | `close_spread` | Close a spread with exit price |
+| Portfolio | `add_position` | Add a stock position |
+| Portfolio | `refresh_prices` | Refresh live market prices |
+| Strategy | `analyze_strategy` | Payoff analysis for any multi-leg strategy — max gain/loss, breakevens, net debit/credit, strategy name |
+| Screening | `save_screener_config` | Save the current screener filter set as a named preset |
+| Portfolio | `get_trade_dna` | Your trading-style profile from closed trades — sweet-spot delta/DTE/IV and best underlyings |
+
+## Example prompts
+
+- "What should I look at today?" → `list_portfolios`, then `get_morning_briefing(portfolio_id)`
+- "Build a bull put spread on AAPL at 180/175 for Jul 17 and show me the payoff" → `analyze_strategy(legs=[...])`
+- "Screen for CSPs the way I usually trade" → `get_trade_dna()`, then `screen_csp` with the sweet-spot delta/DTE
+- "Save this screen as 'weekly income'" → `save_screener_config(name, config)`
+
+## Resources (2)
+
+- `remora://watchlists` — List all watchlists and tickers
+- `remora://watchlist/{id}` — Get a specific watchlist
+
+## Key Features
+
+- **Filter rejection summaries** — Screeners explain WHY contracts were filtered out when results are empty
+- **Progressive fallback** — `find_trades` widens DTE, tries all defined-risk strategies, and returns diagnostics with suggestions
+- **5-level earnings fallback** — `get_earnings` chains multiple data sources for reliable coverage
+- **Staleness timestamps** — All read tools show when data was last retrieved
+
+## Setup
+
+1. Generate an API key at your account page (Pro subscription required)
+2. Install: `pip install heyremora`
+3. Set environment variables (`REMORA_API_KEY`, `REMORA_API_URL`) and add to Claude Desktop config
+
+See the full setup guide at `/docs/mcp-setup` on the Remora website.

heyremora-0.5.1/PUBLISHING.md

@@ -0,0 +1,87 @@
+# Publishing to PyPI
+
+## When to publish a new version
+
+Publish a new PyPI release any time you change files under `mcp-server/src/` that affect what MCP users get when they `pip install`. Specifically:
+
+- **Tool signatures changed** — parameter names, types, defaults, or descriptions in `server.py`
+- **Client endpoints changed** — URLs, request body keys, or new/removed methods in `client.py`
+- **Dependencies changed** — anything in `pyproject.toml` `[project.dependencies]`
+- **Bug fixes** in server or client code
+
+Do NOT need a publish:
+- Changes to docs only (`README.md`, `PUBLISHING.md`, `CHANGELOG.md`)
+- Changes to backend API code (users hit the live API, not a local copy)
+- Changes to `frontend/docs/mcp-setup.html` (that's the website, not the package)
+
+## How to publish
+
+### 1. Bump the version
+
+Edit `mcp-server/pyproject.toml`:
+
+```toml
+version = "0.1.2"  # bump from previous
+```
+
+Use semver:
+- **Patch** (0.1.x): bug fixes, default changes, field renames
+- **Minor** (0.x.0): new tools, new parameters, new endpoints
+- **Major** (x.0.0): breaking changes to existing tool signatures
+
+### 2. Update the changelog
+
+Add an entry to `mcp-server/CHANGELOG.md` with the version, date, and what changed.
+
+### 3. Build
+
+```bash
+cd mcp-server
+uv build
+```
+
+This creates `.tar.gz` and `.whl` files in `mcp-server/dist/`.
+
+### 4. Publish
+
+```bash
+twine upload dist/heyremora-<VERSION>* \
+  -u __token__ \
+  -p "$(security find-generic-password -a pypi -s pypi-api-token -w)"
+```
+
+The PyPI API token is stored in the macOS Keychain under:
+- **Account:** `pypi`
+- **Service:** `pypi-api-token`
+
+### 5. Verify
+
+```bash
+pip install --upgrade heyremora
+python -c "import heyremora; print('ok')"
+```
+
+### 6. Commit and push
+
+Commit the version bump, changelog, and any source changes together. Push to `feature/tier-limiting` (or whatever the active dev branch is).
+
+## Token management
+
+The PyPI token was saved to macOS Keychain with:
+
+```bash
+security add-generic-password -a "pypi" -s "pypi-api-token" -w "pypi-TOKEN_HERE"
+```
+
+To retrieve it:
+
+```bash
+security find-generic-password -a "pypi" -s "pypi-api-token" -w
+```
+
+To rotate the token: generate a new one at https://pypi.org/manage/account/token/, then update the Keychain entry:
+
+```bash
+security delete-generic-password -a "pypi" -s "pypi-api-token"
+security add-generic-password -a "pypi" -s "pypi-api-token" -w "pypi-NEW_TOKEN"
+```

heyremora-0.5.1/README.md

@@ -0,0 +1,65 @@
+# Remora MCP Server
+
+MCP server for Remora — 30 tools and 2 resources for options screening, chain browsing, trade finding, portfolio management, analytics, and market data. Connect Claude Desktop, Cursor, or any MCP-compatible AI assistant.
+
+## Tools (30)
+
+| Category | Tool | Description |
+|----------|------|-------------|
+| Screening | `screen_csp` | Screen for cash-secured puts |
+| Screening | `screen_cc` | Screen for covered calls |
+| Screening | `screen_credit_spreads` | Screen for credit spreads (bull put / bear call) |
+| Screening | `screen_long_calls` | Screen for long call options |
+| Screening | `screen_long_puts` | Screen for long put options |
+| Screening | `screen_debit_spreads` | Screen for debit spreads (bull call / bear put) |
+| Screening | `list_saved_screeners` | List your saved screener configs and their filter settings |
+| Trade Finding | `find_trades` | Find best strategies for a ticker given thesis, goal, and capital. Progressive fallback — never returns empty. |
+| Trade Finding | `compare_strategies` | Compare CSP vs LEAP strategies side-by-side |
+| Market Data | `get_chain` | Browse raw options chain for a ticker with filtering by expiration, type, volume, and open interest |
+| Market Data | `get_option_quote` | Get detailed quote for a single option contract — pricing, greeks, activity, valuation, probabilities |
+| Market Data | `get_iv_rank` | Get IV rank and IV percentile for any ticker |
+| Market Data | `get_technicals` | Get trend, 50/200-day MAs, 13-week range, and support/resistance levels |
+| Market Data | `get_earnings` | Get earnings data or upcoming earnings calendar. 5-level fallback chain for reliable data. |
+| Market Data | `get_unusual_activity` | Options flow — where big premium is moving, by ticker or market-wide |
+| Market Data | `scan_stocks` | Scan stocks by IV rank, valuation, market cap, dividend, sector, signal, and earnings proximity |
+| Portfolio | `list_portfolios` | List your portfolios with their IDs (discovery for the tools below) |
+| Portfolio | `get_portfolio` | Get portfolio details, metrics, open trades, positions, and spreads |
+| Portfolio | `get_positions` | Get stock positions (shares held) |
+| Portfolio | `get_portfolio_analytics` | Track-record analytics — win rate, avg P&L, and what entry conditions are working |
+| Portfolio | `get_morning_briefing` | Daily snapshot — open positions, unrealized P&L, expirations, and action items |
+| Portfolio | `add_trade` | Add a trade (BUY/SELL, PUT/CALL) |
+| Portfolio | `close_trade` | Close a trade with exit price |
+| Portfolio | `add_spread` | Add a spread (12 types supported) |
+| Portfolio | `close_spread` | Close a spread with exit price |
+| Portfolio | `add_position` | Add a stock position |
+| Portfolio | `refresh_prices` | Refresh live market prices |
+| Strategy | `analyze_strategy` | Payoff analysis for any multi-leg strategy — max gain/loss, breakevens, net debit/credit, strategy name |
+| Screening | `save_screener_config` | Save the current screener filter set as a named preset |
+| Portfolio | `get_trade_dna` | Your trading-style profile from closed trades — sweet-spot delta/DTE/IV and best underlyings |
+
+## Example prompts
+
+- "What should I look at today?" → `list_portfolios`, then `get_morning_briefing(portfolio_id)`
+- "Build a bull put spread on AAPL at 180/175 for Jul 17 and show me the payoff" → `analyze_strategy(legs=[...])`
+- "Screen for CSPs the way I usually trade" → `get_trade_dna()`, then `screen_csp` with the sweet-spot delta/DTE
+- "Save this screen as 'weekly income'" → `save_screener_config(name, config)`
+
+## Resources (2)
+
+- `remora://watchlists` — List all watchlists and tickers
+- `remora://watchlist/{id}` — Get a specific watchlist
+
+## Key Features
+
+- **Filter rejection summaries** — Screeners explain WHY contracts were filtered out when results are empty
+- **Progressive fallback** — `find_trades` widens DTE, tries all defined-risk strategies, and returns diagnostics with suggestions
+- **5-level earnings fallback** — `get_earnings` chains multiple data sources for reliable coverage
+- **Staleness timestamps** — All read tools show when data was last retrieved
+
+## Setup
+
+1. Generate an API key at your account page (Pro subscription required)
+2. Install: `pip install heyremora`
+3. Set environment variables (`REMORA_API_KEY`, `REMORA_API_URL`) and add to Claude Desktop config
+
+See the full setup guide at `/docs/mcp-setup` on the Remora website.

heyremora-0.5.1/pyproject.toml

@@ -0,0 +1,24 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "heyremora"
+version = "0.5.1"
+description = "MCP server for Remora — options screening, portfolio analytics, and strategy comparison via Claude Desktop"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+dependencies = [
+    "mcp>=1.6,<2.0",
+    "httpx>=0.24,<1.0",
+]
+
+[project.optional-dependencies]
+test = ["pytest", "pytest-anyio", "anyio"]
+
+[project.scripts]
+heyremora = "heyremora.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/heyremora"]

heyremora-0.5.1/src/heyremora/__init__.py

@@ -0,0 +1,3 @@
+"""Remora MCP Server — options screening via Claude Desktop."""
+
+__version__ = "0.3.0"

heyremora-0.5.1/src/heyremora/client.py

@@ -0,0 +1,212 @@
+"""HTTP client for the Remora API."""
+
+from typing import Any, Dict, List, Optional
+import httpx
+
+
+class OTXClientError(Exception):
+    """Raised on API errors with a user-friendly message."""
+
+    def __init__(self, message: str, status_code: int = 0):
+        self.status_code = status_code
+        super().__init__(message)
+
+
+class OTXClient:
+    """Async HTTP client wrapping the Remora REST API."""
+
+    def __init__(self, api_key: str, base_url: str):
+        self._client = httpx.AsyncClient(
+            base_url=base_url,
+            headers={"X-API-Key": api_key},
+            timeout=120.0,
+        )
+
+    async def close(self):
+        await self._client.aclose()
+
+    async def _request(self, method: str, path: str, **kwargs) -> Any:
+        try:
+            resp = await self._client.request(method, path, **kwargs)
+        except httpx.ConnectError:
+            raise OTXClientError(
+                "Cannot connect to Remora API. Check your REMORA_API_URL environment variable."
+            )
+        except httpx.TimeoutException:
+            raise OTXClientError("Request timed out. The API may be under heavy load — try again.")
+
+        if resp.status_code == 401:
+            raise OTXClientError(
+                "Invalid API key. Check your REMORA_API_KEY matches what was created at /account.",
+                status_code=401,
+            )
+        if resp.status_code == 403:
+            detail = resp.json().get("detail", "") if resp.headers.get("content-type", "").startswith("application/json") else ""
+            if "trial" in detail.lower() or "expired" in detail.lower():
+                raise OTXClientError(
+                    "Trial expired. A Pro subscription is required. Manage at /account.",
+                    status_code=403,
+                )
+            raise OTXClientError(
+                "API key inactive — Pro subscription required. Manage at /account.",
+                status_code=403,
+            )
+        if resp.status_code == 429:
+            raise OTXClientError(
+                "Rate limit exceeded. Please wait before making more requests.",
+                status_code=429,
+            )
+        if resp.status_code >= 400:
+            detail = ""
+            try:
+                detail = resp.json().get("detail", "")
+            except Exception:
+                pass
+            raise OTXClientError(
+                f"API error ({resp.status_code}): {detail or resp.text[:200]}",
+                status_code=resp.status_code,
+            )
+
+        return resp.json()
+
+    async def _get(self, path: str, params: Optional[Dict] = None) -> Any:
+        return await self._request("GET", path, params=params)
+
+    async def _post(self, path: str, json: Optional[Dict] = None) -> Any:
+        return await self._request("POST", path, json=json)
+
+    # ── Screener endpoints ──
+
+    async def screen_options(self, body: Dict) -> Dict:
+        return await self._post("/api/screener/screen", json=body)
+
+    async def screen_long_calls(self, body: Dict) -> Dict:
+        return await self._post("/api/screener/long-calls", json=body)
+
+    async def screen_long_puts(self, body: Dict) -> Dict:
+        return await self._post("/api/screener/long-puts", json=body)
+
+    async def screen_spreads(self, body: Dict) -> Dict:
+        return await self._post("/api/spreads/screen", json=body)
+
+    async def find_trades(self, body: Dict) -> Dict:
+        return await self._post("/api/trade-finder/find", json=body)
+
+    # ── Portfolio endpoints ──
+
+    async def list_portfolios(self) -> Any:
+        return await self._get("/api/user/portfolios")
+
+    async def get_portfolio(self, portfolio_id: str) -> Dict:
+        return await self._get(f"/api/user/portfolios/{portfolio_id}")
+
+    async def get_positions(self, portfolio_id: str) -> Any:
+        return await self._get(f"/api/user/portfolios/{portfolio_id}/positions")
+
+    async def add_trade(self, portfolio_id: str, body: Dict) -> Dict:
+        return await self._post(f"/api/user/portfolios/{portfolio_id}/trades", json=body)
+
+    async def close_trade(self, portfolio_id: str, trade_id: str, body: Dict) -> Dict:
+        return await self._post(f"/api/user/portfolios/{portfolio_id}/trades/{trade_id}/close", json=body)
+
+    async def add_spread(self, portfolio_id: str, body: Dict) -> Dict:
+        return await self._post(f"/api/user/portfolios/{portfolio_id}/spreads", json=body)
+
+    async def close_spread(self, portfolio_id: str, spread_id: str, body: Dict) -> Dict:
+        return await self._post(f"/api/user/portfolios/{portfolio_id}/spreads/{spread_id}/close", json=body)
+
+    async def add_position(self, portfolio_id: str, body: Dict) -> Dict:
+        return await self._post(f"/api/user/portfolios/{portfolio_id}/positions", json=body)
+
+    async def refresh_prices(self, portfolio_id: str) -> Dict:
+        return await self._get(f"/api/user/portfolios/{portfolio_id}/trades/refresh-prices")
+
+    async def get_user_analytics(self, period: str = "all", portfolio_id: Optional[str] = None) -> Dict:
+        params: Dict[str, Any] = {"period": period}
+        if portfolio_id:
+            params["portfolio_id"] = portfolio_id
+        return await self._get("/api/user/portfolios/analytics/closed-trades", params=params)
+
+    # ── IV & Earnings ──
+
+    async def get_iv_rank(self, ticker: str) -> Dict:
+        return await self._get(f"/api/iv/{ticker}")
+
+    async def get_earnings_ticker(self, ticker: str) -> Dict:
+        return await self._get(f"/api/earnings/{ticker}")
+
+    async def get_earnings_calendar(self, within_days: int = 14) -> Any:
+        return await self._get("/api/earnings/calendar", params={"within_days": within_days})
+
+    # ── Technicals ──
+
+    async def get_technicals(self, ticker: str, force_refresh: bool = False) -> Dict:
+        params: Dict[str, Any] = {}
+        if force_refresh:
+            params["force_refresh"] = True
+        return await self._get(f"/api/technicals/{ticker}", params=params or None)
+
+    # ── Unusual options activity (flow) ──
+
+    async def get_options_flow(self, limit: int = 20) -> Dict:
+        return await self._get("/api/unusual-activity", params={"limit": limit})
+
+    async def get_ticker_flow(self, ticker: str) -> Dict:
+        return await self._get(f"/api/unusual-activity/ticker/{ticker}")
+
+    # ── Scanner ──
+
+    async def get_scanner_stocks(self, params: Optional[Dict] = None) -> Dict:
+        return await self._get("/api/scanner/stocks", params=params or None)
+
+    # ── Saved screeners & morning briefing ──
+
+    async def get_screener_configs(self) -> Any:
+        return await self._get("/api/screener-configs")
+
+    async def get_briefing(self, portfolio_id: str) -> Dict:
+        return await self._get(f"/api/notifications/briefing/preview/{portfolio_id}")
+
+    # ── Chain ──
+
+    async def get_chain(
+        self, ticker: str, expiration: str = None, option_type: str = None,
+        min_volume: int = 0, min_open_interest: int = 0, top: int = 200,
+        sort: str = "strike",
+    ) -> Dict:
+        params: Dict[str, Any] = {"top": top, "sort": sort}
+        if expiration:
+            params["expiration"] = expiration
+        if option_type:
+            params["type"] = option_type
+        if min_volume:
+            params["min_volume"] = min_volume
+        if min_open_interest:
+            params["min_open_interest"] = min_open_interest
+        return await self._get(f"/api/chain/{ticker}", params=params)
+
+    async def get_option_quote(
+        self, ticker: str, expiration: str, strike: float, option_type: str,
+    ) -> Dict:
+        return await self._get(f"/api/chain/{ticker}/quote", params={
+            "expiration": expiration,
+            "strike": strike,
+            "type": option_type,
+        })
+
+    # ── Watchlists ──
+
+    async def get_watchlists(self) -> Any:
+        return await self._get("/api/watchlists/")
+
+    async def get_watchlist(self, watchlist_id: str) -> Dict:
+        return await self._get(f"/api/watchlists/{watchlist_id}")
+
+    async def analyze_strategy(self, body: Dict) -> Dict:
+        return await self._post("/api/strategy/analyze", json=body)
+
+    async def save_screener_config(self, body: Dict) -> Dict:
+        return await self._post("/api/screener-configs", json=body)
+
+    async def get_trade_dna(self) -> Dict:
+        return await self._get("/api/user/portfolios/analytics/trade-dna")

heyremora-0.5.1/src/heyremora/config.py

@@ -0,0 +1,36 @@
+"""Configuration — reads REMORA_API_KEY and REMORA_API_URL from environment.
+
+The legacy OTX_API_KEY / OTX_API_URL names are still accepted as a fallback so
+existing setups keep working after the rebrand.
+"""
+
+import os
+import sys
+
+
+def get_api_key() -> str:
+    key = os.environ.get("REMORA_API_KEY") or os.environ.get("OTX_API_KEY", "")
+    if not key:
+        print(
+            "ERROR: REMORA_API_KEY environment variable is required.\n"
+            "Generate one at https://heyremora.com/account (Pro subscription required).\n"
+            "Then set it: export REMORA_API_KEY=<your-key>",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    return key
+
+
+def get_base_url() -> str:
+    url = os.environ.get("REMORA_API_URL") or os.environ.get("OTX_API_URL", "")
+    if not url:
+        print(
+            "ERROR: REMORA_API_URL environment variable is required.\n"
+            "Set it to the Remora API URL, e.g.:\n"
+            "  export REMORA_API_URL=https://heyremora.com\n"
+            "For local development:\n"
+            "  export REMORA_API_URL=http://localhost:8000",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    return url.rstrip("/")