tossctl
가이드

설정

설정 파일 안내

설정 파일 위치는 OS별 사용자 설정 디렉터리이며, tossctl config status 로 경로와 현재 상태를 확인할 수 있습니다.

tossctl config status

주요 항목

{
  "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
  }
}
키설명
trading.place·cancel·amend·conditional각 주문 경로 허용 여부
trading.sellplace가 켜진 상태에서 매도까지 허용
trading.fractionalplace가 켜진 상태에서 미국주식 소수점 주문 허용
trading.allow_live_order_actions모든 실계좌 주문의 마스터 킬스위치
trading.dangerous_automation.accept_fx_consentWTS 미국주식 KRW 매수 prepare 후 환전 동의만 자동 수락. 주문별 execute·confirm은 생략하지 않음
openapi.enabled·prefer·fallback공식 경로 활성화·시작 경로·지원 조회의 WTS 폴백. 주문은 교차 폴백하지 않음
openapi.account_seq공식 API 계좌 순번. 0 이면 계좌가 하나일 때만 자동 선택하고, 여러 개면 주문을 거절하고 조회는 WTS 로 폴백. 순번은 tossctl openapi status 로 확인
update_check.enabled새 버전 알림 on/off. 최신 버전은 6시간마다 확인하고 안내는 하루 한 번. 표 출력 명령 끝에 stderr 로, MCP 는 시작 지침과 실행 중 나온 새 버전을 도구 응답에 한 번 덧붙여 알림. JSON/CSV 출력은 오염시키지 않음
experimental.paper_trading롤아웃 중인 미국 옵션 모의투자 CLI·ops/MCP·전용 probe 노출. 기본 false

모의투자는 다음 명령으로 명시적으로 옵트인합니다.

tossctl config experimental paper-trading --enable

모의 원장 쓰기는 기본 preview이며 --execute가 있어야 적용됩니다. 실계좌 config나 confirm token을 재사용하지 않으며, paper order live-preview도 실주문을 제출하지 않습니다.

  • 스키마 버전은 자동 관리되며, 오래된/사용되지 않는 항목이 있으면 실행 시 한 줄 안내가 나오고 config status·doctor 가 표시합니다.
  • trading.grant는 제거된 legacy 키이며 남아 있어도 무시됩니다.
  • 설정 스키마(JSON Schema)는 저장소의 schemas/config.schema.json 에 있습니다.

진단

tossctl doctor            # 사람용 점검
tossctl doctor --report   # JSON 진단 (홈 경로 마스킹, 이슈 첨부용)

거래 보호 장치는 안전 모델에서 자세히 다룹니다.

On this page