aipa-cli 0.1.26__tar.gz → 0.1.28__tar.gz

{aipa_cli-0.1.26 → aipa_cli-0.1.28}/CHANGELOG.md

@@ -5,6 +5,21 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.28] - 2026-05-11
+
+### Added
+- `--group` sector filter for `aipa performers` and `get_performers` agent tool (e.g. `--group NGAN_HANG`)
+
+## [0.1.27] - 2026-05-11
+
+### Added
+- `aipa performers` CLI command: rank top/worst performers by price change, volume, value (close × volume), MA scores, or money flow (defaults to VN stocks)
+- `aipa volume-profile TICKER` CLI command: volume-by-price histogram analysis with POC, value area, and statistics
+- `get_performers` and `get_volume_profile` agent tools for AI-powered market analysis
+
+### Changed
+- Require `aipriceaction>=0.1.13` for performers and volume_profile modules
+
 ## [0.1.26] - 2026-05-11
 
 ### Added

{aipa_cli-0.1.26 → aipa_cli-0.1.28}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aipa-cli
-Version: 0.1.26
+Version: 0.1.28
 Summary: Terminal TUI for AI-powered ticker analysis
 Project-URL: Homepage, https://github.com/quanhua92/aipriceaction
 Project-URL: Repository, https://github.com/quanhua92/aipriceaction
@@ -15,7 +15,7 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Office/Business :: Financial
 Requires-Python: >=3.13
-Requires-Dist: aipriceaction>=0.1.12
+Requires-Dist: aipriceaction>=0.1.13
 Requires-Dist: langchain-core
 Requires-Dist: langchain-openai
 Requires-Dist: langgraph
@@ -134,6 +134,21 @@ aipa ticker-list --source vn --group NGAN_HANG
 # Compact output (symbols only)
 aipa ticker-list --source crypto --compact
 
+# Top 10 VN performers by price change (default)
+aipa performers
+
+# Top 5 by volume
+aipa performers --sort-by volume --limit 5
+
+# Top 10 by trading value
+aipa performers --sort-by value --limit 10
+
+# Volume profile for VCB today
+aipa volume-profile VCB
+
+# Volume profile for BTCUSDT
+aipa volume-profile BTCUSDT --source crypto --bins 30
+
 # List saved chat sessions
 aipa resume
 
@@ -175,7 +190,7 @@ aipa analyze VCB --lang en
 | `--question TEXT` | Custom analysis question |
 | `--questions` | List available question templates and exit |
 | `--context-only` | Dump raw context without LLM (no API key needed) |
-| `--interval` | Time interval: `1m`, `5m`, `15m`, `30m`, `1h`, `4h`, `1D`, `1W` (default: `1D`) |
+| `--interval` | Time interval: `1m`, `5m`, `15m`, `30m`, `1h`, `4h`, `1D`, `1W`, `2W` (default: `1D`) |
 | `--limit N` | Number of bars (default: 20) |
 | `--source` | Filter by source: `vn` or `crypto` |
 | `--start-date` / `--end-date` | Date range (e.g. `2026-04-01`) |
@@ -241,7 +256,7 @@ aipa get-ohlcv-data BTCUSDT --interval 1D --limit 30
 
 | Flag | Description |
 |---|---|
-| `--interval` | Time interval (default: `1D`) |
+| `--interval` | Time interval: `1m`, `5m`, `15m`, `30m`, `1h`, `4h`, `1D`, `1W`, `2W` (default: `1D`) |
 | `--limit N` | Number of bars |
 | `--start-date` / `--end-date` | Date range |
 | `--source` | Filter by source: `vn` or `crypto` |
@@ -272,7 +287,7 @@ aipa live-data VCB TCB MBB
 |---|---|
 | `TICKERS...` | Optional ticker symbols (omit for top N) |
 | `--top N` | Number of top tickers to show (default: 50) |
-| `--interval` | Time interval: `1D`, `1h`, `1m` (default: `1D`) |
+| `--interval` | Time interval: `1m`, `5m`, `15m`, `30m`, `1h`, `4h`, `1D`, `1W`, `2W` (default: `1D`) |
 | `--source` | Filter by source: `vn`, `crypto`, `global`, `sjc` |
 
 ### `aipa ticker-list`
