aipa-analyze

aipa-analyze

AIPriceAction が開発しました。詳しいデータとドキュメントは https://aipriceaction.com をご覧ください。

トレーダーへの励ましの言葉

考え方と手法

• 「利益をもたらすのはトレンドだけです。市場に逆らって議論しようとしてはいけません。」
• 「トレードとは未来を予測することではなく、リスクを管理し、規律を守ることです。」
• 「Volumeは賢明な資金の足跡です。価格は人を惑わせることがありますが、出来高はそうではありません。」
• 「適切なセットアップを辛抱強く待つことが、成功への黄金の鍵です。」
• 「市場は常に正しいものです。責任を負うのは私たちの資金だけです。」
• 「持続的な利益は、天井や底を当てることではなく、忍耐と一貫性から生まれます。」
• 「大きく下げても、下落が終わったとは限りません。さらなる確認が必要です。」

規律とリスク管理

• 「リスク管理の規律を守れば、破綻することはありませんよ！」
• 「計画のないトレードは、失敗を計画しているのと同じです。」
• 「損切りは常に正しく、含み損を抱え続けるのは常に間違いです。」
• 「利益を考える前に、まず生き残りましょう。」
• 「資金を守ることは、お金を稼ぐことより重要です。」
• 「株を愛してはいけません。その株がもたらす利益と安全性だけを大切にしましょう。」
• 「Springには2～3セッションの確認とNo Supplyのプルバックが必要です。1回の急騰だけでは何も判断できません。」
• 「30％下落していても、落ちてくるナイフをつかんではいけません。Volume ProfileとWyckoffによる確認を待ちましょう。」

心理と実践

• 「涙を流すより、よだれを垂らすほうがましです。」
• 「確かな底が見えるまでは、落ちてくるナイフをつかもうとしてはいけません。」
• 「上昇トレンドでは誰もが投資の天才です。潮が引いて初めて、誰が裸で泳いでいたかが分かります。」
• 「価格が急騰した後にFOMOで追いかけ買いするのは、安全ベルトを締め忘れてジェットコースターに乗るようなものです。」
• 「天井を当てようとせず、底を探ろうとしてはいけません。」
• 「強気派は稼ぎ、弱気派も稼ぎ、欲張りは身ぐるみを剥がされます。」
• 「トレンドは友です。友と一緒に進みましょう。」
• 「噂で買い、事実で売る。」
• 「最大の過ちは、株が大きく下がったのを見て、また上がると思い込むことです。市場はあなたに理由を説明する義務はありません。」
• 「SpringとUpthrustを見分けるには、『この銘柄は供給を一掃できるほど下落したか？』と問いましょう。十分に下落していないなら、供給が残っており、リスクがあります。十分に下落しているなら、売り手はもうおらず、チャンスです。」

忍耐とポジション管理（早すぎる利確を避け、ポジションを追加する）

• 「利益は伸ばしましょう。」
• 「早すぎる利確は、利益を取り逃します。」
• 「うまくいっているなら追加し、間違っているなら損切りしましょう。」
• 「大きな利益は、じっと待つことから生まれます。」
• 「うまくいっているなら保有し、間違っているなら損切りしましょう。」

aipaとは

aipaは、ベトナム株、暗号資産、世界の資産を対象とする、AI搭載の金融分析CLIです。OHLCV価格データとLLMによる分析を組み合わせ、Wyckoff、VPA（出来高・価格分析）、MAモメンタムスコアリングなどのフレームワークを使って、実用的なトレードの洞察を提供します。

インストール

uvxを使えば、インストールは不要です。各セッションで最初に呼び出す際は、キャッシュを更新するためにuvx aipa-cli@latestを使用してください。それ以降の呼び出しでは、通常のuvx aipa-cliを使用します（高速で、キャッシュが利用されます）。

# All calls — fast cached execution (uvx automatically checks for updates)
uvx aipa-cli analyze VCB

uvx aipa-cli analyze TCB

# Fallback: pip (if uv is not available)
pip install aipa-cli
aipa analyze VCB

# Fallback: system pip (if pip fails due to PEP 668)
python3 -m pip install aipa-cli --break-system-packages
aipa analyze VCB

# If neither uv nor pip are installed, install uv first:
curl -LsSf https://astral.sh/uv/install.sh | sh
# If the install script fails, see: https://docs.astral.sh/uv/getting-started/installation/

このスキル内のすべてのコマンド例では、簡潔にするためaipaを使用しています。グローバルにインストールされていない場合は、aipaをuvx aipa-cliに置き換えてください。

CLIを最新の状態に保つ

aipa CLIは活発に開発されており、頻繁に改善されています。常にaipaよりuvx aipa-cliを優先してください。uvxを使用する場合：

1. キャッシュを使って高速に実行するには、通常のuvxを使用します。 uvx aipa-cli analyze VCB
2. 失敗した場合のフォールバック — スキーマエラーまたは引数不足のエラーでコマンドが失敗した場合は、@latestを付けて再試行します： uvx aipa-cli analyze VCB（コマンドが失敗した場合は@latestを追加）

aipaをpipでグローバルにインストールしている場合は、各セッションの前に更新してください：

pip install --upgrade aipa-cli

エージェントはすべてのコマンドでuvx aipa-cliを優先してください。uvxが利用できない場合に限り、aipaにフォールバックしてください。

環境変数

変数	必須	デフォルト	用途
OPENAI_API_KEY	はい（AI 用）	—	LLM プロバイダーの API キー
OPENAI_BASE_URL	いいえ	OpenRouter	OpenAI 互換 API のベース URL
OPENAI_MODEL	いいえ	openrouter/owl-alpha	分析に使用するモデル

初回の設定を対話形式で行うには、aipa setup を実行します。設定は ~/.aipriceaction/settings.json に保存されます。

aipa-config — 設定管理

aipa config get                    # show all settings (JSON, api_key redacted)
aipa config get use_sma            # show single value: true or false
aipa config get language           # show language: en or vn
aipa config set use_sma false      # switch all commands to EMA
aipa config set use_sma true       # switch to SMA
aipa config set language vn        # change language
aipa config path                   # show path to settings file

設定	デフォルト	値	説明
use_sma	true	true / false	true = SMA、false = EMA。すべてのコマンドで使用する MA の種類を制御します。CLI フラグ（--sma、--ema）は実行ごとに設定を上書きします。
language	vn	en / vn	analyze および deep-research の出力言語

