Configuration

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
  },
  "experimental": {
    "paper_trading": false
  }
}

Key	Description
`trading.place`·`cancel`·`amend`·`conditional`	Enable each order path
`trading.sell`	Allow sells when `place` is also enabled
`trading.fractional`	Allow US fractional orders when `place` is also enabled
`trading.allow_live_order_actions`	Master kill switch for every live-account order
`trading.dangerous_automation.accept_fx_consent`	Accept only post-prepare FX consent for supported WTS US-stock KRW buys; never skips order execute/confirm
`openapi.enabled`·`prefer`·`fallback`	Official routing, starting preference, and eligible read fallback to WTS; never cross-backend order retry
`update_check.enabled`	New-version notice on/off (never pollutes automation output)
`experimental.paper_trading`	Expose 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.

Key fields

Diagnostics

On this page