@@ -299,6 +314,66 @@ aipa ticker-list --source crypto --compact
 | `--group` | Filter by group (e.g. `NGAN_HANG`, `CHUNG_KHOAN`, `BAT_DONG_SAN`) |
 | `--compact` | Output symbols only, comma-separated |
 
+### `aipa performers`
+
+Rank top and worst performers by any metric. Fetches live daily data with MA indicators — no API key needed. Defaults to VN stocks.
+
+```
+# Top 10 VN stocks by price change (default)
+aipa performers
+
+# Top 5 by volume, ascending
+aipa performers --sort-by volume --direction asc --limit 5
+
+# Top 20 by MA50 score
+aipa performers --sort-by ma50_score --limit 20
+
+# Crypto performers
+aipa performers --source crypto --limit 5
+
+# Banking sector only
+aipa performers --group NGAN_HANG --sort-by value
+
+# Securities sector top gainers
+aipa performers --group CHUNG_KHOAN --sort-by close_changed --limit 5
+```
+
+| Flag | Description |
+|---|---|
+| `--sort-by` | Metric: `close_changed` (default), `volume`, `value`, `volume_changed`, `ma10_score`, `ma20_score`, `ma50_score`, `ma100_score`, `ma200_score`, `total_money_changed` |
+| `--direction` | `desc` (default) or `asc` |
+| `--limit N` | Entries per list (default: 10) |
+| `--min-volume N` | Min volume filter for VN tickers (default: 10000) |
+| `--source` | Data source: `vn` (default), `crypto`, `global`, `yahoo`, `sjc` |
+| `--group` | Filter by sector (e.g. `NGAN_HANG`, `CHUNG_KHOAN`, `BAT_DONG_SAN`) |
+
+### `aipa volume-profile`
+
+Volume-by-price histogram analysis from 1-minute data. Shows POC, value area, volume-weighted statistics, and a visual bar chart — no API key needed.
+
+```
+# Today's profile for VCB
+aipa volume-profile VCB
+
+# Specific date
+aipa volume-profile VCB --date 2026-05-09
+
+# Crypto with fewer bins
+aipa volume-profile BTCUSDT --source crypto --bins 30
+
+# Date range with custom value area
+aipa volume-profile FPT --start-date 2026-05-05 --end-date 2026-05-09 --value-area-pct 80
+```
+
+| Flag | Description |
+|---|---|
+| `TICKER` | Ticker symbol (required) |
+| `--date` | Single date (YYYY-MM-DD), defaults to today |
+| `--start-date` / `--end-date` | Date range |
+| `--source` | Source for tick size logic: `vn` (default), `crypto`, `global`, `yahoo`, `sjc` |
+| `--bins N` | Number of price bins (default: 50, range: 2–200) |
+| `--value-area-pct` | Value area target % (default: 70, range: 60–90) |
+
 ### `aipa setup`
 
 Interactive first-run configuration. Prompts for language, reference ticker, API key, base URL, and model. Settings are saved to `~/.aipriceaction/settings.json`. Re-running shows current values as defaults.
@@ -336,6 +411,8 @@ Commands that require an API key will auto-run `aipa setup` on first use if not
 | `aipa get-ohlcv-data` | No setup needed |
 | `aipa live-data` | No setup needed |
 | `aipa ticker-list` | No setup needed |
+| `aipa performers` | No setup needed |
+| `aipa volume-profile VCB` | No setup needed |
 | `aipa analyze VCB --context-only` | No setup needed |
 | `aipa analyze VCB --questions` | No setup needed |
 | `aipa resume` | No setup needed |
@@ -350,10 +427,10 @@ Commands that require an API key will auto-run `aipa setup` on first use if not
 Launch the TUI with `aipa`. The interface has six tabs:
 
 - **Chat** — AI-powered chat with streaming responses, thinking/reasoning display, slash commands, and arrow-key history navigation
+- **Workflows** — Structured analysis forms with question bank dropdown for ticker analysis and deep research
 - **Vietnam** — Browse and search Vietnamese stock tickers
 - **Crypto** — Browse and search cryptocurrency tickers
 - **Global** — Browse and search global/Yahoo tickers