MA の種類の優先順位： CLI フラグ（--sma/--ema） > settings.json（use_sma） > デフォルト（sma）。

IMPORTANT: 分析セッションを始める前に、aipa config get use_sma を実行して現在の MA の種類の設定を確認してください。SMA だと決めつけないでください。ユーザーが EMA に切り替えている場合があります。分析内の MA に関する記述はすべて、現在有効な設定（SMA または EMA）に合わせてください。

利用可能なデータソース

• ベトナム株（source: vn）：VIC、VCB、FPT、HPG、VNM、MBB、TCB、CTG、VPB、HDB など
• 暗号資産（source: crypto）：BTCUSDT、ETHUSDT、BNBUSDT、SOLUSDT など
• グローバル／Yahoo（source: global/yahoo）：AAPL、TSLA、NVDA、SPY など
• SJC 金（source: sjc）：SJC 金価格

事前定義済みウォッチリスト

CLI には、一般的なティッカーグループ用のウォッチリストが組み込まれています。グループのティッカーを取得するには aipa watchlist get <NAME> を使用します。または、「VN30 stocks」や「Vingroup ecosystem」のようなグループについてユーザーから質問された場合は、ウォッチリストを直接参照してください。

名前	ティッカー	件数
VN30	ACB, BID, BSR, CTG, FPT, GAS, GVR, HDB, HPG, LPB, MBB, MSN, MWG, PLX, SAB, SHB, SSB, SSI, STB, TCB, TPB, VCB, VHM, VIB, VIC, VJC, VNM, VPB, VRE, VPL	30
VINGROUP	VIC, VHM, VRE, VPL	4
TM	GEX, GEE, VIX, EIB, VGC, IDC	6
MASAN	MSN, MCH, MSR, MML, VCF, VSN, NET	7
INDEX	VNINDEX, VN30, VN30F1M, VN100, VNMIDCAP, VNSMALLCAP, VNALLSHARE, VNXALLSHARE, VNFIN, HNX30, VNREAL, VNENE, VNMITECH, VNUTI, VNCONS, VNCOND, VNHEAL, VNIND, VNFINLEAD, VNFINSELECT, VNDIAMOND, VNDIVIDEND	22
CROSS	VNINDEX, ^GSPC, GC=F, SJC-GOLD, KC=F, BZ=F, BTCUSDT	7

注：VN30 は 2026-05-13 に更新されました。DGC は管理対象銘柄に指定されたため除外され、代わりに BSR が追加されました。

# List all watchlists (predefined + custom)
aipa watchlist ls

# Get tickers for a specific watchlist
aipa watchlist get VN30
aipa watchlist get VINGROUP

# Create a custom watchlist
aipa watchlist set MYWATCHLIST FPT VCB HPG VIC

# Delete a custom watchlist
aipa watchlist rm MYWATCHLIST

# Using watchlist tickers in analyze
aipa analyze $(aipa watchlist get VN30)

対応インターバル

インターバル	説明
1m	1 分
5m	5 分
15m	15 分
30m	30 分
1h	1 時間
4h	4 時間
1D	1 日（デフォルト）
1W	1 週間

注：すべてのインターバル（1m、5m、15m、30m、1h、4h、1D、1W、2W）はネイティブに対応しています。ネイティブでないインターバルは、基本データからクライアント側で集計されます。

---

aipa analyze — AI 分析

1 つ以上のティッカーに対して、AI を活用したテクニカル分析を実行します。

aipa analyze TICKER [TICKERS...] [options]

フラグ

フラグ	デフォルト	説明
TICKER [TICKERS...]	—	1つ以上のティッカーシンボル（自動的に大文字に変換）
--interval	1D	時間間隔：1m、5m、15m、30m、1h、4h、1D、1W、2W
--limit N	20	取得するバー／ローソク足の数
--source	自動検出	ソースで絞り込み：vn、crypto、global
--start-date	—	開始日（例：2025-04-01）
--end-date	—	終了日（例：2025-04-30）
--reference-ticker	自動検出	参照ティッカー：VNINDEX（VN 株）、BTCUSDT（暗号資産）、^GSPC（グローバル）
--lang	保存済みの設定	言語：en または vn
--ma-type	設定	移動平均の種類：ema または sma（use_sma 設定に基づきます）
--question TEXT	テンプレート 0	カスタム分析質問（テンプレートを上書きします）
--questions	—	利用可能な質問テンプレートを一覧表示して終了します
--context-only	—	LLM を呼び出さずに生のコンテキストを出力します（API キーは不要です）
--no-system-prompt	—	コンテキスト出力からシステムプロンプトを除外します
--verbose	—	分析中に思考トークンを表示します

使用例

# Basic single-ticker analysis
aipa analyze VCB

# Multi-ticker comparison
aipa analyze VCB TCB MBB CTG VPB

# Specific interval and bar count
aipa analyze BTCUSDT --interval 4h --limit 50

# Custom date range
aipa analyze FPT --start-date 2025-01-01 --end-date 2025-05-01

# Custom analysis question
aipa analyze VIC --question "What is the Wyckoff phase and what are the key price targets?"

# Vietnamese language output
aipa analyze VNM --lang vn

# Dump raw data context without AI analysis (no API key needed)
aipa analyze VCB --context-only

# Show thinking tokens during analysis
aipa analyze HPG --verbose

# Override auto-detected reference ticker
aipa analyze VCB --reference-ticker VN30

# Specific source
aipa analyze BTCUSDT --source crypto

---

分析ワークフロー

分析リクエストごとに、以下の複数ステップからなるワークフローに従ってください。aipa analyze を実行して終わりにしないでください。

ステップ 1：日足の分析

まず日足チャートで aipa analyze を実行します。十分なコンテキストを得るため、最低でも --limit 50 を指定してください。ワイコフ相の特定や TP の設定には、--limit 60 以上を指定してください。

aipa analyze VCB --limit 50

ステップ 2：サポート／レジスタンスのボリュームプロファイル

aipa volume-profile を実行して、構造的な価格水準（POC、バリューエリア、高出来高ノード）を取得します。少なくとも 20 取引日を含む複数日の範囲を指定してください。

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

注： 上記の日付は例です。必ず今日までの少なくとも 30 取引日（暦上で約 6 週間）を含む範囲を指定してください。--start-date は動的に計算してください。

ボリュームプロファイルの水準を日足分析と照合します。出来高クラスターの大きい主要な S/R 水準は、より重要です。

