tossctl
Guide

Configuration

Config file reference

The config file lives in your OS user config directory. Check the path and current state with tossctl config status.

tossctl config status

Key fields

{
  "schema_version": 5,
  "trading": {
    "place": false,
    "sell": false,
    "fractional": false,
    "cancel": false,
    "amend": false,
    "conditional": false,
    "allow_live_order_actions": false,
    "dangerous_automation": {
      "accept_fx_consent": false
    }
  },
  "update_check": {
    "enabled": true
  },
  "openapi": {
    "enabled": true,
    "prefer": "auto",
    "fallback": true,
    "account_seq": 0
  },
  "experimental": {
    "paper_trading": false
  }
}
KeyDescription
trading.place·cancel·amend·conditionalEnable each order path
trading.sellAllow sells when place is also enabled
trading.fractionalAllow US fractional orders when place is also enabled
trading.allow_live_order_actionsMaster kill switch for every live-account order
trading.dangerous_automation.accept_fx_consentAccept only post-prepare FX consent for supported WTS US-stock KRW buys; never skips order execute/confirm
openapi.enabled·prefer·fallbackOfficial routing, starting preference, and eligible read fallback to WTS; never cross-backend order retry
openapi.account_seqOfficial API account sequence. 0 auto-selects only when there is a single account; with several, orders are refused and reads fall back to WTS. Find the sequence with tossctl openapi status
update_check.enabledNew-version notice on/off. Checks the latest version every 6 hours and notifies at most once a day: on stderr after table-output commands; for MCP, in the initialize instructions and once on a tool result when a release lands while the server runs. Never pollutes JSON/CSV output
experimental.paper_tradingExpose the rolling-out US-options paper CLI, ops/MCP operations, and dedicated probes. Default false

Opt in explicitly:

tossctl config experimental paper-trading --enable

Paper-ledger writes preview by default and apply only with --execute. They do not reuse live account config or confirm tokens, and paper order live-preview never submits a live order.

  • The schema version is managed automatically; outdated/unused keys trigger a one-line notice at runtime and show up in config status / doctor.
  • trading.grant is a removed legacy key and is ignored if it remains in an old file.
  • The config JSON Schema lives at schemas/config.schema.json.

Diagnostics

tossctl doctor            # human check
tossctl doctor --report   # JSON diagnostic (home paths masked, for issues)

Trade guardrails are detailed in the Safety Model.

On this page