-- **Workflows** — Structured analysis forms with question bank dropdown for ticker analysis and deep research
 - **Settings** — Configure API key, model, base URL, and other preferences
 
 ### Slash Commands (Chat tab)

{aipa_cli-0.1.26 → aipa_cli-0.1.28}/README.md

@@ -108,6 +108,21 @@ aipa ticker-list --source vn --group NGAN_HANG
 # Compact output (symbols only)
 aipa ticker-list --source crypto --compact
 
+# Top 10 VN performers by price change (default)
+aipa performers
+
+# Top 5 by volume
+aipa performers --sort-by volume --limit 5
+
+# Top 10 by trading value
+aipa performers --sort-by value --limit 10
+
+# Volume profile for VCB today
+aipa volume-profile VCB
+
+# Volume profile for BTCUSDT
+aipa volume-profile BTCUSDT --source crypto --bins 30
+
 # List saved chat sessions
 aipa resume
 
@@ -149,7 +164,7 @@ aipa analyze VCB --lang en
 | `--question TEXT` | Custom analysis question |
 | `--questions` | List available question templates and exit |
 | `--context-only` | Dump raw context without LLM (no API key needed) |
-| `--interval` | Time interval: `1m`, `5m`, `15m`, `30m`, `1h`, `4h`, `1D`, `1W` (default: `1D`) |
+| `--interval` | Time interval: `1m`, `5m`, `15m`, `30m`, `1h`, `4h`, `1D`, `1W`, `2W` (default: `1D`) |
 | `--limit N` | Number of bars (default: 20) |
 | `--source` | Filter by source: `vn` or `crypto` |
 | `--start-date` / `--end-date` | Date range (e.g. `2026-04-01`) |
@@ -215,7 +230,7 @@ aipa get-ohlcv-data BTCUSDT --interval 1D --limit 30
 
 | Flag | Description |
 |---|---|
-| `--interval` | Time interval (default: `1D`) |
+| `--interval` | Time interval: `1m`, `5m`, `15m`, `30m`, `1h`, `4h`, `1D`, `1W`, `2W` (default: `1D`) |
 | `--limit N` | Number of bars |
 | `--start-date` / `--end-date` | Date range |
 | `--source` | Filter by source: `vn` or `crypto` |
@@ -246,7 +261,7 @@ aipa live-data VCB TCB MBB
 |---|---|
 | `TICKERS...` | Optional ticker symbols (omit for top N) |
 | `--top N` | Number of top tickers to show (default: 50) |
-| `--interval` | Time interval: `1D`, `1h`, `1m` (default: `1D`) |
+| `--interval` | Time interval: `1m`, `5m`, `15m`, `30m`, `1h`, `4h`, `1D`, `1W`, `2W` (default: `1D`) |
 | `--source` | Filter by source: `vn`, `crypto`, `global`, `sjc` |
 
 ### `aipa ticker-list`
@@ -273,6 +288,66 @@ aipa ticker-list --source crypto --compact
 | `--group` | Filter by group (e.g. `NGAN_HANG`, `CHUNG_KHOAN`, `BAT_DONG_SAN`) |
 | `--compact` | Output symbols only, comma-separated |
 
