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 derived per call from the latest bar vs the latest tick and echoed as server_utc_offset_hours — if it cannot be derived (or falls outside +/-14h) 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 the tick or M1 offset-derivation data isn't usable yet (e.g. the EA just connected), false means an offset was derived but 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"
  }
}