toss-securities

JungHoonGhae/tossinvest-cli 의 tossctl 바이너리를 감싸는 read-only tossctl wrapper 입니다. 이 패키지는 설치/로그인/조회 흐름만 정리하고, 거래 mutation 은 공개 API에서 지원하지 않습니다.

Install

먼저 upstream CLI 를 설치합니다.

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

그 다음 배포된 패키지를 설치합니다.

npm install toss-securities

Supported read-only helpers

listAccounts()
getAccountSummary()
getPortfolioPositions()
getPortfolioAllocation()
getQuote(symbol)
getQuoteBatch(symbols)
listOrders()
listCompletedOrders({ market })
listWatchlist()

모든 helper 는 내부적으로 tossctl ... --output json 을 실행하고, commandName, bin, args, data 를 반환합니다.

대응되는 대표 CLI 는 tossctl account summary --output json, tossctl quote get TSLA --output json, tossctl watchlist list --output json 입니다.

Usage

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

async function main() {
  const summary = await getAccountSummary({
    configDir: "/Users/me/.config/tossctl"
  });
  const quote = await getQuote("TSLA");
  const watchlist = await listWatchlist();

  console.log(summary.data);
  console.log(quote.data);
  console.log(watchlist.data);
}

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

What is intentionally not supported

tossctl order place
tossctl order cancel
tossctl order amend
permission grant/revoke

이 패키지는 조회 전용이다. 실거래에 영향을 주는 명령은 upstream safety gate 를 우회하지 않도록 래핑하지 않는다.