+### `aipa performers`
+
+Rank top and worst performers by any metric. Fetches live daily data with MA indicators — no API key needed. Defaults to VN stocks.
+
+```
+# Top 10 VN stocks by price change (default)
+aipa performers
+
+# Top 5 by volume, ascending
+aipa performers --sort-by volume --direction asc --limit 5
+
+# Top 20 by MA50 score
+aipa performers --sort-by ma50_score --limit 20
+
+# Crypto performers
+aipa performers --source crypto --limit 5
+
+# Banking sector only
+aipa performers --group NGAN_HANG --sort-by value
+
+# Securities sector top gainers
+aipa performers --group CHUNG_KHOAN --sort-by close_changed --limit 5
+```
+
+| Flag | Description |
+|---|---|
+| `--sort-by` | Metric: `close_changed` (default), `volume`, `value`, `volume_changed`, `ma10_score`, `ma20_score`, `ma50_score`, `ma100_score`, `ma200_score`, `total_money_changed` |
+| `--direction` | `desc` (default) or `asc` |
+| `--limit N` | Entries per list (default: 10) |
+| `--min-volume N` | Min volume filter for VN tickers (default: 10000) |
+| `--source` | Data source: `vn` (default), `crypto`, `global`, `yahoo`, `sjc` |
+| `--group` | Filter by sector (e.g. `NGAN_HANG`, `CHUNG_KHOAN`, `BAT_DONG_SAN`) |
+
+### `aipa volume-profile`
+
+Volume-by-price histogram analysis from 1-minute data. Shows POC, value area, volume-weighted statistics, and a visual bar chart — no API key needed.
+
+```
+# Today's profile for VCB
+aipa volume-profile VCB
+
+# Specific date
+aipa volume-profile VCB --date 2026-05-09
+
+# Crypto with fewer bins
+aipa volume-profile BTCUSDT --source crypto --bins 30
+
+# Date range with custom value area
+aipa volume-profile FPT --start-date 2026-05-05 --end-date 2026-05-09 --value-area-pct 80
+```
+
+| Flag | Description |
+|---|---|
+| `TICKER` | Ticker symbol (required) |
+| `--date` | Single date (YYYY-MM-DD), defaults to today |
+| `--start-date` / `--end-date` | Date range |
+| `--source` | Source for tick size logic: `vn` (default), `crypto`, `global`, `yahoo`, `sjc` |
+| `--bins N` | Number of price bins (default: 50, range: 2–200) |
+| `--value-area-pct` | Value area target % (default: 70, range: 60–90) |
+
 ### `aipa setup`
 
 Interactive first-run configuration. Prompts for language, reference ticker, API key, base URL, and model. Settings are saved to `~/.aipriceaction/settings.json`. Re-running shows current values as defaults.
@@ -310,6 +385,8 @@ Commands that require an API key will auto-run `aipa setup` on first use if not
 | `aipa get-ohlcv-data` | No setup needed |
 | `aipa live-data` | No setup needed |
 | `aipa ticker-list` | No setup needed |
+| `aipa performers` | No setup needed |
+| `aipa volume-profile VCB` | No setup needed |
 | `aipa analyze VCB --context-only` | No setup needed |
 | `aipa analyze VCB --questions` | No setup needed |
 | `aipa resume` | No setup needed |
@@ -324,10 +401,10 @@ Commands that require an API key will auto-run `aipa setup` on first use if not
 Launch the TUI with `aipa`. The interface has six tabs:
 
 - **Chat** — AI-powered chat with streaming responses, thinking/reasoning display, slash commands, and arrow-key history navigation
+- **Workflows** — Structured analysis forms with question bank dropdown for ticker analysis and deep research
 - **Vietnam** — Browse and search Vietnamese stock tickers
 - **Crypto** — Browse and search cryptocurrency tickers
 - **Global** — Browse and search global/Yahoo tickers
-- **Workflows** — Structured analysis forms with question bank dropdown for ticker analysis and deep research
 - **Settings** — Configure API key, model, base URL, and other preferences
 
 ### Slash Commands (Chat tab)

{aipa_cli-0.1.26 → aipa_cli-0.1.28}/pyproject.toml

@@ -9,7 +9,7 @@ license = "MIT"
 readme = "README.md"
 requires-python = ">=3.13"
 dependencies = [
-    "aipriceaction>=0.1.12",
+    "aipriceaction>=0.1.13",
     "textual>=3.0.0",
     "textual-autocomplete>=4.0.6",
     "textual-plotext>=0.4.1",

{aipa_cli-0.1.26 → aipa_cli-0.1.28}/src/aipriceaction_terminal/__init__.py

@@ -1,4 +1,4 @@
 """AIPriceAction Terminal - TUI chat interface for ticker analysis."""
 
-__version__ = "0.1.26"
+__version__ = "0.1.28"
 

{aipa_cli-0.1.26 → aipa_cli-0.1.28}/src/aipriceaction_terminal/agents/tools.py

@@ -238,10 +238,188 @@ def create_live_data_tool(lang: str = "en") -> ToolDef:
     )
 
 
