blofin-portfolio-analyst

BloFin ポートフォリオアナリスト

取引実績を分析し、取引履歴を確認し、PnL 指標を算出して、ポートフォリオレポートを作成します。

主な分析ワークフロー

1. ポートフォリオのスナップショット

ユーザーの現在のポートフォリオ状況を包括的にまとめます。

1. get_balance で口座残高を取得 — 総資産、有効証拠金、未実現 PnL
2. get_positions ですべてのポジションを取得 — 建値、サイズ、PnL を含む保有中のポジション
3. 保有している各銘柄について、get_tickers で現在価格を取得
4. 以下を算出して提示します。
   • ポートフォリオの総額（資産）
   • 未実現 PnL（絶対額と割合）
   • ポジションごとの内訳：銘柄、売買方向、サイズ、建値、現在価格、PnL、PnL%
   • 利用可能証拠金と証拠金使用率
   • 最も利益が大きいポジションと最も損失が大きいポジション

プロンプトの例：

• 「ポートフォリオの概要を教えてください」
• 「ポートフォリオの状況はどうですか？」
• 「合計 PnL はいくらですか？」

---

2. 取引履歴の分析

過去の取引を確認し、パフォーマンス指標を算出します。

1. get_fills_history で約定履歴を取得 — 約定価格を含む最近の取引
2. get_order_history で注文履歴を取得 — キャンセル済みの注文を含むすべての過去の注文
3. 以下を分析して提示します。
   • 期間内の総取引数
   • 勝率（fillPnl がプラスの取引数 ÷ 決済取引の総数）
   • 平均利益額と平均損失額（プロフィットファクター）
   • 取引頻度の高い銘柄
   • 取引頻度のパターン

get_fills_history のパラメーター：

パラメーター	型	必須	説明
instId	String	いいえ	銘柄で絞り込みます
orderId	String	いいえ	注文で絞り込みます
before / after	String	いいえ	tradeId によるページネーション
begin / end	String	いいえ	タイムスタンプ（ms）で絞り込みます
limit	String	いいえ	最大 100 件、デフォルトは 20 件

約定レスポンスの主なフィールド： instId、fillPrice、fillSize、fillPnl、positionSide、side、fee、ts。

プロンプトの例：

• 「過去 7 日間の取引履歴を表示してください」
• 「BTC-USDT の勝率はどのくらいですか？」
• 「今月の取引実績を分析してください」

---

3. PnL の内訳

損益を詳細に分析します。

1. 実現 PnL — get_fills_history から取得し、すべての決済取引の fillPnl を合計します
2. 未実現 PnL — get_positions から取得した現在の unrealizedPnl
3. 支払った手数料 — get_fills_history から取得し、fee フィールドを合計します
4. 純 PnL = 実現 PnL + 未実現 PnL - 手数料の合計
5. 銘柄ごとの PnL テーブルを提示します

プロンプトの例：

• 「銘柄ごとの PnL の内訳を教えてください」
• 「手数料はいくら支払いましたか？」
• 「手数料を差し引いた純利益はいくらですか？」

---

4. 現物取引履歴（該当する場合）

現物市場でも取引するユーザー向けです。

現物取引専用のエンドポイントで get_fills_history を使用します。

• エンドポイント：GET /api/v1/spot/trade/fills-history
• instType: "SPOT" が必要です

プロンプトの例：

• 「現物取引の履歴を表示してください」
• 「現物と先物の実績を比較してください」

---

5. パフォーマンスレポートの作成

構成化された取引パフォーマンスレポートを作成します。

When asked for a report, compile data from multiple sources and present
a well-formatted summary with tables and key metrics.

レポートのテンプレート：

📈 BloFin Trading Report
========================
Period: [start_date] to [end_date]

## Account Summary
- Total Equity: $XXX
- Available Balance: $XXX
- Margin Usage: XX%

## Open Positions
| Instrument | Side | Size | Entry | Current | PnL | PnL% |
|------------|------|------|-------|---------|-----|------|

## Performance Metrics
- Total Trades: XX
- Win Rate: XX%
- Average Win: $XX
- Average Loss: $XX
- Profit Factor: X.XX
- Total Fees: $XX
- Net Realized PnL: $XX

## Top Performers
- Best trade: [instrument] +$XX
- Worst trade: [instrument] -$XX

プロンプトの例：

• 「今週の取引レポートを作成してください」
• 「詳細なパフォーマンス分析をお願いします」
• 「取引活動の概要を作成してください」

分析ガイドライン

1. PnL の計算には必ず手数料を含めます。手数料は実際のリターンに大きく影響します。
2. タイムスタンプを使って、ユーザーが指定した期間にデータを絞り込みます。
3. ページネーションに対応します。レコードが 100 件を超える場合は、before / after パラメーターを使って複数回リクエストします。
4. 数値を明確に示します。通貨形式や割合を使い、利益と損失が区別できるように色分けの文脈を付けます。
5. 建値と比較します。絶対値だけでなく、建値に対する PnL を必ず示します。
6. データの制限事項を伝えます。約定履歴は最近のデータに限られる場合があるため、指定期間のデータが取得可能な範囲を超える場合はユーザーに知らせます。