ステップ 3：日中足の詳細分析（必要な場合）

日足分析に基づいて、日中足の確認が有益かどうかを判断してください。

トリガー	アクション
日足でブレイクアウト／反転が今まさに形成されている	--interval 1h --limit 50 を実行してエントリーのタイミングを確認します
日足で重要な水準付近の狭い持ち合いが見られる	--interval 4h --limit 50 を実行してパターンを確認します
ユーザーがエントリー／決済のタイミングやスキャルピングについて尋ねている	--interval 15m --limit 50 を実行して短期的な値動きを確認します
日足チャートが明確で、タイミングに曖昧さがない	日中足の分析は省略します。日足分析で十分です

# 1h for entry/exit timing
aipa analyze VCB --interval 1h --limit 50

# 15m for scalping or micro structure
aipa analyze VCB --interval 15m --limit 50

ステップ 4：分析結果をまとめて提示

すべてのステップの内容を統合し、1つの回答にまとめます。

• 日足チャート：トレンド、ワイコフ相、主要な水準
• ボリュームプロファイル：出来高で確認された構造的な S/R
• 日中足（実行した場合）：エントリー／決済のタイミング、短期的なパターン

各ステップを個別のセクションとして提示しないでください。見解を統合し、一貫性のある分析にまとめてください。

---

このスキルと他のスキルの使い分け

ユーザーのリクエスト	使用するもの
「VCB を分析して」	aipa analyze VCB
「FPT と VNM を比較して」	aipa analyze FPT VNM
「HPG のワイコフ分析」	aipa analyze HPG --question "Wyckoff analysis with phases, events, and price targets"
「銀行セクターを詳しく調査して」	代わりに aipa-research スキルを使用します
「VCB の価格データを取得して」	代わりに aipa-data スキルを使用します
「BTC の OHLCV ローソク足を表示して」	代わりに aipa-data スキルを使用します
「今日の上位銘柄を教えて」	aipa live-data（AI なし、すばやく市場の概況を確認）
「値上がり／値下がり上位銘柄」	aipa performers（AI なし）
「売買代金の大きい上位銘柄」	aipa performers --sort-by value（AI なし）
「ボリュームプロファイル／POC／バリューエリア」	aipa volume-profile TICKER（AI なし）
「利用可能な銀行株は？」	aipa ticker-list --source vn --group NGAN_HANG

基本ルール：AI による洞察 → aipa-analyze、生の数値 → aipa-data、包括的なレポート → aipa-research、すばやい市場の概況 → aipa live-data。

---

質問テンプレート

CLI には、フレームワークごとに整理された分析用質問テンプレートがあらかじめ用意されています。利用可能なテンプレートをすべて表示するには、--questions を使用します。

単一ティッカー用テンプレート（英語）

インデックス	テンプレート	説明
0	Trading Opportunity	Wyckoff のフェーズ、スマートマネーの動向、投資実行ロードマップ、リスク管理
1	News & Events Research	急激な値動き（>6.7% または Volume >150%）を検出し、原因をウェブ検索
2	Price Action & Volume	VPA 分析、スマートマネーの痕跡、需給ゾーン
3	MA Momentum & Trend	MA の整列、クロスオーバーの検出、出来高による確認
4	Wyckoff Method	Wyckoff のフェーズ、Spring/Upthrust/SOS イベント、価格目標
5	Bob Volman Price Action	マイクロプルバックのエントリー、ブレイクアウト／フェードのセットアップ、取引計画

複数ティッカー用テンプレート（英語）

インデックス	テンプレート	説明
0	Trading Opportunity	すべてのティッカーを分析し、投資機会の質で順位付け
1	Stock Performance Comparison	値動きの強さ、MA モメンタム、出来高を比較
2	Market Trend Analysis	MA スコアによるセクターローテーション、蓄積／分配
3	Risk & Support/Resistance	出来高の状況を踏まえてサポート／レジスタンスの水準をマッピング
4	News & Events Research	複数のティッカーにわたる急激な値動きを検出
5	Bob Volman Price Action	複数のティッカーに適用し、順位付け
6	Wyckoff Method	複数ティッカーの Wyckoff 分析と順位付け

すべてのテンプレートにはベトナム語訳も用意されています（--lang vn を使用）。

テンプレートの使用

# List all templates
aipa analyze --questions

# Use a specific template by index (TUI only: /analyze VCB 2)
# In CLI, use --question for custom questions
aipa analyze HPG --question "Phân tích theo phương pháp Wyckoff: xác định pha, sự kiện quan trọng (Spring/Upthrust/SOS), mục tiêu giá và xác nhận khối lượng"

---

出力の解釈

CLI は 2 つのストリームに出力します。

• stdout：最終的な分析結果（AI の応答）です。ユーザーに提示するのはこちらです。
• stderr：進行状況を追跡するための構造化マーカー付きステータスメッセージです。

ステータスマーカー（stderr）

マーカー	意味
[build]	コンテキスト構築のステータスと所要時間
[analyze]	LLM に送信される分析用の質問
[tool]	実行中のツール呼び出し（例：OHLCV データの取得）
[tool-result]	返されたツール実行結果
[thinking]	エージェントの推論トークン（--verbose の場合のみ）
[error]	エラーメッセージ
[done]	分析完了。合計所要時間を含みます
[result]	この後に最終的な分析結果が続きます

結果をユーザーに提示する際は、必ず stdout の出力を使用してください（stderr の [result] マーカー以降）。

出典表記

分析をユーザーに提示する際は、必ず応答の末尾に出典表記を含めてください。

• 英語："Data by AIPriceAction | AI-powered analysis — may contain errors. Verify before trading."
• ベトナム語："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."

「analysis provided by AIPriceAction」や「phân tích được cung cấp bởi AIPriceAction」とは言わないでください。AIPriceAction が提供するのはデータであり、分析は AI が生成したもので、不正確な場合があります。

---

API キーがない場合 — エージェントによるフォールバック

OPENAI_API_KEY が設定されていない場合、aipa analyze はエラーではなく [info] メッセージを表示し、未加工のコンテキストを stdout に出力して終了します。このコンテキストには、分析に必要なすべての OHLCV データ、MA スコア、市場メタデータが含まれています。

AI エージェントで、このフォールバック出力が表示された場合は、出力されたコンテキストを使って自分で分析を行ってください。