+def create_performers_tool(lang: str = "en") -> ToolDef:
+    """Factory: creates the get_performers tool."""
+
+    @tool
+    def get_performers(
+        sort_by: str = "close_changed",
+        direction: str = "desc",
+        limit: int = 10,
+        source: str | None = None,
+        group: str | None = None,
+    ) -> str:
+        """Rank top and worst performers from live daily data by a chosen metric.
+
+        Returns two ranked lists (top and worst) of performers. Useful for
+        identifying market leaders, laggards, and sector trends.
+
+        Args:
+            sort_by: Metric to rank by — "close_changed" (default), "volume",
+                "value" (close × volume), "volume_changed",
+                "ma10_score", "ma20_score", "ma50_score",
+                "ma100_score", "ma200_score", "total_money_changed".
+            direction: Sort direction — "desc" (default, strongest first in top)
+                or "asc" (weakest first in top).
+            limit: Number of entries per list (default 10, max 100).
+            source: Filter by source — "vn" (default), "crypto", "yahoo". None = vn.
+            group: Filter by group/sector — e.g. "NGAN_HANG", "CHUNG_KHOAN",
+                "BAT_DONG_SAN", "CONG_NGHE", "DAU_KHI". None = all sectors.
+        """
+        from aipriceaction.performers import build_performers
+
+        client, _ = _ensure_clients(lang)
+        try:
+            data = client.fetch_live_data("1D", ma=True)
+        except Exception as e:
+            return f"Error fetching live data: {e}"
+        if not data:
+            return "No live data available."
+
+        sector_map: dict[str, str] = {}
+        if source:
+            tickers_meta = client.get_tickers(source=source)
+            sector_map = {t.ticker: t.group for t in tickers_meta if t.group}
+            source_symbols = {t.ticker for t in tickers_meta}
+            data = {k: v for k, v in data.items() if k in source_symbols}
+
+        # Filter by group/sector if specified
+        if group:
+            group_upper = group.upper()
+            data = {k: v for k, v in data.items() if sector_map.get(k, "").upper() == group_upper}
+
+        top, worst = build_performers(
+            data, sector_map,
+            sort_by=sort_by,
+            direction=direction,
+            limit=limit,
+            source=source,
+        )
+
+        lines = [f"Top {len(top)} performers (by {sort_by}, {direction}):"]
+        for i, p in enumerate(top, 1):
+            chg = f"{p.close_changed:+.2f}%" if p.close_changed is not None else "N/A"
+            sector = f" [{p.sector}]" if p.sector else ""
+            lines.append(f"  {i}. {p.symbol}: close={p.close:.2f} change={chg} vol={p.volume:,} value={p.value:,.0f}{sector}")
+
+        lines.append(f"\nWorst {len(worst)} performers (by {sort_by}):")
+        for i, p in enumerate(worst, 1):
+            chg = f"{p.close_changed:+.2f}%" if p.close_changed is not None else "N/A"
+            sector = f" [{p.sector}]" if p.sector else ""
+            lines.append(f"  {i}. {p.symbol}: close={p.close:.2f} change={chg} vol={p.volume:,} value={p.value:,.0f}{sector}")
+
+        return "\n".join(lines)
+
+    return ToolDef(
+        tool=get_performers,
+        name="get_performers",
+        description="Rank top and worst performers by price change, volume, or MA scores.",
+        category="market_data",
+    )
+
+
+def create_volume_profile_tool(lang: str = "en") -> ToolDef:
+    """Factory: creates the get_volume_profile tool."""
+
+    @tool
+    def get_volume_profile(
+        ticker: str,
+        date: str | None = None,
+        start_date: str | None = None,
+        end_date: str | None = None,
+        bins: int = 50,
+        value_area_pct: float = 70.0,
+    ) -> str:
+        """Compute volume-by-price histogram for a ticker using 1-minute data.
+
+        Returns the Point of Control (POC), Value Area, volume-weighted statistics,
+        and the binned profile. Useful for identifying key support/resistance levels
+        based on where the most volume traded.
+
+        Args:
+            ticker: Ticker symbol (e.g. "VCB", "BTCUSDT").
+            date: Single date in YYYY-MM-DD format. Defaults to today.
+            start_date: Start date (YYYY-MM-DD). Alternative to --date.
+            end_date: End date (YYYY-MM-DD). Defaults to start_date.
+            bins: Number of price bins (default 50, range 2-200).
+            value_area_pct: Value area target percentage (default 70, range 60-90).
+        """
+        from datetime import date as date_type
+
+        from aipriceaction.volume_profile import compute_volume_profile
+
+        client, _ = _ensure_clients(lang)
+        ticker = ticker.upper()
+
+        # Resolve date range
+        if date:
+            sd = ed = date
+        elif start_date:
+            sd = start_date
+            ed = end_date or start_date
+        else:
+            today = date_type.today().isoformat()
+            sd = ed = today
+
+        # Resolve source for tick size
+        source = "vn"
+        try:
+            tickers_meta = client.get_tickers()
+            for t in tickers_meta:
+                if t.ticker == ticker:
+                    source = t.source or "vn"
+                    break
+        except Exception:
+            pass
+
+        try:
+            df = client.get_ohlcv(ticker, interval="1m", start_date=sd, end_date=ed, ma=False)
+        except Exception as e:
+            return f"Error fetching 1m data for {ticker}: {e}"
+
+        if df is None or df.empty:
+            return f"No 1m data found for {ticker} on {sd}."
+
+        result = compute_volume_profile(df, ticker, source=source, bins=bins, value_area_pct=value_area_pct)
+
+        lines = [
+            f"Volume Profile: {result.symbol} ({sd})",
+            f"Volume: {result.total_volume:,}  Minutes: {result.total_minutes}",
+            f"Range: {result.price_range.low:.2f} - {result.price_range.high:.2f}",
+            f"POC: {result.poc.price:.2f} ({result.poc.percentage:.1f}%)",
+            f"Value Area: {result.value_area.low:.2f} - {result.value_area.high:.2f} ({result.value_area.percentage:.1f}%)",
+        ]
+
+        if result.statistics:
+            s = result.statistics
+            lines.append(f"Mean: {s.mean_price:.2f}  Median: {s.median_price:.2f}  "
+                         f"StdDev: {s.std_deviation:.2f}  Skew: {s.skewness:.4f}")
+
+        if result.profile:
+            lines.append(f"\nProfile ({len(result.profile)} bins):")
+            max_vol = max(p.volume for p in result.profile)
+            for level in result.profile:
+                bar_len = int(level.volume / max_vol * 25) if max_vol > 0 else 0
+                bar = "\u2588" * bar_len
+                lines.append(f"  {level.price:>10.2f}  vol={level.volume:>10,.0f}  "
+                             f"{level.percentage:>5.1f}%  {bar}")
+
+        return "\n".join(lines)
+
+    return ToolDef(
+        tool=get_volume_profile,
+        name="get_volume_profile",
+        description="Volume-by-price histogram with POC, value area, and statistics.",
+        category="market_data",
+    )
+
+
 def get_default_tools(lang: str = "en") -> ToolRegistry:
     """Return a ToolRegistry pre-loaded with the built-in market data tools."""
     registry = ToolRegistry()
     registry.register(create_ohlcv_tool(lang))
     registry.register(create_ticker_list_tool(lang))
     registry.register(create_live_data_tool(lang))
