1P by beoks | ★ favorite | 댓글 1개

토스증권 Open API를 Codex, Claude Code 같은 에이전트에서 바로 사용할 수 있도록 만든 Agent Skill입니다.

설치는 아래처럼 할 수 있습니다.

npx skills add BEOKS/tossinvest-skill  

특정 에이전트만 지정해서 설치할 수도 있습니다.

npx skills add BEOKS/tossinvest-skill --agent claude-code  

설치 후에는 에이전트가 /tossinvest-skill을 통해 토스증권 Open API 문서, OpenAPI 스키마, 작업 흐름, CLI 사용법을 참고할 수 있습니다. 저장소에는 직접 실행 가능한 CLI도 포함했습니다.

python3 scripts/tossinvest.py list-endpoints  
python3 scripts/tossinvest.py stocks --symbols 005930,AAPL  
python3 scripts/tossinvest.py prices --symbols 005930,AAPL  
  • 공식 OpenAPI JSON과 개요 문서
  • 엔드포인트/스키마 탐색용 CLI
  • TOSS_API_KEY, TOSS_SECRET_KEY 기반 OAuth 토큰 발급
  • 종목 정보, 현재가, 호가, 체결, 캔들 조회
  • KRW/USD 환율과 국내/미국 장 운영 정보 조회
  • 계좌 목록, 보유 주식, 주문 목록/상세 조회
  • 매수 가능 금액, 매도 가능 수량, 수수료 조회
  • 주문 생성/정정/취소 요청 생성

주문 관련 기능은 실수 방지를 위해 기본값을 dry-run으로 두었습니다. 실제 주문 생성, 정정, 취소는 --execute --yes를 같이 넘겨야만 실행됩니다. 주문 생성은 기본적으로 clientOrderId도 요구하게 해두었습니다.

많은 관심 부탁드립니다!

감사합니다.

댓글과 토론

올려놓고 보니 궁금한 점이 있습니다.

  • 토스증권 Open API를 쓰시는 분들은 어떤 워크플로를 자동화하고 싶으신가요?
  • Agent Skill 형태가 실제로 쓸 만한 배포 방식인지 피드백 받고 싶습니다.
  • 주문 관련 기능은 기본 dry-run으로 막아두었는데, 금융 API용 에이전트 도구에서 더 필요한 안전장치가 있을까요?

써보시다가 불편한 점이나 위험해 보이는 부분 있으면 편하게 알려주세요.