1. stdout の出力から OHLCV データ、MA スコア、市場コンテキストを読み取ります
2. CLI が使用するはずだった分析フレームワーク（Wyckoff、VPA、MA モメンタムなど）を適用します
3. LLM エージェントが生成したかのように、分析結果を作成します
4. CLI が通常行うのと同じ形式で、結果をユーザーに提示します

コンテキスト出力は aipa analyze --context-only と同一です。入力データとして扱い、自分で推論してください。

---

基本事項：実行前に確認

ユーザーが基本データまたはファンダメンタル分析（phân tích cơ bản）を明示的に求めない限り、aipa fundamentals コマンドを自動的に実行しないでください。 テクニカル分析（VPA、Wyckoff、MA）がデフォルトです。ファンダメンタルデータを取得するのは、次の場合に限ります。

• ユーザーが「fundamentals」、「fundamental analysis」、「cơ bản」、「phân tích cơ bản」、「PE」、「ROE」、「NPL」、「CAR」などを明示的に指定した場合
• ユーザーがバリュエーション、収益性、または財務健全性について質問した場合
• ユーザーが財務指標（値動きではなく）に基づく株式の比較を求めた場合
• ユーザーが「report」または「báo cáo」と言った場合 — これらは財務報告を指す可能性があります。不明確な場合は確認してください。

バージョン要件： aipa fundamentals の実行には aipa-cli >= 0.1.48 が必要です。使用前に確認してください。

aipa --version

0.1.48 未満の場合は、uvx aipa-cli@latest または pip install --upgrade aipa-cli でアップグレードしてください。

ファンダメンタル分析が関連する場合は、次のコマンドを使用してテクニカル分析を補強してください。

# Quick company snapshot
aipa fundamentals info VCB

# Latest financial ratios
aipa fundamentals ratios VCB --latest

# Bank-specific metrics (NPL, CAR, CASA, CIR)
aipa fundamentals ratios VCB --category bank --latest

# Compare ROE across peers
aipa fundamentals rank VCB BID CTG TCB MBB --sort-by roe

# Rank by historical year
aipa fundamentals rank --year 2023 --sort-by roe

# Screen for value stocks
aipa fundamentals screen --pe-max 15 --roe-min 0.15 --sort-by roe

# Screen specific quarter
aipa fundamentals screen --period "2024 Q3" --sort-by roe

# Screen banking sector for asset quality
aipa fundamentals screen --industry "ngân hàng" --npl-max 0.015 --sort-by npl --direction asc

ファンダメンタル分析でテクニカル分析を補強する方法

ユーザーからファンダメンタル分析を求められた場合は、テクニカル分析とファンダメンタル分析の両方の視点を組み合わせます。

1. バリュエーションの観点：株価は割高（PE/PB が高い）ですか、それとも割安ですか？ PE=8 でのブレイクアウトと PE=30 でのブレイクアウトは異なります。
2. 銀行の健全性（ベトナムの銀行）：NPL、CAR、CASA、CIR は重要なリスクの判断材料となります。NPL が高く、テクニカル指標が弱気の場合は、強い売りシグナルです。
3. 収益性の確認：ROE/ROA が高いことは強気の見通しを裏付けます。利益率の低下は、テクニカル面の強さの裏にあるファンダメンタルの弱さを示します。
4. 候補銘柄のスクリーニング：rank と screen を使用してファンダメンタルが強い銘柄を見つけ、その後、テクニカル分析を適用してエントリーのタイミングを判断します。

ファンダメンタル比較のワークフロー

複数のティッカーのファンダメンタルを比較する場合（例：「VCB TCB MBB のファンダメンタルを比較」「最も健全な銀行はどれか」「NPL で銀行を順位付け」）、このワークフローに従ってください。各ティッカーに対して aipa fundamentals ratios TICKER --latest を個別に呼び出すだけではいけません — 比較しにくい出力が N 個生成されます。まず rank と screen を使用してください。

ステップ 1：横並びのランキング（必須）

aipa fundamentals rank に対象のティッカーを指定し、1 回の呼び出しで比較表を取得します。セクターに関連する観点を少なくとも 2 つ実行してください。

# Profitability comparison
aipa fundamentals rank VCB BID CTG TCB MBB --sort-by roe

# Valuation comparison
aipa fundamentals rank VCB BID CTG TCB MBB --sort-by pe --direction asc

# Bank health: asset quality + capital adequacy
aipa fundamentals rank VCB BID CTG TCB MBB --sort-by npl --direction asc
aipa fundamentals rank VCB BID CTG TCB MBB --sort-by car --direction desc

# General stocks: dividend + valuation
aipa fundamentals rank FPT VNM HPG MWG --sort-by dividend_yield --direction desc
aipa fundamentals rank FPT VNM HPG MWG --sort-by pe --direction asc

ステップ 2：品質でスクリーニング（任意ですが推奨）

対象のティッカーに対して aipa fundamentals screen を使用し、品質基準で絞り込みます。これにより、弱い候補をすぐに除外できます。

# Only banks with acceptable asset quality AND profitability
aipa fundamentals screen VCB BID CTG TCB MBB --npl-max 0.015 --roe-min 0.15 --sort-by roe

# Only stocks with reasonable valuation
aipa fundamentals screen VCB FPT HPG VNM --pe-max 20 --roe-min 0.10 --sort-by pe --direction asc

# Entire sector with quality filter
aipa fundamentals screen --industry "ngân hàng" --npl-max 0.02 --car-min 0.09 --sort-by roe

ステップ 3：個別の詳細調査（候補に絞ったティッカーのみ）

ステップ 1〜2 の後で、上位にランク付けされたティッカーや、さらに調査が必要なティッカーに限り、個別に ratios --latest を使用します。企業の概要を把握するには info を使用してください。

aipa fundamentals ratios VCB --latest                # full ratios for top candidate
aipa fundamentals ratios VCB --category bank --latest # bank-specific deep dive
aipa fundamentals info VCB                            # company profile context

これが重要な理由： rank と screen はすべてのティッカーを 1 つの比較表で返すため、N 個のティッカーに対して ratios を N 回呼び出し、出力を手動で比較するよりはるかに効率的です。ランキングによって相対的な位置をすぐに把握でき、スクリーニングによって詳細調査にトークンを費やす前に不適切な候補を除外できます。

---

分析フレームワーク

分析を行う際（CLI 経由、またはエージェントのフォールバックとして）は、次の優先事項に従ってください。

