uvx aipa-cli

aipa

uvx

1. Use plain

   uvx

   for fast cached execution:

   uvx aipa-cli analyze VCB

2. Fallback on failure — if a command fails with a schema or missing argument error, retry with

   @latest

   :

   uvx aipa-cli@latest analyze VCB

aipa

pip

pip install --upgrade aipa-cli

uvx aipa-cli

aipa

uvx

• Vietnamese stocks (

  source: vn

  ): VIC, VCB, FPT, HPG, VNM, MBB, TCB, CTG, VPB, HDB, etc.
• Cryptocurrencies (

  source: crypto

  ): BTCUSDT, ETHUSDT, BNBUSDT, SOLUSDT, etc.
• Global/Yahoo (

  source: global/yahoo

  ): AAPL, TSLA, NVDA, SPY, etc.
• SJC Gold (

  source: sjc

  ): SJC gold prices

• Daily chart: Trend, Wyckoff phase, key levels
• Volume profile: Structural S/R with volume confirmation
• Intraday (if run): Entry/exit timing, short-term patterns

• stdout: The final analysis result (the AI's response). This is what you should present to the user.
• stderr: Status messages with structured markers for tracking progress.

• English: "Data by AIPriceAction | AI-powered analysis — may contain errors. Verify before trading."
• Vietnamese: "Dữ liệu bởi AIPriceAction | Phân tích bởi AI — có thể chứa sai sót. Vui lòng kiểm chứng trước khi giao dịch."

OPENAI_API_KEY

aipa analyze

[info]

1. Read the OHLCV data, MA scores, and market context from the stdout output
2. Apply the same analytical framework the CLI would have used (Wyckoff, VPA, MA momentum, etc.)
3. Produce the analysis result as if the LLM agent had generated it
4. Present the result to the user in the same format the CLI normally would

aipa analyze --context-only

aipa fundamentals

• The user explicitly says "fundamentals", "fundamental analysis", "cơ bản", "phân tích cơ bản", "PE", "ROE", "NPL", "CAR", etc.
• The user asks about valuation, profitability, or financial health
• The user asks to compare stocks by financial metrics (not price action)

Version gate:

aipa fundamentals

requires aipa-cli >= 0.1.43. Verify before use:

bash

aipa --version

If < 0.1.43, upgrade:

uvx aipa-cli@latest

or

pip install --upgrade aipa-cli

.

NOTE:

--lang

and

--no-system-prompt

are NOT valid for

aipa fundamentals

commands. Do NOT add them.

undefined

1. Valuation context: Is the stock expensive (high PE/PB) or cheap? A breakout at PE=8 is different from PE=30.
2. Bank health (VN banks): NPL, CAR, CASA, CIR provide critical risk context. High NPL + bearish technicals = strong sell signal.
3. Profitability confirmation: High ROE/ROA supports bullish thesis. Declining margins = fundamental weakness beneath technical strength.
4. Screening for candidates: Use

   rank

   and

   screen

   to find fundamentally strong stocks, then apply technical analysis to time entries.

1. Volume Price Action (VPA) Analysis: Always analyze the relationship between price and volume to identify smart money behavior, accumulation/distribution patterns, and confirm trend strength
2. Price-Volume Confirmation: Look for volume confirmation on price movements — increasing volume on breakouts (bullish) vs decreasing volume on rallies (bearish divergence)
3. Wyckoff Phases: Identify market phases (Accumulation, Markup, Distribution, Markdown) based on price-volume patterns. Key events: Spring, Upthrust, SOS (Sign of Strength), SOW (Sign of Weakness), Buying Climax, Test for Supply
4. Support/Resistance with Volume: Key levels are more significant when accompanied by high volume — look for volume spikes at support/resistance
5. Volume Trends: Compare current volume to recent average volume to gauge conviction behind price moves
6. Extreme Price Changes: Detect moves exceeding ±6.7%/day (VN market limit) and search recent news/events to find causes
7. Risk Management: Every analysis must include both positive (opportunities, strengths, bullish signals) and negative (risks, weaknesses, bearish signals) insights. Quantify downside risk with specific price levels, identify what would invalidate the current thesis, and never present a one-sided view
8. Fundamental Context (when requested): When the user asks for fundamentals, enrich the technical analysis with PE, PB, ROE, NPL, CAR, and other financial metrics. Fundamentals do NOT replace technical analysis — they add context.
9. Nhóm Chủ Lực (Core Market Sectors - VN Market Only): When analyzing the Vietnamese market, always contextualize tickers within their respective "Nhóm Chủ Lực" (Core Sectors) to assess systemic flow. The key groups are:
   • Nhóm Ngân hàng (Banking): VCB, BID, CTG, TCB, MBB, ACB, VPB, HDB, SHB, TPB, VIB, SSB, MSB, STB, LPB, EIB.
   • Nhóm Bất động sản (Real Estate): VIC, VHM, VRE, VPL, DIG, CEO, L14, TCH, HHS, VGC, IDC.
   • Nhóm Chứng khoán (Securities): SSI, VND, HCM, VCI, SHS, VIX, VDS.
   • Nhóm Trụ cột / Sản xuất & Bán lẻ (Blue-chips / Core Economy): HPG, HSG, NKG, FPT, MWG, GAS, GVR, PLX, BSR, MSN, VNM, SAB.
   • Nhóm Hệ sinh thái (Corporate Ecosystems):
     • Họ Vingroup: VIC, VHM, VRE, VPL.
     • Họ Bầu Thụy: STB, LPB, THD, HAG.
     • Họ Gelex ("Tuấn Mượt"): GEX, GEE, VIX, VGC, EIB, IDC.
     • Họ Hoàng Huy: TCH, HHS.
     • Họ A7: DIG, CEO, L14.
     • Họ TTC (Thành Thành Công): SBT, GEG, VDS.
     • Họ Masan: MSN, MCH, MSR, MML, VCF, VSN, NET. (Note: This classification applies only to the Vietnamese market. Crypto and Global markets do not use this specific grouping yet).

1. NEVER generate, guess, estimate, or hallucinate any numbers — prices, volumes, MA values, MA scores, percentages, dates, or any financial data. Only use data from tool results or user-provided context
2. NEVER mention a specific number unless it appears in your tool results or user-provided context
3. Use tools proactively — call

   aipa analyze

   ,

   aipa get-ohlcv-data

   , and/or

   aipa performers

   BEFORE answering price-related questions
4. When researching news or events, ALWAYS include the source name (e.g., "Source: CafeF", "Source: VNExpress")
5. Trading Hours: VN market trades 09:00–15:00 ICT (UTC+7), Mon–Fri. Crypto 24/7. If the latest bar shows unusually low volume, the session may still be in progress

This rule applies ONLY to Vietnamese stocks (

--source vn

). Crypto and global stocks are not subject to T+2 settlement.

IMPORTANT: For all stock purchases in the Vietnamese stock market, shares are only settled and available for trading (selling) on the afternoon of T+2 (specifically at 13:00 / 1:00 PM on day T+2, not T+3).

• NEVER propose or attempt to execute any Stop Loss or Take Profit actions on T+1 (the first business day after the purchase), as the shares have not yet settled.
• Always check the purchase date of any stock positions when recommending sell actions.

1. DANH_MUC.md

2. PORTFOLIO.md

3. ACCOUNT.md

1. THEO_DOI.md

2. WATCHLIST.md

1. Always check settlement status before recommending sell actions (VN stocks only) — cross-reference buy date with today. For VN stocks, shares are NOT sellable until afternoon of T+2. Does NOT apply to crypto or global stocks
2. Every analysis must quantify risk — include specific Stop Loss and Take Profit levels with reasoning, state what invalidates the thesis, calculate risk-reward ratio
3. Never present one-sided analysis — every ticker must have both bullish signals and bearish risks
4. Position sizing awareness — flag concentration risk when >30% of portfolio is in one sector
5. Daily portfolio review — mark settled positions, check SL/TP hits, flag thesis changes

• Row-by-Row Verification: When reading OHLCV data output from the CLI, you MUST strictly read the exact row for the exact date requested. Do not accidentally read data from an adjacent row or a different ticker's block in multi-ticker outputs.
• Precision Filter with Grep: To minimize reading errors and context volume, always use

  grep -E

  to isolate your target dates across one or multiple tickers. Use

  "time"

  as your header anchor.
  • Surgical view (Header + Today + Breakout Day):

    uvx aipa-cli get-ohlcv-data TCB MSB STB | grep -E "time|2026-05-27|2026-05-07"

  • Comparing recent days:

    uvx aipa-cli get-ohlcv-data VND | grep -E "time|2026-05-27|2026-05-26"

• Explicit Value Comparison: Before concluding whether a trend is broken or intact, explicitly state the values being compared:

  [Close Price]

  vs

  [MA/EMA Value]

  .
  • Example: "Close is 17.750, EMA20 is 16.881. 17.750 > 16.881 → Price is ABOVE EMA20 (Trend intact)."
• Breakout Validation: A breakout (significant positive price change + high volume) creates a critical support at the structural breakout level — the top of the pre-breakout base/range, the prior swing high, or the pattern's neckline. The breakout candle's Low is NOT a reliable invalidation point: it can extend well below the structural level due to gap opens, intraday noise, or volatile entry bars.
  • The correct invalidation is a fall back below the structural breakout level, not below the candle's Low.
  • If price pulls back but stays above the structural level, the breakout is intact — this is a healthy pullback.
  • If price falls below the structural breakout level, it is a Failed Breakout / Structural Violation.
  • Action: Always identify the pre-breakout structure first. Only then assess whether a pullback is healthy (above structure) or a failure (below structure).

1. Auto-uppercase: Ticker symbols are automatically converted to uppercase. You can pass

   vcb

   ,

   btcusdt

   , etc. — they will be treated as

   VCB

   ,

   BTCUSDT

   .
2. Use

   --context-only

   for data inspection: If you only need to see what data is available without spending API credits, use

   aipa analyze VCB --context-only

   .
3. Default is good enough: The default template (index 0, Trading Opportunity) is comprehensive. Only specify

   --question

   when the user has a specific analytical framework in mind.
4. Multi-ticker for comparisons: When the user asks to "compare" or "which is better", pass multiple tickers:

   aipa analyze VCB TCB MBB

   .
5. Use

   --lang vn

   for Vietnamese users: If the user writes in Vietnamese or asks for Vietnamese output, add

   --lang vn

   .
6. Use

   --verbose

   for transparency: When the user wants to see the reasoning process, add

   --verbose

   .

7. aipa-data

   for raw numbers: If the user asks for "price data", "candle data", or "OHLCV" without wanting AI analysis, use the

   aipa-data

   skill instead.
8. Interval matters: For intraday analysis, use

   1h

   or

   4h

   . For swing trading, use

   1D

   . For scalping, use

   15m

   or

   5m

   .
9. Combine with

   --limit

   : More bars = more context. Use

   --limit 50

   or

   --limit 100

   for deeper analysis. Default is 20.
10. Reference ticker: Auto-detected based on the ticker's source —

    VNINDEX

    for VN stocks,

    BTCUSDT

    for crypto,

    ^GSPC

    for global stocks. Use

    --reference-ticker

    to override.
11. Use

    aipa performers

    to find tickers to analyze — run multiple perspectives: When the user asks "what should I analyze?" or "what's moving today?", run

    aipa performers

    with multiple

    --sort-by

    values to get a multi-perspective view. Always run at least these two: default (price change) and value (trading value). Add MA scores when the user cares about trends. Cross-referencing the lists reveals more significant tickers. Then analyze the interesting ones with

    aipa analyze

    .
    bash

    aipa performers                                          # price change — top gainers / worst losers
    aipa performers --sort-by value                          # trading value — where the money flows
    aipa performers --sort-by ma50_score                     # MA50 trend — strongest/weakest medium-term trends
    aipa performers --sort-by ma20_score                     # MA20 trend — strongest/weakest short-term trends
    aipa performers --sort-by total_money_changed            # money flow change — unusual capital activity
    aipa performers --source crypto --sort-by value          # crypto by trading value
    aipa performers --group NGAN_HANG --sort-by value        # banking sector by trading value
    aipa performers --group CHUNG_KHOAN --sort-by close_changed  # securities sector top gainers

12. Use

    aipa volume-profile

    for support/resistance context: When analyzing a ticker and the user asks about key price levels, support, resistance, or "where is the volume?", run

    aipa volume-profile TICKER

    to get POC (Point of Control), value area, and volume-weighted statistics. Prefer multi-day ranges over single-day profiles — they produce more reliable support/resistance levels and smooth out intraday noise. Use

    --start-date

    and

    --end-date

    covering at least 20 trading days as the default approach. Only use a single

    --date

    when the user explicitly asks for one specific day. Examples:

    • aipa volume-profile VCB --start-date 2026-04-14 --end-date 2026-05-09

      — 1-month range (preferred default)

    • aipa volume-profile VCB --start-date 2026-04-28 --end-date 2026-05-09 --bins 30

      — 2-week range

    • aipa volume-profile VCB --date 2026-05-08

      — single date (only when specifically requested)

    • aipa volume-profile BTCUSDT --source crypto --bins 30 --start-date 2026-05-05 --end-date 2026-05-09

      — crypto multi-day

    • aipa volume-profile FPT --start-date 2026-05-01 --end-date 2026-05-09 --bins 30 --value-area-pct 80

      — full options