Back to Details

toss-securities

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Toss Securities

Toss证券

What this skill does

技能功能

JungHoonGhae/tossinvest-cli
의 
tossctl
을 이용해 토스증권 조회 전용(read-only) 흐름을 실행한다.
  • 계좌 목록 / 요약
  • 포트폴리오 보유 종목 / 비중
  • 단일 종목 / 다중 종목 시세
  • 미체결 주문 / 월간 체결 내역
  • 관심 종목
使用
JungHoonGhae/tossinvest-cli
的
tossctl
执行Toss证券**只读（read-only）**查询流程。
  • 账户列表 / 摘要
  • 投资组合持仓股票 / 占比
  • 单只股票 / 多只股票行情
  • 未成交订单 / 月度成交记录
  • 关注股票

When to use

适用场景

  • "토스증권 계좌 요약 보여줘"
  • "토스증권 TSLA 시세 확인해줘"
  • "관심종목 목록 보여줘"
  • "이번 달 체결 내역 조회해줘"
  • "给我展示Toss证券账户摘要"
  • "帮我查询Toss证券TSLA的行情"
  • "给我看下关注股票列表"
  • "查询本月的成交记录"

Prerequisites

前置条件

  • macOS + Homebrew
  • tossctl
    설치
  • tossctl auth login
    으로 브라우저 세션 확보
  • Node.js 18+
  • macOS + Homebrew
  • 已安装
    tossctl
  • 通过
    tossctl auth login
    获取浏览器会话
  • Node.js 18+

Workflow

工作流程

0. Install 
tossctl
first when missing

0. 若缺少
tossctl
请先安装

bash
brew tap JungHoonGhae/tossinvest-cli
brew install tossctl
tossctl doctor
tossctl auth doctor
tossctl auth login
로그인 세션이 없으면 먼저 위 흐름을 끝낸다. 다른 비공식 크롤링이나 임의 HTTP 재구현으로 우회하지 않는다.
bash
brew tap JungHoonGhae/tossinvest-cli
brew install tossctl
tossctl doctor
tossctl auth doctor
tossctl auth login
如果没有登录会话，请先完成上述流程，请勿使用其他非官方爬虫或自行重构HTTP请求的方式绕过。

1. Prefer the read-only 
tossctl
surface

1. 优先使用只读的
tossctl
接口

지원하는 기본 명령:
  • 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
支持的基础命令：
  • 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

2. Use the local package wrapper when scripting helps

2. 需要编写脚本时使用本地包封装

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

async function main() {
  const summary = await getAccountSummary();
  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;
});
js
const {
  getAccountSummary,
  getQuote,
  listWatchlist
} = require("toss-securities");

async function main() {
  const summary = await getAccountSummary();
  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;
});

3. Answer conservatively

3. 保守输出内容

  • 계좌번호/민감정보는 꼭 필요한 범위만 노출한다.
  • 사용자가 "오늘" 같은 상대 날짜를 말하면 절대 날짜로 풀어 답한다.
  • 이 스킬은 조회 전용이다. 실거래 mutation 은 범위 밖이라고 분명히 말한다.
  • 仅在必要范围内暴露账号/敏感信息
  • 用户提到「今天」这类相对日期时，转换为绝对日期答复
  • 本技能仅支持查询功能，需明确告知实际交易操作不在支持范围内

Done when

完成标准

  • tossctl
    설치/로그인 상태가 확인되었다.
  • 요청에 맞는 read-only 명령을 실행했다.
  • 결과를 한국어로 짧게 정리했다.
  • 已确认
    tossctl
    安装/登录状态正常
  • 已执行符合请求的只读命令
  • 已将结果用韩语简要整理

Failure modes

故障场景

  • tossctl auth login
    전이면 계좌/포트폴리오 조회가 실패할 수 있다.
  • upstream 웹 API 구조가 바뀌면 
    tossctl
    자체 업데이트가 필요할 수 있다.
  • 계좌/주문 정보는 민감하므로 출력 범위를 과도하게 넓히지 않는다.
  • 未执行
    tossctl auth login
    时，账户/投资组合查询可能失败
  • 上游网页API结构变更时，需要更新
    tossctl
    本身
  • 账户/订单信息属于敏感信息，请勿过度扩大输出范围