1. 出来高・価格アクション（VPA）分析：常に価格と出来高の関係を分析し、スマートマネーの動き、蓄積・分配パターンを特定して、トレンドの強さを確認してください
2. 価格と出来高の確認：価格変動に対する出来高の裏付けを確認してください。ブレイクアウト時の出来高増加（強気）と、上昇時の出来高減少（弱気のダイバージェンス）を見極めます
3. ワイコフのフェーズ：価格・出来高のパターンに基づき、市場のフェーズ（蓄積、上昇、分配、下落）を特定してください。主なイベント：スプリング、アップスラスト、SOS（強さの兆候）、SOW（弱さの兆候）、バイイング・クライマックス、供給のテスト
4. 出来高を伴うサポート／レジスタンス：出来高が多い場合、重要な価格水準の意義は高まります。サポート／レジスタンスでの出来高急増を確認してください
5. 出来高のトレンドと急増：現在の出来高を直近の平均出来高（例：20日平均）と比較してください。前日出来高との比較だけでは不十分です。前日比の大幅な上昇（volume_changed +92% など）は、前日の流動性が異常に低かった場合、誤ったシグナルです。「急増」「分配」「クライマックス」と判断する前に、必ず平均と比べた実際の出来高を確認してください
6. 極端な価格変動：1日あたり±6.7%を超える値動き（ベトナム市場の値幅制限）を検出し、原因を特定するために最近のニュースやイベントを調べてください
7. リスク管理：すべての分析に、プラス面（機会、強み、強気シグナル）とマイナス面（リスク、弱み、弱気シグナル）の両方の見解を含めてください。具体的な価格水準を用いて下落リスクを数値化し、現在の見立てを覆す条件を特定し、一方的な見解を示さないでください
8. ファンダメンタルズの文脈（依頼された場合）：ユーザーがファンダメンタルズを求めた場合、PE、PB、ROE、NPL、CAR、その他の財務指標を加えてテクニカル分析を補足してください。ファンダメンタルズはテクニカル分析の代わりではなく、判断材料を加えるものです。
9. 主力セクター（ベトナム市場のみ）：ベトナム市場を分析する際は、システム全体の資金フローを評価するため、各銘柄を該当する「主力セクター」の文脈に必ず位置付けてください。主なグループは次のとおりです。
   • 銀行グループ： VCB, BID, CTG, TCB, MBB, ACB, VPB, HDB, SHB, TPB, VIB, SSB, MSB, STB, LPB, EIB。
   • 不動産グループ： VIC, VHM, VRE, VPL, DIG, CEO, L14, TCH, HHS, VGC, IDC。
   • 証券グループ： SSI, VND, HCM, VCI, SHS, VIX, VDS。
   • 主力株／製造・小売グループ： HPG, HSG, NKG, FPT, MWG, GAS, GVR, PLX, BSR, MSN, VNM, SAB。
   • 企業エコシステムグループ：
     • ビングループ系：VIC, VHM, VRE, VPL。
     • バウ・トゥイ系：STB, LPB, THD, HAG。
     • Gelex系（「トゥアン・ムオット」）：GEX, GEE, VIX, VGC, EIB, IDC。
     • ホアン・フイ系：TCH, HHS。
     • A7系：DIG, CEO, L14。
     • TTC（タン・タン・コン）系：SBT, GEG, VDS。
     • マサン系：MSN, MCH, MSR, MML, VCF, VSN, NET。
     • ベトテル系：VGI, CTR, VTP。 (注：この分類はベトナム市場のみに適用されます。暗号資産市場とグローバル市場では、現時点でこの分類は使用されません。)

データ使用ポリシー（重要）

1. 数値（価格、出来高、MA 値、MA スコア、割合、日付、その他の金融データ）を決して生成、推測、推定、または捏造しないでください。ツールの結果、またはユーザーから提供されたコンテキストのデータのみを使用してください
2. ツールの結果またはユーザーから提供されたコンテキストにない具体的な数値を、決して言及しないでください
3. ツールを積極的に使用してください：価格に関する質問に答える前に、aipa analyze、aipa get-ohlcv-data、および／または aipa performers を呼び出してください
4. ニュースやイベントを調べる際は、必ず情報源の名称を記載してください（例：「情報源：CafeF」、「情報源：VNExpress」）
5. 取引時間：ベトナム市場は月曜から金曜の09:00～15:00（ICT、UTC+7）に取引されます。暗号資産市場は24時間365日取引されています。最新のローソク足で出来高が異常に少ない場合、取引時間中の可能性があります

T+2 決済ルール（VN 株のみ）

このルールはベトナム株（--source vn）にのみ適用されます。 暗号資産とグローバル株は T+2 決済の対象ではありません。

重要： ベトナム株式市場でのすべての株式購入では、株式の決済が完了し、取引（売却）が可能になるのは T+2 の午後（具体的には T+2 日の 13:00／午後 1 時であり、T+3 ではありません）です。

• T+1（購入後最初の営業日）に、損切りまたは利益確定のアクションを決して提案したり、実行を試みたりしないでください。株式の決済がまだ完了していないためです。
• 売却アクションを推奨する際は、必ず保有している株式の購入日を確認してください。

ポートフォリオファイル

エージェントは、ポジションを追跡するために作業ディレクトリ内のポートフォリオファイルを探します。使用できるファイル名は次のとおりです（上から順に確認します）。

1. DANH_MUC.md
2. PORTFOLIO.md
3. ACCOUNT.md

該当するファイルがない場合は、作成するかどうかをユーザーに確認してください。

ウォッチリストファイル

エージェントは、監視中のティッカー（まだポジションを保有していないもの）を追跡するためのウォッチリストファイルも探します。使用できるファイル名は次のとおりです（上から順に確認します）。

1. THEO_DOI.md
2. WATCHLIST.md

このファイルでは、エントリー候補を追跡します。ティッカー、セクター、監視理由、エントリーゾーン、重要な価格水準、追加日を記載してください。

リスク管理ルール（必須）

1. 売却アクションを推奨する前に、必ず決済状況を確認してください（VN 株のみ） — 購入日と今日の日付を照合してください。VN 株は T+2 の午後まで売却できません。暗号資産やグローバル株には適用されません。
2. すべての分析でリスクを定量化してください — 根拠とともに具体的な損切りと利益確定の水準を示し、投資シナリオが無効になる条件を明記し、リスク・リワード比を計算してください。
3. 一方に偏った分析は決して提示しないでください — すべてのティッカーについて、強気シグナルと弱気リスクの両方を示してください。
4. ポジションサイズを考慮してください — ポートフォリオの 30% を超える割合が 1 つのセクターに集中している場合は、集中リスクを指摘してください。
5. ポートフォリオを毎日確認してください — 決済済みポジションを記録し、損切り／利益確定の到達状況を確認し、投資シナリオの変化を指摘してください。

