Session Mode

Overview

Session Mode includes 2 tools for this workflow area.

Available tools: get_mode, set_mode.

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

get_mode

Returns the session's current trading mode and the dry_run resolution rule in force, so a caller can verify the paper clamp's guarantee without reading documentation. Available at Free+ tier.

Parameters

No parameters.

Example Request

{
  "tool": "get_mode",
  "arguments": {}
}

set_mode

Sets the session's trading mode. 'paper' installs a clamp: every trading tool's resolved dry_run is forced to true for the rest of this session, even when dry_run:false is passed, and responses carry mode_clamped:true. 'live' (the default) removes the clamp and changes nothing else — dry_run still defaults to true on every call and an explicit dry_run:false still executes; live grants no additional execution rights and is not a confirmation to trade. Mode is per-session and in-process — it resets to live (the safe default) if the session is lost. Available at Free+ tier.

Parameters

Example Request

{
  "tool": "set_mode",
  "arguments": {
    "mode": "mode_value"
  }
}