aipa-data について
aipa-dataは、ベトナム株、暗号資産、グローバル資産の市場データを取得するコマンドラインスキルです。aipa CLIでOHLCV、最新スナップショット、銘柄検索、ウォッチリストを扱い、生データ取得にAPIキーは不要です。
主な機能
- 01複数市場のOHLCVデータ取得
- 02時間足と期間の指定
- 03最新データと売買代金ランキング取得
- 04市場や分類による銘柄検索
- 05既定・カスタムウォッチリスト管理
- 06移動平均の種類を設定
活用シーン
- 01ベトナム株や暗号資産のローソク足を確認
- 02期間を指定して市場データを取得
- 03売買代金の大きい銘柄を抽出
- 04分析や表計算向けに簡潔なデータを用意
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/aipa-dataを入力して読み込まれたか確認します。
詳細
aipa-data
AIPriceAction が開発しました。詳細なデータとドキュメントについては https://aipriceaction.com をご覧ください。
トレーダーに贈るインスピレーションの言葉
思考と方法論
- 「利益をもたらすのはトレンドだけです。市場に逆らおうとしないでください。」
- 「トレードとは未来を予測することではなく、リスクを管理し、規律を守ることです。」
- 「出来高はスマートマネーの足跡です。価格は人を欺くことがありますが、出来高はそうではありません。」
- 「適切なセットアップを辛抱強く待つことが、成功へと導く黄金の鍵です。」
- 「市場は常に正しく、私たちの懐だけが自己責任です。」
- 「持続的な利益は、天井や底を言い当てることではなく、忍耐と一貫性から生まれます。」
- 「大きく下げたからといって、下落が終わったとは限りません。さらなる確認が必要です。」
規律とリスク管理
- 「リスク管理の規律を守れば、ひどい目に遭うことはありません！」
- 「計画なしのトレードは、失敗を計画しているのと同じです。」
- 「損切りは常に正しく、含み損を抱え続けるのは常に間違いです。」
- 「利益を考える前に、まず生き残りましょう。」
- 「資金を守ることは、お金を稼ぐことより重要です。」
- 「株に惚れ込んではいけません。その株がもたらす利益と安全性だけを大切にしましょう。」
- 「スプリングには、2～3取引日の確認と No Supply のプルバックが必要です。1日の急騰だけでは何もわかりません。」
- 「30％下落していても、落ちてくるナイフをつかんではいけません。出来高プロファイルとワイコフ理論の確認を待ちましょう。」
心理と実践
- 「涙を流すより、よだれを垂らすほうがましです。」
- 「確かな底が見えるまでは、落ちてくるナイフをつかもうとしないでください。」
- 「上昇トレンドの中では誰もが投資の天才です。潮が引いたときに、誰が裸で泳いでいたかがわかります。」
- 「価格が急騰した後に FOMO で追いかけて買うのは、安全ベルトを締め忘れてジェットコースターに乗るようなものです。」
- 「天井を予想せず、底を探らないでください。」
- 「強気派は稼ぎ、弱気派も稼ぎ、欲張りな豚は屠殺されます。」
- 「トレンドは友です。その友と一緒に進みましょう。」
- 「噂で買い、事実で売る。」
- 「最大の過ちは、株価が大きく下がったのを見て、また上がると思い込むことです。市場はあなたに理由を説明する義務はありません。」
- 「スプリングとアップスラストを見分けるには、『この銘柄は供給を一掃するほど下落したか？』と問いましょう。まだ十分に下落していなければ、供給が残っておりリスクがあります。十分に下落していれば、売り手がいなくなっておりチャンスです。」
忍耐とポジション管理（早すぎる利確を避け、ポジションを追加）
- 「利益を伸ばしましょう。」
- 「早すぎる利確は、利益を逃すことです。」
- 「うまくいっていれば追加し、間違っていれば損切りしましょう。」
- 「大きな利益は、じっと座っていることから生まれます。」
- 「正しければ保有し、間違っていれば損切りしましょう。」
aipa とは
aipa は、ベトナム株、暗号資産、世界の資産を分析する AI 搭載の金融分析 CLI です。get-ohlcv-data コマンドは、AI も API キーも必要とせず、未加工の OHLCV 価格データを取得します。
インストール
uvx を使用してください。インストールは不要です。各セッションでの初回呼び出しには、キャッシュを更新するため uvx aipa-cli@latest を使用してください。それ以降の呼び出しでは、通常の uvx aipa-cli を使用してください（高速で、キャッシュが利用されます）。
# All calls — fast cached execution (uvx automatically checks for updates)
uvx aipa-cli get-ohlcv-data VCB
uvx aipa-cli get-ohlcv-data TCB
# Fallback: pip (if uv is not available)
pip install aipa-cli
aipa get-ohlcv-data VCB
# Fallback: system pip (if pip fails due to PEP 668)
python3 -m pip install aipa-cli --break-system-packages
aipa get-ohlcv-data 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 を使用する場合：
- キャッシュを利用した高速実行には、通常の
uvxを使用します。uvx aipa-cli get-ohlcv-data VCB - 失敗した場合のフォールバック — スキーマエラーまたは引数不足のエラーでコマンドが失敗した場合は、
@latestを付けて再試行します。uvx aipa-cli get-ohlcv-data VCB（コマンドが失敗した場合は@latestを追加）
aipa を pip でグローバルにインストールしている場合は、各セッションの前に更新してください。
pip install --upgrade aipa-cli
エージェントは、すべてのコマンドで uvx aipa-cli を優先してください。uvx が利用できない場合に限り、aipa にフォールバックしてください。
環境変数
必要な環境変数はありません。get-ohlcv-data はパブリック S3 アーカイブからデータを取得するため、バックエンド API も API キーも不要です。
利用可能なデータソース
- ベトナム株（
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 with get-ohlcv-data
aipa get-ohlcv-data $(aipa watchlist get VN30)
対応している時間間隔
| 時間間隔 | 説明 | 主な用途 |
|---|---|---|
1D | 1 日（デフォルト） | スイングトレード、トレンド分析 |
1h | 1 時間 | 日中分析、デイトレード |
1m | 1 分 | スキャルピング、マイクロストラクチャー |
5m | 5 分 | スキャルピング、マイクロストラクチャー |
15m | 15 分 | 日中パターン |
30m | 30 分 | 日中パターン |
4h | 4 時間 | スイングトレード、日中取引 |
1W | 1 週間 | 中期トレンド分析 |
2W | 2 週間 | 中期トレンド分析 |
aipa get-ohlcv-data — OHLCV 生データ
AI 分析なしで、OHLCV の価格データを取得します。オプションで移動平均を含む価格データを出力します。
aipa get-ohlcv-data TICKER [TICKERS...] [options]
フラグ
| フラグ | デフォルト | 説明 |
|---|---|---|
TICKER [TICKERS...] | — | 1 つ以上のティッカーシンボル（自動的に大文字に変換） |
--interval | 1D | 時間間隔：1m、5m、15m、30m、1h、4h、1D、1W、2W |
--limit N | — | バーの数 |
--start-date | — | 開始日（例：2025-01-01） |
--end-date | — | 終了日（例：2025-05-01） |
--source | 自動検出 | ソースで絞り込み：vn、crypto、global |
--ma / --no-ma | 含む | 移動平均を含める／除外する |
--sma / --ema | 設定に従う | SMA または EMA を強制指定します（use_sma 設定を上書き）。デフォルトの MA タイプは aipa config get use_sma で制御します。 |
--no-system-prompt | — | 出力からペルソナヘッダーを除外 |
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）に合わせてください。
便利なプリセット
これらのプリセットは、最も一般的なデータ取得のシナリオを網羅しています。そのまま使うか、パラメーターを調整してください。
クイック確認
# Last 20 daily candles with MA indicators (type from use_sma setting)
aipa get-ohlcv-data VCB
# Last 20 daily candles, raw OHLCV only
aipa get-ohlcv-data VCB --no-ma
トレンド分析（スイングトレード）
# 50 daily bars with MA indicators (type from use_sma setting) — good for trend identification
aipa get-ohlcv-data VCB --limit 50
# 100 daily bars for long-term trend
aipa get-ohlcv-data VIC --limit 100
# EMA for more responsive trend analysis
aipa get-ohlcv-data FPT --limit 50 --ema
日中データ
# Last 50 hourly candles
aipa get-ohlcv-data BTCUSDT --interval 1h --limit 50
# Last 100 hourly candles for intraday patterns
aipa get-ohlcv-data ETHUSDT --interval 1h --limit 100
# Minute data for scalping analysis
aipa get-ohlcv-data BTCUSDT --interval 1m --limit 100
日付範囲
# Specific date range
aipa get-ohlcv-data FPT --start-date 2025-01-01 --end-date 2025-05-01
# From a date to today
aipa get-ohlcv-data VCB --start-date 2025-04-01
# All data in a range, no MA
aipa get-ohlcv-data HPG --start-date 2025-01-01 --end-date 2025-05-01 --no-ma
暗号資産
# BTC daily with EMA
aipa get-ohlcv-data BTCUSDT --limit 50
# ETH hourly for intraday
aipa get-ohlcv-data ETHUSDT --interval 1h --limit 100
# SOL raw candles, no MA
aipa get-ohlcv-data SOLUSDT --limit 30 --no-ma
# BNB daily with EMA
aipa get-ohlcv-data BNBUSDT --limit 50 --ema
ベトナム株
# Banking sector — all in one call
aipa get-ohlcv-data VCB TCB MBB CTG --limit 30
# Blue chips
aipa get-ohlcv-data VIC FPT VNM --limit 50
# Market index
aipa get-ohlcv-data VNINDEX --limit 50
グローバル株
# US tech stocks
aipa get-ohlcv-data AAPL --limit 50
aipa get-ohlcv-data NVDA --limit 50
aipa get-ohlcv-data TSLA --limit 50
# Market index
aipa get-ohlcv-data SPY --limit 100
最小限の出力（解析／スプレッドシート向け）
# Strip persona header for clean data output
aipa get-ohlcv-data VCB --no-system-prompt
# Raw OHLCV only, no MA, no header — cleanest output
aipa get-ohlcv-data VCB --no-ma --no-system-prompt
aipa ticker-list — 利用可能なティッカーの一覧表示
利用可能なティッカーシンボルを、メタデータ（名前、グループ、取引所、ソース）とともに一覧表示します。LLM は使用せず、API キーも必要ありません。
データを取得する前に、利用可能なティッカーを確認するために使用してください。
aipa ticker-list [--source vn|crypto|global|sjc] [--group GROUP] [--compact]
フラグ
| フラグ | デフォルト | 説明 |
|---|---|---|
--source | — | ソースで絞り込みます：vn、crypto、global、sjc |
--group | — | グループで絞り込みます（例：NGAN_HANG、CHUNG_KHOAN、BAT_DONG_SAN） |
--compact | — | シンボルのみをカンマ区切りで出力します |
使用例
# All tickers
aipa ticker-list
# VN stocks only
aipa ticker-list --source vn
# Banking sector
aipa ticker-list --source vn --group NGAN_HANG
# Crypto symbols only (for passing to other commands)
aipa ticker-list --source crypto --compact
データフィールド
各行には、ティッカー、名前、グループ、取引所、ソースが含まれます。
aipa live-data — 取引額上位のティッカー
すべてのティッカー、または指定したティッカーの最新のローソク足を取得します。LLM は関与せず、API キーも不要です。ティッカーを指定しない場合は、取引額（終値 × 出来高）の降順で並べた上位 N 件のティッカーを返します。
これを使うと、最も活発に取引されているティッカーをすばやく特定し、市場の概況を把握できます。
aipa live-data [TICKERS...] [--top 50] [--interval 1D]
フラグ
| フラグ | デフォルト | 説明 |
|---|---|---|
TICKERS... | — | 任意のティッカーシンボル（自動的に大文字に変換されます）。取引額上位 N 件を取得する場合は省略します。 |
--top N | 50 | ティッカーを指定しない場合に表示する上位ティッカーの数 |
--interval | 1D | 時間間隔：1m、5m、15m、30m、1h、4h、1D、1W、2W |
--source | — | ソースで絞り込みます：vn、crypto、global、sjc |
使用例
# Top 50 by trading value (broad market overview)
aipa live-data
# Top 10 only
aipa live-data --top 10
# Top 20 hourly
aipa live-data --interval 1h --top 20
# Filter by source: SJC gold
aipa live-data --source sjc
# Filter by source: crypto top 10
aipa live-data --source crypto --top 10
# Specific tickers only
aipa live-data VCB TCB MBB
データフィールド
各行には、ティッカー、時刻、始値、高値、安値、終値、出来高、終値変動率（%）、出来高変動率（%）、ma10_score、ma50_score が含まれます。
aipa performers — 上昇率・下落率の上位銘柄
ライブの日次データを、任意の指標で並べ替えて上昇率・下落率の上位銘柄を表示します。LLM は関与せず、API キーも不要です。デフォルトではベトナム株を対象にします。
aipa performers [--sort-by close_changed] [--direction desc] [--limit 10] [--source vn] [--group NGAN_HANG]
フラグ
| フラグ | デフォルト | 説明 |
|---|---|---|
--sort-by | close_changed | 指標：close_changed、volume、value、volume_changed、ma10_score、ma20_score、ma50_score、ma100_score、ma200_score、total_money_changed |
--direction | desc | 並べ替え順：desc（上昇幅が大きい順）または asc（下落幅が大きい順） |
--limit N | 10 | リストごとの項目数 |
--min-volume N | 10000 | ベトナムのティッカーの最小出来高 |
--source | vn | データソース：vn、crypto、global、sjc |
--group | — | セクターで絞り込みます：NGAN_HANG、CHUNG_KHOAN、BAT_DONG_SAN、CONG_NGHE、DAU_KHI など |
使用例
# 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
# Top 10 by trading value (close × volume)
aipa performers --sort-by value --limit 10
# By money flow
aipa performers --sort-by total_money_changed --limit 15
# Banking sector only, sorted by value
aipa performers --group NGAN_HANG --sort-by value
# Securities sector top gainers
aipa performers --group CHUNG_KHOAN --sort-by close_changed --limit 5
# Real estate sector by MA50 trend
aipa performers --group BAT_DONG_SAN --sort-by ma50_score
aipa volume-profile — 価格帯別出来高ヒストグラム
1 分足データを使った出来高プロファイル分析で、Point of Control（POC）、バリューエリア、出来高加重統計を表示します。LLM は関与せず、API キーも不要です。
aipa volume-profile TICKER [--date YYYY-MM-DD] [--source vn] [--bins 50] [--value-area-pct 70]
フラグ
| フラグ | デフォルト | 説明 |
|---|---|---|
TICKER | — | ティッカーシンボル（必須） |
--date | 今日 | 単一の日付（YYYY-MM-DD） |
--start-date / --end-date | — | 日付範囲 |
--source | 自動検出 | ティックサイズのソース：vn、crypto、global、sjc |
--bins N | 50 | 価格帯の数（2～200） |
--value-area-pct | 70 | バリューエリアの目標割合（60～90） |
使用例
単日のプロファイルよりも、複数日にわたる期間を優先してください。複数日のプロファイルは、より信頼性の高いサポート・レジスタンス水準を示し、日中のノイズを平滑化します。デフォルトでは、--start-date と --end-date を使って、少なくとも 20 営業日を対象にしてください。ユーザーが特定の 1 日を明示的に指定した場合に限り、単一の --date を使います。
# 1-month range for VCB (preferred default)
aipa volume-profile VCB --start-date 2026-04-14 --end-date 2026-05-09
# 2-week range
aipa volume-profile VCB --start-date 2026-04-28 --end-date 2026-05-09 --bins 30
# Specific date (only when user asks for one day)
aipa volume-profile VCB --date 2026-05-09
# Crypto multi-day range
aipa volume-profile BTCUSDT --source crypto --bins 30 --start-date 2026-05-05 --end-date 2026-05-09
# Full options: date range with wider value area
aipa volume-profile FPT --start-date 2026-05-01 --end-date 2026-05-09 --bins 30 --value-area-pct 80
出力
- POC（Point of Control）：出来高が最も多い価格水準
- バリューエリア：出来高の合計が目標割合（デフォルトは 70%）に達する価格範囲
- 統計：出来高加重平均、中央値、標準偏差、歪度
- プロファイル：価格帯ごとの出来高、割合、視覚的な棒グラフ
出力の解釈
CLI は 2 つのストリームに出力します。
- stdout：OHLCV データテーブル。ユーザーに提示するのはこちらです。
- stderr：構造化マーカー付きのステータスメッセージ。
ステータスマーカー（stderr）
| マーカー | 意味 |
|---|---|
[build] | データ取得のステータスと所要時間 |
[error] | エラーメッセージ |
[done] | 取得完了。合計所要時間を含みます |
データ項目
各行には、日時、始値、高値、安値、終値、出来高が含まれます。--ma が有効な場合（デフォルト）、移動平均の列も含まれます。
クレジット表記
データまたはその分析結果をユーザーに提示するときは、回答の末尾に必ずクレジット表記を含めてください。
- 英語: "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 が生成するもので、不正確な場合があります。
aipa fundamentals — ファンダメンタルデータ（aipa-cli >= 0.1.48 が必要）
バージョン要件：
aipa fundamentalsには aipa-cli >= 0.1.48 が必要です。使用前に確認してください。aipa --version # or uvx aipa-cli --versionバージョンが 0.1.48 未満の場合は、アップグレードしてください。
uvx aipa-cli@latest fundamentals info ACBまたはpip install --upgrade aipa-cliを実行します。
LLM は使用せず、API キーも不要です。キャッシュされた vn.zip を読み込みます（初回の呼び出し時に約 15～20 MB をダウンロードし、その後はローカルにキャッシュされます）。
重要： Fundamentals コマンドで受け付けるフラグは、以下に記載されているものだけです。
取得するタイミング： Fundamentals を自動的に実行しないでください。デフォルトはテクニカル分析（VPA、Wyckoff、MA）です。ユーザーが「report」または「báo cáo」と言った場合、ファンダメンタル分析を求めている可能性があります。不明な場合は、確認してください。
aipa fundamentals info — 企業プロフィール
ティッカーの企業プロフィール、株主、役員を表示します。
aipa fundamentals info TICKER [--source vn]
フラグ
| フラグ | デフォルト | 説明 |
|---|---|---|
TICKER | — | ティッカーシンボル（必須） |
--source | auto | データソース |
使用例
# Company profile for ACB
aipa fundamentals info ACB
# With explicit source
aipa fundamentals info FPT --source vn
出力項目
業種、時価総額、現在価格、発行済み株式数、持ち株比率（%）付きの主要株主、役職付きの役員。
aipa fundamentals ratios — 財務比率
ティッカーの財務比率をカテゴリ別に表示します。LLM は使用せず、API キーも不要です。
aipa fundamentals ratios TICKER [options]
フラグ
| フラグ | デフォルト | 説明 |
|---|---|---|
TICKER | — | ティッカーシンボル（必須） |
--latest | off | 最新の期間のみ表示（四半期または年次）。最速で、結果は 1 件のみです |
--no-yearly | off | 四半期レポートを含めます |
--yearly | off | 年次レポートのみ表示します |
--year YEAR | — | 指定した年を表示します（例：2024） |
--period PERIOD | — | "2024" や "2024 Q2" など、特定の期間を指定します |
--category | all | valuation、profitability、leverage、liquidity、bank、efficiency |
--json | off | 生の JSON を出力します |
--source | auto | データソース |
使用例
# All periods (yearly + quarterly) — default
aipa fundamentals ratios VCB
# Latest period only (quarterly or yearly) — quickest, single result
aipa fundamentals ratios VCB --latest
# Specific year
aipa fundamentals ratios VCB --year 2024
# Specific quarter
aipa fundamentals ratios VCB --period "2024 Q2"
# Include quarterly reports (same as default)
aipa fundamentals ratios VCB --no-yearly
# Yearly reports only
aipa fundamentals ratios VCB --yearly
# Only bank-specific fields
aipa fundamentals ratios VCB --category bank
# Raw JSON output
aipa fundamentals ratios VCB --json
カテゴリ
| カテゴリ | 項目 |
|---|---|
| Valuation | PE、PB、PS、EV/EBITDA、株価/キャッシュフロー、配当利回り、時価総額 |
| Profitability | ROE、ROA、ROIC、売上総利益率、税引後利益率、税引前利益率、EBIT マージン、純金利マージン |
| Efficiency | 総資産回転率、固定資産回転率、キャッシュサイクル、DSO、DIO、DPO |
| Leverage | 負債/自己資本、財務レバレッジ、自己資本/負債、自己資本/貸付金、自己資本/総資産 |
| Liquidity | 流動比率、当座比率、現金比率 |
| Bank | NPL、LDR、CAR、CASA、CIR、非金利収入、預金/貸付金の成長率、LLR 比率 |
aipa fundamentals rank — ファンダメンタル項目で順位付け
50 以上のファンダメンタル項目のいずれかを使ってティッカーを順位付けします。LLM は使用せず、API キーも不要です。
aipa fundamentals rank [TICKERS...] [options]
フラグ
| フラグ | デフォルト | 説明 |
|---|---|---|
tickers | all VN | 位置引数で指定するティッカーシンボル |
--sort-by | roe | ランキングに使用するフィールド（50 以上のフィールド。下記を参照） |
--direction | desc | desc（高い順）または asc（低い順） |
--limit | 10 | 最大結果数 |
--latest | off | 最新期間のみ表示（四半期または年次） |
--yearly | off | 年次レポートのみ |
--year YEAR | — | 特定の年（例：2024） |
--period PERIOD | — | "2024" や "2024 Q2" などの特定の期間 |
--watchlist | — | ウォッチリストをティッカーの取得元として使用（VN30、VINGROUP、TM、MASAN、カスタムなど） |
--source | auto | データソース |
使用例
# Top 10 VN stocks by ROE (default)
aipa fundamentals rank
# Cheapest 20 by PE
aipa fundamentals rank --sort-by pe --direction asc --limit 20
# Banking tickers ranked by CAR
aipa fundamentals rank VCB BID CTG TCB MBB --sort-by car --direction desc
# VN30 watchlist ranked by ROE
aipa fundamentals rank --watchlist VN30 --sort-by roe --limit 15
# Best asset quality (lowest NPL)
aipa fundamentals rank --sort-by npl --direction asc --limit 10
# Highest dividend yield
aipa fundamentals rank --sort-by dividend_yield --direction desc
# Largest by market cap
aipa fundamentals rank --sort-by market_cap --direction desc --limit 20
# Historical year
aipa fundamentals rank --year 2023 --sort-by roe
# Specific quarter
aipa fundamentals rank --period "2016 Q4" --sort-by roe
ソート可能なフィールド（50 以上）
pe、pb、ps、ev_to_ebitda、price_to_cash_flow、dividend_yield、market_cap、roe、roa、roic、gross_margin、after_tax_profit_margin、pre_tax_profit_margin、ebit_margin、net_interest_margin、ebit、ebitda、asset_turnover、fixed_asset_turnover、debt_to_equity、debt_per_equity、financial_leverage、equity_to_liabilities、equity_to_loans、total_equity_total_asset、owners_equity、equity、current_ratio、quick_ratio、cash_ratio、cash_cycle、day_sale_outstanding、days_inventory_outstanding、days_payable_outstanding、npl、ldr_loan_deposit_ratio、car、casa_ratio、cir、cost_to_income、non_and_interest_income、deposit_growth、loans_growth、loans_loss_reserve_to_loans、loans_loss_reserves_to_npl、provision_to_outstanding_loans、average_cost_of_financing、average_yield_on_earning_assets、outstanding_shares、employees、current_price。
ティッカーの取得元の解決（rank と screen）
--watchlist NAME— 定義済み（VN30、VINGROUP など）またはカスタムのウォッチリストから解決します- 位置引数の
tickers— 明示的なリスト - デフォルト — ティッカーのメタデータからすべての VN ティッカーを取得します
aipa fundamentals screen — 複数条件によるスクリーニング
ファンダメンタルズの条件でティッカーを絞り込み、その後フィールドでランキングします。LLM は使用せず、API キーも必要ありません。
aipa fundamentals screen [TICKERS...] [options]
フラグ
| フラグ | デフォルト | 説明 |
|---|---|---|
tickers | all VN | 位置引数で指定するティッカーシンボル |
--sort-by | roe | ランキングに使用するフィールド（rank と同じ） |
--direction | desc | ソート順 |
--limit | 50 | 最大結果数（1～500） |
--latest | off | 最新期間のみ表示（四半期または年次） |
--yearly | off | 年次レポートのみ |
--year YEAR | — | 特定の年（例：2024） |
--period PERIOD | — | "2024" や "2024 Q2" などの特定の期間 |
--watchlist | — | ウォッチリストをティッカーの取得元として使用 |
--source | auto | データソース |
--pe-min / --pe-max | — | PE の範囲フィルター |
--pb-min / --pb-max | — | PB の範囲フィルター |
--roe-min / --roe-max | — | ROE の範囲フィルター |
--roa-min / --roa-max | — | ROA の範囲フィルター |
--dividend-yield-min / --dividend-yield-max | — | 配当利回りの範囲 |
--debt-to-equity-max | — | 負債資本比率の上限 |
--npl-max | — | NPL の上限（銀行） |
--car-min | — | CAR の下限（銀行） |
--cir-max | — | CIR の上限（銀行） |
--market-cap-min / --market-cap-max | — | 時価総額の範囲 |
--industry | — | 業種フィルター（部分一致、大文字と小文字を区別しない） |
使用例
# Value stocks: low PE + high ROE
aipa fundamentals screen --pe-max 15 --roe-min 0.15 --sort-by roe
# Banking sector only
aipa fundamentals screen --industry "ngân hàng" --sort-by roe
# Safe banks: low NPL + high CAR
aipa fundamentals screen --npl-max 0.015 --car-min 0.10 --sort-by npl --direction asc
# Dividend stocks
aipa fundamentals screen --dividend-yield-min 0.03 --sort-by dividend_yield
# Screen VN30 watchlist
aipa fundamentals screen --watchlist VN30 --pe-max 20 --roe-min 0.10
# Specific tickers
aipa fundamentals screen VCB FPT HPG VNM --roe-min 0.15 --sort-by pe --direction asc
# Historical year
aipa fundamentals screen --year 2024 --sort-by roe
# Specific quarter
aipa fundamentals screen --period "2024 Q3" --sort-by roe
フィルターの動作
- すべてのフィルターは任意です。必要なものだけ指定してください
- フィルター対象のフィールドのデータが欠けているティッカーは除外されます
- 範囲フィルターは境界値を含みます。
--roe-min 0.15はroe >= 0.15に一致します --industryは大文字と小文字を区別しない部分一致です（例："ngân hàng"は"Ngân hàng"に一致します）
ファンダメンタルズの基本比較ワークフロー
複数のティッカーのファンダメンタルズを比較する場合（例：「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 回実行し、出力を手動で比較するより、はるかに効率的です。順位付けによって相対的な位置をすぐに確認でき、スクリーニングによって詳細調査にトークンを費やす前に適さない候補を除外できます。
このスキルと他のスキルの使い分け
| ユーザーのリクエスト | 使用するもの |
|---|---|
| 「VCB の価格データを取得して」 | aipa-data（このスキル） |
| 「BTC の OHLCV ローソク足を表示して」 | aipa-data（このスキル） |
| 「FPT の移動平均はいくつ？」 | aipa-data（このスキル） |
| 「VNINDEX の過去の価格」 | aipa-data（このスキル） |
| 「今日の上位銘柄は？」 | aipa live-data（このスキル） |
| 「最も活発なティッカー」 | aipa live-data（このスキル） |
| 「市場概況を表示して」 | aipa live-data（このスキル） |
| 「利用可能なティッカーは？」 | aipa ticker-list（このスキル） |
| 「銀行株を一覧表示して」 | aipa ticker-list --source vn --group NGAN_HANG（このスキル） |
| 「値上がり銘柄／値下がり銘柄の上位」 | aipa performers（このスキル） |
| 「パフォーマンスの高い銘柄」 | aipa performers --sort-by close_changed（このスキル） |
| 「MA スコアで順位付け」 | aipa performers --sort-by ma50_score（このスキル） |
| 「VCB の出来高プロファイル」 | aipa volume-profile VCB（このスキル） |
| 「POC はどこ？」 | aipa volume-profile TICKER（このスキル） |
| 「出来高によるサポート／レジスタンス」 | aipa volume-profile TICKER（このスキル） |
| 「ACB の企業プロフィール」 | aipa fundamentals info ACB（このスキル） |
| 「VCB の PE 比率」 | aipa fundamentals ratios VCB --latest（このスキル） |
| 「ROE による上位銘柄」 | aipa fundamentals rank --sort-by roe（このスキル） |
| 「PE が低い銀行をスクリーニング」 | aipa fundamentals screen --industry "ngân hàng" --pe-max 10（このスキル） |
| 「銀行の NPL を比較」 | aipa fundamentals rank --sort-by npl --direction asc（このスキル） |
| 「VCB を分析」 | aipa-analyze（AI 分析） |
| 「FPT と VNM を比較」 | aipa-analyze（AI 比較） |
| 「銀行セクターを調査」 | aipa-research（マルチエージェントパイプライン） |
重要なルール：生の数値 → aipa-data、AI による分析 → aipa-analyze、包括的なレポート → aipa-research。
中核セクター（コア市場セクター — VN 市場のみ）
データを取得したり、VN 銘柄をランキングしたりする際は、参考情報として以下の中核セクター分類を考慮してください。
- 銀行グループ（銀行）： 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。
- 企業エコシステムグループ：
- Vingroup 系：VIC, VHM, VRE, VPL。
- Bầu Thụy 系：STB, LPB, THD, HAG。
- Gelex 系（「Tuấn Mượt」）：GEX, GEE, VIX, VGC, EIB, IDC。
- Hoàng Huy 系：TCH, HHS。
- A7 系：DIG, CEO, L14。
- TTC 系（Thành Thành Công）：SBT, GEG, VDS。
- Masan 系：MSN, MCH, MSR, MML, VCF, VSN, NET。
- Viettel 系：VGI, CTR, VTP。
(注：この分類はベトナム市場にのみ適用されます。暗号資産市場とグローバル市場では、現時点でこの分類は使用されていません。)
データ使用ポリシー（重要）
- 価格、出来高、MA 値、MA スコア、パーセンテージ、日付など、あらゆる数値や金融データを決して生成、推測、概算、または捏造しないでください。 ツールの結果またはユーザーから提供されたコンテキストのデータのみを使用してください
- ツールの結果またはユーザーから提供されたコンテキストに含まれていない具体的な数値は、決して言及しないでください
- 積極的にツールを使用してください — 価格に関する質問に回答する前に、
aipa get-ohlcv-dataおよび／またはaipa performersを呼び出してください。ツールが失敗した場合にのみ、ユーザーへの確認に切り替えてください - ニュースやイベントを調べる際は、必ず情報源名を記載してください（例：「情報源：CafeF」、「情報源：VNExpress」）
- 取引時間： VN 市場の取引時間は月曜から金曜の 09:00〜15:00 ICT（UTC+7）です。暗号資産市場は 24 時間 365 日取引されています。最新のバーで出来高が異常に少ない場合、セッションがまだ進行中の可能性があります
厳密なデータ読み取りと検証（重大）
症状： 価格と移動平均線の関係を読み違えたり、誤って推測したりすること（例：実際には上回っているのに、株価が「EMA20を下回っている」と述べる）、またはテクニカルイベントを誤分類すること（例：ブレイクアウトの失敗を「健全な押し目」と呼ぶ）。
ルール：
- 行ごとの検証： CLI の OHLCV データ出力を読むときは、指定された日付の正確な行を必ず厳密に確認してください。複数の銘柄が含まれる出力では、誤って隣接行や別の銘柄のブロックのデータを読まないでください。
- grep による精度フィルター： 読み取りミスとコンテキスト量を最小限に抑えるため、1 つまたは複数の銘柄から対象日付を抽出するには、常に
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 を上回っています（トレンドは維持されています）。」
- ブレイクアウトの検証： ブレイクアウト（大幅な価格上昇＋高出来高）によって、構造的なブレイクアウト水準、つまりブレイクアウト前のベース／レンジの上限、直近のスイング高値、またはパターンのネックラインに重要なサポートが形成されます。ブレイクアウトしたローソク足の安値は、信頼できる無効化水準ではありません。窓開け、日中のノイズ、または値動きの大きなエントリー足により、構造的な水準を大きく下回ることがあるためです。
- 正しい無効化条件は、ローソク足の安値を下回ることではなく、構造的なブレイクアウト水準を下回ることです。
- 価格が押し戻されても構造的な水準を上回っていれば、ブレイクアウトは維持されています。これは健全な押し目です。
- 価格が構造的なブレイクアウト水準を下回った場合は、ブレイクアウト失敗／構造的違反です。
- 対応： まず必ずブレイクアウト前の構造を特定してください。その後に、押し目が健全か（構造を上回る）失敗か（構造を下回る）を判断します。
事前チェック必須 — すべてのエントリー判断前の安全ゲート
症状： 上位時間軸の構造を確認せずに、低時間軸（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 での Spring＋週足サポート | 底値のテストに成功 | ✅ エントリーは有効です。 |
毎回のエントリー前に行う事前チェックリスト：
□ 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（Last Point of Support）だと誤って判断しました。5 月 20 日の Buying Climax（高値 77,432、終値 76,643、出来高 26M — 平均の 2.2 倍）を見落としていました。これは、6 月 4 日に価格が 76,300〜76,500 で再テストしていたのとまったく同じ供給ゾーンでした。事前チェック（日足 60＋週足 52＋VP 30d）を行っていれば、BC をすぐに検出し、その水準での買い推奨を阻止できていました。
Python で指標を計算 — 数値を捏造しない
症状： AI が前日比（+557% vs yesterday）をもとに「出来高は5倍」や「出来高は平均の20倍」と書いてしまい、実際の出来高と平均の倍率を計算していません。前日比と20日平均比の倍率はまったく異なる指標です。混同すると、誤った主張につながります。
ルール： 分析で数値に関する主張（出来高の倍率、R:R 比率、平均取得価格、MA との乖離）を書く前に、必ず 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}')"
MA からの乖離率
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 エージェント向けのヒント
-
API キーもバックエンドも不要です：
get-ohlcv-dataは公開 S3 アーカイブから取得します。OPENAI_API_KEYや稼働中のバックエンドがなくても動作します。 -
ティッカーは自動で大文字になります：ティッカーシンボルは自動的に大文字に変換されます。
vcb、btcusdt、spyはすべて使用できます。 -
デフォルトは20本です：ユーザーが本数を指定しない場合、20本が取得されます。より多くの情報が必要な場合は、
--limit 50または--limit 100を使ってください。 -
データをそのまま取得するには
--no-ma --no-system-promptを使います：ユーザーが独自の分析やスプレッドシート用に生の数値を求めている場合は、これらのフラグを使って OHLCV 以外をすべて除外してください。 -
AI 分析には
aipa analyzeを使います：ユーザーが洞察、パターン、推奨事項を求めている場合は、代わりにaipa-analyzeスキルを使ってください。このスキルは生データ専用です。 -
日付範囲と件数の指定：特定の期間には
--start-date／--end-dateを使います。「直近N本」には--limitを使います。両方を組み合わせないでください。CLI は競合を適切に処理しますが、どちらか一方を使うほうが意図が明確です。 -
MA の種類は設定で制御されます：有効な MA の種類（SMA または EMA）は、
~/.aipriceaction/settings.jsonのuse_smaで制御されます。分析の前にaipa config get use_smaを実行して確認してください。SMA を強制するには--sma、EMA を強制するには--emaを使います。デフォルトを変更するにはaipa config set use_sma falseを実行してください。 -
複数のティッカーに対応しています：スペース区切りで複数のティッカーを渡すと、1回の呼び出しで取得できます（例：
aipa get-ohlcv-data VCB TCB MBB）。出力テーブルには行を区別するためのsymbol列が含まれます。 -
市場の概況には
aipa live-dataを使います：最も活発なティッカーを特定したり、市場全体のスナップショットを取得したりする場合は、個別のティッカーを取得する代わりにaipa live-dataを使ってください。最新のローソク足を売買代金順に返します。まず引数なしで呼び出して値動きのある銘柄を確認し、その後get-ohlcv-dataで特定のティッカーを詳しく調べてください。 -
ティッカーの確認には
aipa ticker-listを使います：利用可能なティッカーを確認したり、特定のセクターのティッカーを探したりする場合は、aipa ticker-listを使ってください。セクターで絞り込むには--group（例：銀行ならNGAN_HANG）を追加し、他のコマンドに渡すためのカンマ区切りリストを取得するには--compactを追加してください。 -
ランキングには
aipa performersを使い、複数の視点で実行します：ユーザーが市場を動かす銘柄、上昇銘柄、「何が起きているか」について尋ねた場合は、複数の--sort-by値を指定してaipa performersを実行し、多角的な視点を得てください。少なくとも次の2つは必ず実行してください：デフォルト（価格変動）と value（売買代金）。ユーザーがトレンドを重視している場合は MA スコアも追加してください。すべて実行し、1つだけを選ばないでください。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 --group NGAN_HANG --sort-by value # 売買代金で見た銀行セクター aipa performers --group CHUNG_KHOAN --sort-by close_changed # 証券セクターの上昇率上位これらのリストを照合すると、単一の並べ替えよりもはるかに豊富な洞察が得られます。上昇率上位と売買代金上位の両方に表示されるティッカーは、どちらか一方にしか表示されないものより重要です。AI エージェントは
get_performersツールを直接呼び出すこともできます。 -
出来高分析には
aipa volume-profileを使用する：取引された出来高に基づいて主要な価格水準を特定する必要がある場合は、aipa volume-profileを使用します。最も多くの出来高が取引された価格（POC）、バリューエリア、1 分足データに基づく出来高加重統計が表示されます。単日ではなく複数日にわたる期間（--start-dateと--end-dateを指定し、少なくとも 20 取引日）を優先してください。複数日にわたる期間を使うと、より信頼性の高いサポート／レジスタンス水準が得られ、日中のノイズが平滑化されます。AI エージェントはget_volume_profileツールを直接呼び出すこともできます。