厳格なデータ読み取りと検証（重要）

**症状：**価格と移動平均線の関係を読み違えたり、誤って判断したりする（例：実際には上回っているのに、株価が「EMA20を下回っている」と述べる）。または、テクニカルイベントを誤分類する（例：ブレイクアウトの失敗を「健全な押し目」と呼ぶ）。

ルール：

• **行ごとの検証：**CLIのOHLCVデータ出力を読む際は、要求された日付の正確な行を厳密に読む必要があります。複数ティッカーの出力では、隣接する行や別のティッカーのブロックのデータを誤って読まないでください。
• grepによる精度フィルター：読み取りミスとコンテキスト量を抑えるため、複数のティッカーを対象にする場合も含め、必ず grep -E を使って対象日付を抽出してください。ヘッダーの目印として "time" を使用します。
  • 要点を絞った表示（ヘッダー＋今日＋ブレイクアウト日）： uvx aipa-cli get-ohlcv-data TCB MSB STB | grep -E "time|2026-05-27|2026-05-07"
  • 直近の日付を比較： uvx aipa-cli get-ohlcv-data VND | grep -E "time|2026-05-27|2026-05-26"
• **値を明示して比較：**トレンドが崩れたか維持されているかを結論づける前に、比較する値を明示してください：[終値] と [MA/EMAの値]。
  • 例：「終値は17.750、EMA20は16.881です。17.750 > 16.881 → 株価はEMA20を上回っています（トレンドは維持）。」
• ブレイクアウトの検証：ブレイクアウト（大幅な価格上昇＋出来高増加）によって、構造的なブレイクアウト水準、すなわちブレイクアウト前のベース／レンジの上限、直近のスイング高値、またはパターンのネックラインが重要なサポートになります。ブレイクアウト日のローソク足の安値は、信頼できる無効化水準ではありません。ギャップアップ、日中のノイズ、または値動きの激しいエントリー足によって、構造的な水準を大きく下回る場合があるためです。
  • 正しい無効化条件は、ローソク足の安値を下回ることではなく、構造的なブレイクアウト水準を下回ることです。
  • 価格が押し戻されても構造的な水準を上回っていれば、ブレイクアウトは維持されています。これは健全な押し目です。
  • 価格が構造的なブレイクアウト水準を下回った場合は、ブレイクアウト失敗／構造的違反です。
  • *対応：*押し目が健全か（構造を上回る）失敗か（構造を下回る）を判断する前に、必ずブレイクアウト前の構造を特定してください。

---

早すぎる利確（Chốt Non）の禁止 — 重要

**症状：**ポジションが1～3％の含み益になった段階で、「TP1に到達した」として、Wyckoffの投資仮説（Phase E Markup／SOS／LPSは未確認）を無視し、エージェントが一部または全部の決済を推奨する。

ルール：

1. **エントリー時点からの損益がATR(14)の1倍未満の場合、一部または全部の利確を推奨してはいけません。**ATRが利用できない場合、Markup Phase D/Eでは利益が3％未満、Accumulation breakoutでは5％未満なら利確してはいけません。

2. 「利確」に言及する前に、必ずWyckoffのフェーズを確認してください。

   • **Phase E Markup／SOSブレイクアウト：**利確してはいけません。トレンドは始まったばかりです。これはトレンド取引であり、スキャルピングではありません。
   • **再集積／スプリングのテスト：**利確してはいけません。ポジションができたばかりです。
   • 分配の兆候が現れた場合にのみ利確を検討してください（出来高のクライマックス、週足の弱気エンゴルフィング、長期上昇後のアップスラスト）。

3. 利確を提案する前に、モメンタムを確認してください。

   • 株価は出来高が20日平均を上回るスイング高値にありますか？
   • 分配のローソク足（シューティングスター、弱気エンゴルフィング、出来高急増）はありますか？
   • 上方に週足のレジスタンスはありますか？
   • 3項目すべてが「いいえ」の場合 → **利確は禁止です。**保有を続けてください。

4. 早すぎる利確のチェックリスト（売却／縮小を推奨する前に毎回実行してください）：

   質問	合格／不合格
   損益は3％超ですか？
   WyckoffのフェーズはDistribution／Upthrustですか？
   分配の兆候（出来高のクライマックス、週足の弱気シグナル）はありますか？
   週足チャートには上方に強いレジスタンスがありますか？

   4項目すべてが「いいえ」の場合 → **利確は禁止です。**その理由をレポートに記載してください。

5. 限定的な例外：早すぎる利確が許可されるのは、ユーザーが明示的に求めた場合、または緊急に資金が必要な場合に限ります。エージェントは、「利益を確保する」「リスクを減らす」など、どのような表現であっても、早すぎる利確を自律的に提案してはいけません。

---

追加購入ルール — 早まって利確するのではなく、追加購入を提案する

症状： ポジションが2〜3％上昇したところで、エージェントが一部利確を勧めます。そうではなく、エージェントは追加購入の機会を探すべきです。実力を示しているポジションは、縮小するのではなく、追加購入を検討する候補です。

考え方の転換： ポジションが機能している場合（出来高・価格アクションの確認を伴って2〜5％上昇している場合）、適切な対応は次のとおりです。

• しないこと： 「ここで50％利確してください」
• すること： 「押し目／ブレイクアウトの確認時に追加購入できる水準はこちらです」

ルール：

1. ポジションが含み益で、投資仮説が維持されている場合、TPを検討する前に必ず追加購入のセットアップを確認してください。 追加購入の計画はエントリー時に定義しておく必要があります（ポジションが動いた後に考案してはいけません）。

2. 有効な追加購入シナリオは2つです（エントリー時にどちらかを選ぶ必要があります）。

   • 押し目での追加購入（ゾーンB）： 出来高が減少するなか（No Supply）で、価格がより低いバリューゾーンまで押し戻されます。例：GASを84,800で購入 → 出来高の少ないテストで82,500〜83,500で追加購入。
   • ブレイクアウトでの追加購入： 出来高が20日平均の1.5倍を超えるなかで、価格が明確な構造上の水準（レンジ上限、スイング高値）を上抜けます。例：出来高が40Mを超えるなかで、ACBが25,500を上回る。