+    registry.register(create_performers_tool(lang))
+    registry.register(create_volume_profile_tool(lang))
     return registry

{aipa_cli-0.1.26 → aipa_cli-0.1.28}/src/aipriceaction_terminal/cli.py

@@ -74,6 +74,30 @@ def run():
     p_tlist.add_argument("--group", default=None, help="Filter by group (e.g. NGAN_HANG, CHUNG_KHOAN)")
     p_tlist.add_argument("--compact", action="store_true", help="Output symbols only, comma-separated")
 
+    # aipa performers [--sort-by close_changed] [--direction desc] [--limit 10]
+    #   [--min-volume 10000] [--source vn] [--group NGAN_HANG]
+    p_perf = sub.add_parser("performers", help="Top/worst performers ranked by a chosen metric")
+    p_perf.add_argument("--sort-by", default="close_changed",
+        choices=["close_changed", "volume", "value", "volume_changed",
+                 "ma10_score", "ma20_score", "ma50_score", "ma100_score", "ma200_score",
+                 "total_money_changed"])
+    p_perf.add_argument("--direction", default="desc", choices=["desc", "asc"])
+    p_perf.add_argument("--limit", type=int, default=10)
+    p_perf.add_argument("--min-volume", type=int, default=10000)
+    p_perf.add_argument("--source", default="vn", choices=["vn", "crypto", "global", "yahoo", "sjc"])
+    p_perf.add_argument("--group", default=None, help="Filter by group/sector (e.g. NGAN_HANG, CHUNG_KHOAN, BAT_DONG_SAN)")
+
+    # aipa volume-profile TICKER [--date YYYY-MM-DD] [--start-date] [--end-date]
+    #   [--source vn] [--bins 50] [--value-area-pct 70]
+    p_vp = sub.add_parser("volume-profile", help="Volume-by-price histogram analysis")
+    p_vp.add_argument("ticker", help="Ticker symbol")
+    p_vp.add_argument("--date", default=None, help="Single date (YYYY-MM-DD)")
+    p_vp.add_argument("--start-date", default=None, help="Start date (YYYY-MM-DD)")
+    p_vp.add_argument("--end-date", default=None, help="End date (YYYY-MM-DD)")
+    p_vp.add_argument("--source", default=None, choices=["vn", "crypto", "global", "yahoo", "sjc"])
+    p_vp.add_argument("--bins", type=int, default=50, help="Number of price bins (2-200)")
+    p_vp.add_argument("--value-area-pct", type=float, default=70.0, help="Value area target percentage (60-90)")
+
     # aipa setup
     sub.add_parser("setup", help="Interactive first-run setup")
 
