mirror of https://github.com/NomaDamas/k-skill.git synced 2026-06-24 02:04:11 +00:00

Jeffrey (Dongkyu) Kim 2700e426a9 Add a safe Toss Securities lookup surface without trading mutations

Wrap the upstream tossinvest-cli binary behind a small read-only Node package,
add the matching skill/docs wiring, and lock the behavior with regression tests plus
publish/release metadata so the new workspace stays release-ready.

Constraint: Issue #25 required using JungHoonGhae/tossinvest-cli rather than reimplementing Toss APIs directly
Constraint: The public package surface must stay read-only and avoid wrapping trading mutations
Rejected: Direct HTTP client against unofficial Toss endpoints | issue explicitly required the upstream CLI and would widen maintenance risk
Rejected: Skill docs only with no package wrapper | repo convention is to ship reusable package + docs + release wiring together
Confidence: high
Scope-risk: moderate
Reversibility: clean
Directive: Keep toss-securities limited to read-only tossctl commands unless a future issue explicitly approves trading flows and adds stronger safeguards
Tested: npm run ci; brew tap JungHoonGhae/tossinvest-cli && brew install tossctl && tossctl version; node smoke calling packages/toss-securities/src/index.js getQuote('TSLA'); lsp diagnostics on affected files
Not-tested: Authenticated account/portfolio/order-history commands against a real Toss session

2026-03-30 11:25:43 +09:00

2.4 KiB

Raw Permalink Blame History

토스증권 조회 가이드

이 기능으로 할 수 있는 일

tossctl 기반 토스증권 계좌 목록 / 계좌 요약 조회
포트폴리오 보유 종목 / 자산 비중 조회
단일 종목 / 다중 종목 시세 조회
미체결 주문 / 월간 체결 내역 조회
관심종목 목록 조회

먼저 필요한 것

macOS + Homebrew
tossctl 설치
tossctl auth login 으로 브라우저 세션 확보
node 18+

upstream 설치와 로그인

이 기능은 JungHoonGhae/tossinvest-cli 의 tossctl 을 그대로 사용한다.

brew tap JungHoonGhae/tossinvest-cli
brew install tossctl
tossctl doctor
tossctl auth doctor
tossctl auth login

로그인이 끝나기 전에는 계좌/포트폴리오 조회를 시도하지 않는다.

지원하는 read-only 명령

tossctl account list --output json
tossctl account summary --output json
tossctl portfolio positions --output json
tossctl portfolio allocation --output json
tossctl quote get TSLA --output json
tossctl quote batch TSLA 005930 VOO --output json
tossctl orders list --output json
tossctl orders completed --market all --output json
tossctl watchlist list --output json

Node.js 예시

const {
  getAccountSummary,
  getPortfolioPositions,
  getQuote,
  listCompletedOrders
} = require("toss-securities");

async function main() {
  const summary = await getAccountSummary();
  const positions = await getPortfolioPositions();
  const quote = await getQuote("TSLA");
  const completed = await listCompletedOrders({ market: "all" });

  console.log(summary.data);
  console.log(positions.data);
  console.log(quote.data);
  console.log(completed.data);
}

main().catch((error) => {
  console.error(error);
  process.exitCode = 1;
});

운영 팁

계좌 요약과 포트폴리오는 로그인 세션이 있어야만 동작한다.
TSLA, VOO, 005930 같이 심볼을 그대로 넘기면 된다.
주문 관련 답변은 조회 결과만 정리하고, 실거래로 이어지는 행동은 권하지 않는다.
민감한 계좌 정보는 꼭 필요한 값만 답한다.

주의할 점

tossctl 은 비공식 CLI 이므로 웹 내부 API 변경에 영향을 받을 수 있다.
브라우저 세션이 만료되면 tossctl auth login 을 다시 해야 할 수 있다.
이 레포의 toss-securities 패키지는 read-only wrapper 이며, 거래 mutation 명령은 공개 API에 포함하지 않는다.

2.4 KiB Raw Permalink Blame History