3. 構造上の根拠なしに成行価格で追加購入してはいけません。 「モメンタムが強い」は根拠になりません。事前に定義したゾーンへの押し目を待つことが根拠になります。

4. 提案の前に毎回、追加購入の可否を確認してください。

   質問	合格／不合格
   元のワイコフの投資仮説は維持されていますか？
   価格は事前に定義した追加購入ゾーンにありますか（行き先のない水準ではありませんか）？
   出来高は確認材料になっていますか？（押し目＝少ない／減少、ブレイクアウト＝多い／急増）
   ポジションはSLを試していませんか？
   この追加ロットは単独の取引としてR:R ≥ 1:1を満たしますか？

   すべて合格 → 追加購入を提案します。不合格が1つでもある場合 → 保有のみとし、追加購入はしません。

5. 1ポジションあたりの追加購入は最大2回です。 最大サイズに達したら、そのまま保有してトレンドの継続に任せます。それ以上のピラミッディングはしません。

---

事前チェック必須 — すべてのエントリー判断の前に行う安全ゲート

症状： 上位時間足の構造を確認せず、低時間足（15m／1h）だけでエントリーを分析しているため、投資仮説を無効にする過去の供給ゾーン（Buying Climax、UTAD）を見落とします。

ルール： エントリー、取引判断、または価格目標を提案する前に、必ず次を実行してください。

# 1. Daily 60 — detect BC/UTAD/historical structure
aipa get-ohlcv-data TICKER --limit 60 --no-ma

# 2. Weekly 52 — confirm overall trend direction
aipa get-ohlcv-data TICKER --interval 1W --limit 52 --no-ma

# 3. Volume Profile 30+ days — identify key price levels
aipa volume-profile TICKER --start-date [30+ days ago] --end-date [today]

これは分析ではなく、安全ゲートです。目的は、詳細な分析にトークンを費やす前に、構造上の危険信号を検出することです。

検出項目	意味	対応
現在の価格ゾーンでのBuying Climax（BC）	過去の出来高ピーク ＝ 大きな供給	ここではエントリーしないでください。より低いエントリーゾーンにするか、取り消してください。
Upthrust After Distribution（UTAD）	偽のブレイクアウト、ブルトラップ	エントリーを取り消してください。レンジへの回帰を待ちます。
週足トレンドが弱気（価格が週足MA20／50を下回っている）	全体的なトレンドは下向きです	ロングはしないでください。週足の反転を待ちます。
SOS確認済み＋週足が上向き	本物のブレイクアウトです	✅ エントリー分析に進みます。
POCでのスプリング＋週足サポート	底値のテストに成功しています	✅ エントリーは有効です。

エントリーの前に毎回行う事前確認チェックリスト：

□ Daily 60 — no BC/UTAD at current price zone
□ Weekly 52 — trend aligned with entry direction
□ VP 30d — TP anchored to swing high/VAH (not round number)
□ SL below POC/VAH/MA20
□ R:R ≥ 1:2 after precheck

2026年6月4日のFPTのエラーの根本原因： 日足60＋週足52の確認を省略し、15mのイントラデイ分析に直行しました。出来高が減少するなかで77,700から76,300への押し目を見て、健全な上昇局面でのLPS（最後のサポートポイント）だと誤って判断しました。5月20日のBuying Climax（高値77,432、終値76,643、出来高26M — 平均の2.2倍）を見落としていました。これは6月4日に76,300〜76,500で価格が再テストしていたのとまったく同じ供給ゾーンでした。事前チェック（日足60＋週足52＋VP 30d）を行っていれば、BCをすぐに検出し、その水準での買い推奨を阻止できていました。

---

Python で指標を計算 — 数値を捏造しない

症状： 前日比（+557% vs yesterday）を基に、実際の出来高対平均の倍率を計算せずに、AI が「出来高は平均の5倍」や「出来高は平均の20倍」と書いてしまいます。前日比と20日平均比の倍率はまったく異なる指標です。これらを混同すると、誤った主張になります。

ルール： 分析で数値を含む主張（出来高倍率、R:R 比率、平均取得単価、移動平均からの乖離）を書く前に、必ず aipa-cli | python3 パイプを使って計算してください。推定や推測は絶対にしないでください。

20日平均比の出来高（最もよくある間違い）

uvx aipa-cli get-ohlcv-data TICKER --limit 50 --no-ma --no-system-prompt 2>/dev/null | python3 -c "
import sys
from collections import defaultdict
data = defaultdict(list)
for line in sys.stdin:
    parts = line.split()
    if len(parts) >= 7 and parts[0] != 'time':
        data[parts[-1]].append((parts[0], int(float(parts[5]))))
for sym, rows in data.items():
    if len(rows) >= 21:
        avg20 = sum(r[1] for r in rows[-21:-1]) / 20
        last_vol = rows[-1][1]
        print(f'{sym} {rows[-1][0]}: vol={last_vol/1e6:.1f}M | avg20d={avg20/1e6:.1f}M | ratio={last_vol/avg20:.1f}x')
"

アンチパターン： 次のようなことは絶対にしないでください。

• volume_changed が +557% → 「出来高は平均の5倍」と書く ❌（557% ≠ 5倍であり、20日平均比ではなく前日比です）
• volume_changed が +216% → 「出来高は平均の2倍」と書く ❌（同じ間違いです）

正しい方法：

• volume_changed が +557% なら、今日の出来高は昨日の出来高の6.57倍です（1 + 5.57）
• 20日平均比の倍率を求めるには、必ず次の計算を行ってください：today_vol / average(last_20_days_vol)

出来高の一括確認（複数のティッカーと特定の日付）

uvx aipa-cli get-ohlcv-data VCB TCB MBB --limit 50 --no-ma --no-system-prompt 2>/dev/null | python3 -c "
import sys
from collections import defaultdict
data = defaultdict(list)
for line in sys.stdin:
    parts = line.split()
    if len(parts) >= 7 and parts[0] != 'time':
        data[parts[-1]].append((parts[0], int(float(parts[5]))))
