가이드
설정
설정 파일 안내
설정 파일 위치는 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.sell | place가 켜진 상태에서 매도까지 허용 |
trading.fractional | place가 켜진 상태에서 미국주식 소수점 주문 허용 |
trading.allow_live_order_actions | 모든 실계좌 주문의 마스터 킬스위치 |
trading.dangerous_automation.accept_fx_consent | WTS 미국주식 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 진단 (홈 경로 마스킹, 이슈 첨부용)거래 보호 장치는 안전 모델에서 자세히 다룹니다.