@@ -100,6 +124,12 @@ def run():
     elif args.command == "ticker-list":
         from .cli_commands import cmd_ticker_list
         cmd_ticker_list(args)
+    elif args.command == "performers":
+        from .cli_commands import cmd_performers
+        cmd_performers(args)
+    elif args.command == "volume-profile":
+        from .cli_commands import cmd_volume_profile
+        cmd_volume_profile(args)
     elif args.command == "deep-research":
         if getattr(args, "run", False):
             _ensure_setup()

{aipa_cli-0.1.26 → aipa_cli-0.1.28}/src/aipriceaction_terminal/cli_commands.py

@@ -396,3 +396,148 @@ def _resolve_cli_question(builder, args) -> str:
         return templates[0]["question"]
 
     return ""
+
+
+def cmd_performers(args) -> None:
+    """CLI handler: aipa performers."""
+    from aipriceaction import AIPriceAction
+    from aipriceaction.performers import build_performers
+
+    client = AIPriceAction()
+    source = _resolve_source(args.source)
+
+    # Fetch live 1D data with MA indicators
+    data = client.fetch_live_data("1D", ma=True)
+    if not data:
+        print("No live data available.", file=sys.stderr)
+        sys.exit(1)
+
+    # Build sector map from ticker metadata
+    sector_map: dict[str, str] = {}
+    if source:
+        tickers_meta = client.get_tickers(source=source)
+        sector_map = {t.ticker: t.group for t in tickers_meta if t.group}
+        # Filter live data to source tickers
+        source_symbols = {t.ticker for t in tickers_meta}
+        data = {k: v for k, v in data.items() if k in source_symbols}
+
+    # Filter by group/sector if specified
+    if args.group:
+        group_upper = args.group.upper()
+        data = {k: v for k, v in data.items() if sector_map.get(k, "").upper() == group_upper}
+
+    top, worst = build_performers(
+        data, sector_map,
+        sort_by=args.sort_by,
+        direction=args.direction,
+        limit=args.limit,
+        min_volume=args.min_volume,
+        source=source,
+    )
+
+    import pandas as pd
+
+    if top:
+        print(f"\n=== Top {len(top)} Performers (by {args.sort_by}, {args.direction}) ===")
+        df = pd.DataFrame([_performer_to_dict(p) for p in top])
+        print(df.to_string(index=False))
+
+    if worst:
+        print(f"\n=== Worst {len(worst)} Performers (by {args.sort_by}, {args.direction}) ===")
+        df = pd.DataFrame([_performer_to_dict(p) for p in worst])
+        print(df.to_string(index=False))
+
+
+def _performer_to_dict(p) -> dict:
+    """Convert PerformerInfo to a flat dict for display."""
+    return {
+        "ticker": p.symbol,
+        "close": p.close,
+        "volume": p.volume,
+        "value": f"{p.value:,.0f}",
+        "close_changed": f"{p.close_changed:+.2f}" if p.close_changed is not None else "",
+        "volume_changed": f"{p.volume_changed:+.2f}" if p.volume_changed is not None else "",
+        "ma10_score": f"{p.ma10_score:.1f}" if p.ma10_score is not None else "",
+        "ma50_score": f"{p.ma50_score:.1f}" if p.ma50_score is not None else "",
+        "ma200_score": f"{p.ma200_score:.1f}" if p.ma200_score is not None else "",
+        "sector": p.sector or "",
+    }
+
+
+def cmd_volume_profile(args) -> None:
+    """CLI handler: aipa volume-profile."""
+    from datetime import date
+
+    from aipriceaction import AIPriceAction
+    from aipriceaction.volume_profile import compute_volume_profile
+
+    client = AIPriceAction()
+    ticker = args.ticker.upper()
+
+    # Resolve date range
+    if args.date:
+        start_date = end_date = args.date
+    elif args.start_date:
+        start_date = args.start_date
+        end_date = args.end_date or args.start_date
+    else:
+        today = date.today().isoformat()
+        start_date = end_date = today
+
+    # Resolve source for tick size
+    source = _resolve_source(args.source) or "vn"
+    # Auto-detect from ticker metadata if not specified
+    if args.source is None:
+        try:
+            tickers_meta = client.get_tickers()
+            for t in tickers_meta:
+                if t.ticker == ticker:
+                    source = t.source or "vn"
+                    break
+        except Exception:
+            pass
+
+    # Fetch 1m data
+    df = client.get_ohlcv(
+        ticker,
+        interval="1m",
+        start_date=start_date,
+        end_date=end_date,
+        ma=False,
+    )
+
+    if df is None or df.empty:
+        print(f"No 1m data found for {ticker} on {start_date}.", file=sys.stderr)
+        sys.exit(1)
+
+    result = compute_volume_profile(
+        df, ticker,
+        source=source,
+        bins=args.bins,
+        value_area_pct=args.value_area_pct,
+    )
+
+    print(f"\n=== Volume Profile: {result.symbol} ({start_date}) ===")
+    print(f"Total Volume: {result.total_volume:,}  |  Minutes: {result.total_minutes}")
+    print(f"Price Range: {result.price_range.low:.2f} - {result.price_range.high:.2f}  "
+          f"(spread: {result.price_range.spread:.2f})")
+    print(f"\nPOC: {result.poc.price:.2f}  volume={result.poc.volume:,.0f}  "
+          f"({result.poc.percentage:.1f}%)")
+    print(f"Value Area: {result.value_area.low:.2f} - {result.value_area.high:.2f}  "
+          f"volume={result.value_area.volume:,.0f}  ({result.value_area.percentage:.1f}%)")
+
+    if result.statistics:
+        s = result.statistics
+        print("\nStatistics:")
+        print(f"  Mean: {s.mean_price:.2f}  Median: {s.median_price:.2f}  "
+              f"StdDev: {s.std_deviation:.2f}  Skewness: {s.skewness:.4f}")
+
+    if result.profile:
+        print(f"\n{'Price':>12}  {'Volume':>12}  {'%':>6}  {'Cum%':>6}  Bar")
+        print("-" * 60)
+        max_vol = max(p.volume for p in result.profile) if result.profile else 1.0
+        for level in result.profile:
+            bar_len = int(level.volume / max_vol * 30) if max_vol > 0 else 0
+            bar = "\u2588" * bar_len
+            print(f"{level.price:>12.2f}  {level.volume:>12,.0f}  {level.percentage:>5.1f}%  "
+                  f"{level.cumulative_percentage:>5.1f}%  {bar}")