checks = [
    ('VCB', '2026-06-10', 20),
    ('TCB', '2026-06-10', 20),
    ('MBB', '2026-06-10', 20),
]
for sym, date, ndays in checks:
    for i, (d, v) in enumerate(data.get(sym, [])):
        if d == date:
            start = max(0, i - ndays)
            avg = sum(r[1] for r in data[sym][start:i]) / len(data[sym][start:i])
            print(f'{sym} {date}: vol={v/1e6:.1f}M avg{ndays}d={avg/1e6:.1f}M ratio={v/avg:.1f}x')
            break
"

R:R の計算

python3 -c "
entry, sl, tp = 8400, 7700, 9500
risk = entry - sl
reward = tp - entry
rr = reward / risk
print(f'Risk={risk} Reward={reward} R:R={rr:.1f}:1 {\"OK\" if rr >= 2 else \"BLOCKED - R:R < 1:2\"}')"

平均取得単価（複数ロット）

python3 -c "
lots = [(8400, 1000), (8600, 500)]
total_qty = sum(q for _, q in lots)
avg = sum(p * q for p, q in lots) / total_qty
print(f'Avg cost: {avg:.0f} | Qty: {total_qty}')"

移動平均からの乖離率

uvx aipa-cli get-ohlcv-data TICKER --limit 50 --no-ma --no-system-prompt 2>/dev/null | python3 -c "
import sys
rows = []
for line in sys.stdin:
    parts = line.split()
    if len(parts) >= 7 and parts[0] != 'time':
        rows.append({'date': parts[0], 'close': float(parts[4]), 'ticker': parts[-1]})
if rows:
    closes = [r['close'] for r in rows]
    ma20 = sum(closes[-21:-1]) / 20
    pct = (rows[-1]['close'] - ma20) / ma20 * 100
    print(f\"{rows[-1]['ticker']} close={rows[-1]['close']:.0f} MA20={ma20:.0f} dist={pct:+.1f}%\")"

必須ルール： パイプコマンドで数値を検証できない場合は、どのファイルにも記載しないでください。実際に計算した値を使用し、倍率は小数第1位まで、パーセンテージは0.1%単位に丸めてください。

---

AI エージェント向けのヒント

1. 自動で大文字に変換：ティッカーシンボルは自動的に大文字に変換されます。vcb、btcusdt などを渡しても、VCB、BTCUSDT として扱われます。

2. データを確認するには --context-only を使用：API クレジットを消費せずに、利用可能なデータだけを確認するには、aipa analyze VCB --context-only を使用してください。

3. デフォルト設定で十分です：デフォルトのテンプレート（インデックス0、取引機会）は包括的です。ユーザーが特定の分析フレームワークを想定している場合にのみ、--question を指定してください。

4. 比較には複数のティッカーを使用：ユーザーが「比較して」や「どちらがよいか」と尋ねた場合は、複数のティッカーを渡してください：aipa analyze VCB TCB MBB。

5. ベトナム語ユーザーには --lang vn を使用：ユーザーがベトナム語で書いている場合、またはベトナム語での出力を求めている場合は、--lang vn を追加してください。

6. 透明性を高めるには --verbose を使用：ユーザーが推論の過程を確認したい場合は、--verbose を追加してください。

7. 生の数値には aipa-data を使用：ユーザーが AI 分析を求めず、「価格データ」「ローソク足データ」または「OHLCV」を求めている場合は、代わりに aipa-data スキルを使用してください。

8. 時間足は重要です：日中分析には 1h または 4h を使用してください。スイングトレードには 1D、スキャルピングには 15m または 5m を使用してください。

9. --limit と組み合わせる：バー数が多いほど、得られるコンテキストも増えます。より詳細な分析には --limit 50 または --limit 100 を使用してください。デフォルトは20です。

10. 参照ティッカー：ティッカーのソースに基づいて自動検出されます。VN 株には VNINDEX、暗号資産には BTCUSDT、世界の株式には ^GSPC が使用されます。上書きするには --reference-ticker を使用してください。

11. aipa performers で分析対象のティッカーを見つけ、複数の視点から実行：ユーザーが「何を分析すればよいか」や「今日は何が動いているか」と尋ねた場合は、複数の --sort-by 値を指定して aipa performers を実行し、複数の視点から確認してください。必ず次の2つ以上を実行してください：デフォルト（価格変動）と値（取引代金）。ユーザーがトレンドを重視する場合は、MA スコアも追加してください。リストを照合すると、より重要なティッカーが見つかります。その後、気になるティッカーを aipa analyze で分析してください。

    aipa performers                                          # 価格変動 — 上昇率上位／下落率上位
    aipa performers --sort-by value                          # 売買代金 — 資金の流れ
    aipa performers --sort-by ma50_score                     # MA50 トレンド — 中期トレンドの強さ／弱さ
    aipa performers --sort-by ma20_score                     # MA20 トレンド — 短期トレンドの強さ／弱さ
    aipa performers --sort-by total_money_changed            # 資金フローの変化 — 通常とは異なる資金の動き
    aipa performers --source crypto --sort-by value          # 売買代金で見た暗号資産
    aipa performers --group NGAN_HANG --sort-by value        # 売買代金で見た銀行セクター
    aipa performers --group CHUNG_KHOAN --sort-by close_changed  # 証券セクターの上昇率上位
    

12. サポート／レジスタンスの把握には aipa volume-profile を使用します：ティッカーを分析していて、ユーザーが重要な価格水準、サポート、レジスタンス、または「出来高があるのはどこか」について尋ねた場合は、aipa volume-profile TICKER を実行して、POC（コントロールポイント）、バリューエリア、出来高加重統計を取得します。単日プロファイルより複数日間の範囲を優先してください。より信頼性の高いサポート／レジスタンス水準が得られ、日中のノイズが平滑化されます。標準的な方法として、--start-date と --end-date を使い、少なくとも20取引日を対象にしてください。ユーザーが特定の1日について明示的に尋ねた場合に限り、単一の --date を使用します。例：

    • aipa volume-profile VCB --start-date 2026-04-14 --end-date 2026-05-09 — 1か月間の範囲（標準として推奨）
    • aipa volume-profile VCB --start-date 2026-04-28 --end-date 2026-05-09 --bins 30 — 2週間の範囲
    • aipa volume-profile VCB --date 2026-05-08 — 単一日（明示的に求められた場合のみ）
    • aipa volume-profile BTCUSDT --source crypto --bins 30 --start-date 2026-05-05 --end-date 2026-05-09 — 暗号資産の複数日間
    • aipa volume-profile FPT --start-date 2026-05-01 --end-date 2026-05-09 --bins 30 --value-area-pct 80 — すべてのオプションを指定