Toss Securities

このスキルが行うこと

JungHoonGhae/tossinvest-cli の tossctl を利用して Toss Securities の読み取り専用(read-only) フローを実行する。

• アカウントリスト / サマリー
• ポートフォリオ保有銘柄 / ウェイト
• 単一銘柄 / 複数銘柄の相場
• 未決済注文 / 月間決済履歴
• ウォッチリスト銘柄

使用する場面

• 「Toss Securities のアカウントサマリーを表示して」
• 「Toss Securities の TSLA の相場を確認して」
• 「ウォッチリストを表示して」
• 「今月の決済履歴を確認して」

必要条件

• macOS + Homebrew
• tossctl のインストール
• tossctl auth login でブラウザセッションを確保
• Node.js 18+

ワークフロー

0. 必要な場合はまず tossctl をインストール

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

ログインセッションがない場合は、まず上記のフローを完了する。非公式なクローリングや任意の HTTP 再実装での回避は行わない。

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

2. スクリプト作成時はローカルパッケージラッパーを使用

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. 慎重に回答する

• アカウント番号や機密情報は必要最小限の範囲のみ公開する。
• ユーザーが「今日」などの相対日付を言う場合は、絶対日付に変換して回答する。
• このスキルは読み取り専用である。実際の取引 mutation はスコープ外であることを明確に述べる。

完了条件

• tossctl のインストール/ログイン状態が確認された。
• リクエストに対応する読み取り専用コマンドを実行した。
• 結果を日本語で簡潔にまとめた。

失敗モード

• tossctl auth login 前はアカウント/ポートフォリオ照会に失敗する可能性がある。
• アップストリームの Web API 構造が変わると、tossctl 自体の更新が必要になる可能性がある。
• アカウント/注文情報は機密情報のため、出力範囲を過度に広げない。