Session Analytics

Overview

Session Analytics includes 1 tool for this workflow area.

Available tools: get_session_stats.

Use the parameter tables and examples below as the canonical request contract.

get_session_stats

Historical per-session behaviour for a symbol, computed server-side from the terminal's own H1 bar history (days, default 90, max 200 -> one GET_BARS call within the 5000-bar cap). Per requested session (london, ny, asia; default all three): avg/median range in points, signed avg_drift_points, bias_up_pct, breakout_continuation_pct / reversal_pct (first-hour range broken then held vs reclaimed), and sample_days. Bars are broker server time; session windows are UTC, so the broker's server-to-UTC offset is resolved per call and echoed as server_utc_offset_hours (may be fractional, e.g. 5.5) with offset_source: "ea" (reported by the terminal's EA, works with the market closed), "cached" (the last value the EA reported for this terminal) or "derived" (latest bar vs latest tick, last resort for an EA that does not report it — unreliable on a non-UTC broker, flagged in warnings). If no source works the call fails closed with {error: "SERVER_TIME_UNKNOWN", retryable} rather than bucketing bars with a guessed offset — retryable:true (with retry_after_seconds:30 — wait before retrying, do not loop immediately) means no source was usable yet (e.g. the EA just connected), false means a derived offset falls outside +/-14h (structural, retrying will not help). Fewer than 20 sampled sessions reports insufficient_history:true instead of statistics. Each session entry echoes the UTC open/close hours of the window used, shared with get_macro_data dataset=market_sessions's live-status table (no second, competing session-boundary definition). Requires the analytics capability (Team+ tier).

Parameters

Example Request

{
  "tool": "get_session_stats",
  "arguments": {
    "symbol": "EURUSD"
  }
}