Skip to main content

GetJournalTrades (Matched Trade Journal)

Returns the CrossTrade matched-trade journal: entries and exits matched into round-trip trades with realized P&L, setup tags (when configured), and timing.

This is the engine behind every "talk to my trading history" workflow.

PropertyValue
Required scopemcp:read
RiskNone. Read-only.
Side effectsNone.

When an agent should use it​

  • End-of-session and weekly reviews.
  • Setup decay or expectancy analysis.
  • "What were my biggest losers last week?"
  • Funded account post-session audits.

When an agent should not use it​

  • For live order or position state. Use ListPositions / ListOrders.

Parameters​

{
  "from": "2026-04-01T00:00:00Z",
  "to": "2026-05-15T00:00:00Z",
  "account": "APEX1234",
  "instrument": "MES",
  "limit": 200
}

Many filters are optional. The journal supports filtering by account, instrument, and time range.

Response shape​

{
  "trades": [
    {
      "id": "j-9001",
      "entry_ts": "2026-05-14T13:31:02Z",
      "exit_ts": "2026-05-14T13:42:50Z",
      "account": "APEX1234",
      "instrument": "MES 06-26",
      "side": "Long",
      "quantity": 1,
      "entry_price": 5240.25,
      "exit_price": 5244.50,
      "realized_pnl": 21.25,
      "fees": 1.27,
      "setup": "morning_breakout"
    }
  ]
}

Example user prompt​

Pull the last 20 closed trades on APEX1234. Group by instrument, sum realized P&L,
show win rate, average win, average loss, and the three biggest losers. Do not
expose the account number in the summary. Do not place anything.

Example tool call​

{
  "name": "GetJournalTrades",
  "arguments": {
    "account": "APEX1234",
    "limit": 20
  }
}

Common errors​

SymptomLikely causeFix
Empty tradesNo matched trades in the range.Widen the range.
Missing setup tagsTags not configured.Tag setups in CrossTrade Journal or skip this field.
addon_disconnectedAdd-on side is down (matched trades depend on execution feed).Open NT8.

Safe workflow placement​

The journal is the safest place for an AI agent to learn about the user's trading. Pair with:

GetJournalTrades  +  GetSignalHistory  +  GetActivityLog

to explain why trades happened, not just what happened.

Privacy​

The journal contains real account identifiers, fills, and P&L. When the agent produces a summary for sharing or for a screen recording, the agent must redact account numbers and broker identifiers.