toss-sync

Synchronize Toss Securities portfolios into a local tracker via Toss Open API or tossctl CLI.

2|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/k1064190/stock-expectation --skill toss-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: toss-sync
Source: https://github.com/k1064190/stock-expectation/tree/main/.claude/skills/toss-sync
Command: npx skills add https://github.com/k1064190/stock-expectation --skill toss-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires toss_openapi, tossctl, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill syncs your Toss Securities portfolio into your local portfolio tracker, eliminating the need for manual updates and reducing errors.

Core Features & Use Cases

  • Portfolio Sync: Automates the process of syncing your Toss Securities portfolio into your local tracker.
  • Fallback Mechanism: Utilizes the Toss Open API as the default source with a fallback to tossctl CLI if API credentials are not configured.
  • Optional Evaluation: Provides the option to evaluate the synced portfolio post-sync using various commands.

Quick Start

To sync your Toss Securities portfolio, run the following command: ./bin/stock-cli portfolio sync

Frequently Asked Questions about toss-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync my Toss Securities portfolio with a local tracker?

This Skill syncs your Toss Securities portfolio into your local tracker by running the `./bin/stock-cli portfolio sync` command. It automates data synchronization to eliminate manual updates and reduce tracking errors.

Can I sync my portfolio if I haven't configured the Toss Open API credentials?

Yes, you can sync your portfolio without Toss Open API credentials by using the `tossctl` CLI as a fallback mechanism. The Skill defaults to the Open API but automatically switches to the CLI if credentials are not configured in your environment.

Does portfolio synchronization support both Korean and US stock markets?

Yes, portfolio synchronization supports both KR and US portfolios. The Skill handles the data structures for both Korean and US markets, ensuring your local tracker accurately reflects your entire Toss Securities portfolio across different regions.

Do I need to set up a specific environment configuration before syncing?

Yes, you need to configure a `.env` file with your API credentials before syncing. This environment configuration is required for the Toss Open API to authenticate and securely retrieve your portfolio data for the local tracker.

What's the best way to evaluate my portfolio after synchronization?

The best way to evaluate your synced portfolio is by using the provided evaluation commands. After running the synchronization process, the Skill offers optional post-sync evaluation tools that allow you to analyze your updated local portfolio data.

What should I do if my portfolio sync is not working?

If your portfolio sync is not working, verify your `.env` configuration for API credentials. If the Toss Open API fails, ensure the `tossctl` CLI fallback is properly installed and accessible, as the Skill depends on these components for data retrieval.