取引履歴取得

read-only · idempotent

最近クローズされた取引を、損益・継続時間・クローズ理由・任意の集計統計とともに表示します。

インメモリのリングバッファから取引を返します(最新 200 件まで)。

注意: この MCP サーバーセッションを通じてクローズされたポジションのみを記録します。 cTrader UI や他のツールでクローズされた取引は記録されません。 履歴はサーバー再起動でリセットされます。永続的な記録にはジャーナル(trades.jsonl)を使用してください。

パラメータ:

• symbol: 任意のシンボルフィルタ(例: “EURUSD”)。すべての取引を取得する場合は省略します。
• limit: 返す最新取引の数(1〜200、デフォルト 20)。
• includeStats: true の場合、勝率、プロフィットファクター、平均勝ち/負け、ベスト/ワーストトレード、 シンボル別内訳などの集計統計を含めます。

レスポンスフィールド(取引ごと):

• positionId、symbol、side(BUY/SELL)
• volume、entryPrice、exitPrice、realizedPnL(USD 建て)、realizedPnLRaw(クォート通貨建て)
• quoteCurrency、pnlCurrency、conversionRate(rawPnL × rate = usdPnL)
• openedAt、closedAt(ISO 8601)、durationMs
• closeReason: STOP_LOSS、TAKE_PROFIT、MANUAL、CLOSE_ALL、OCO、UNKNOWN
• closingClOrdId: ポジションをクローズした注文
• linkedOrders: クローズ時にアクティブだった SL/TP 注文のスナップショット

統計(includeStats=true の場合):

• totalTrades、winningTrades、losingTrades、breakeven
• winRate(0.0〜1.0)、totalPnL、avgWin、avgLoss
• profitFactor(総利益 / 総損失、損失なしの場合は Infinity)
• bestTrade、worstTrade(positionId + symbol + pnl)
• avgDurationMs
• bySymbol: シンボル別の取引数、損益、勝率

これは読み取り専用の操作であり、リスクチェックはありません。

パラメータ

パラメータ	型	必須	説明
symbol	string	いいえ	シンボルでフィルタ(例: ‘EURUSD’)。すべてを取得する場合は省略します。
limit	number	いいえ	返す最新取引の数(1〜200、デフォルト 20)。デフォルト: 20。
includeStats	boolean	いいえ	集計統計(勝率、損益、プロフィットファクター)を含めます。デフォルト: false。