toss-investment

Queries Toss Securities accounts, holdings, quotes, and orders via the official OAuth2 Open API.

7.4k|904|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/NomaDamas/k-skill --skill toss-investment
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: toss-investment
Source: https://github.com/NomaDamas/k-skill/tree/main/toss-investment
Command: npx skills add https://github.com/NomaDamas/k-skill --skill toss-investment

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It lets you check your Toss Securities account balances, stock holdings, real-time quotes, and pending orders through the official Open API without manual app navigation or unofficial scraping.

Core Features & Use Cases

  • Account & Holdings Lookup: List accounts and view held stocks using OAuth2 Client Credentials against openapi.tossinvest.com.
  • Market Data Queries: Fetch current prices, order books, candles, exchange rates, and KR/US market calendars.
  • Order Status Checks: Inspect pending orders, order details, buyable amounts, sellable quantities, and fees in a strictly read-only flow.
  • Use Case: Ask "토스증권 삼성전자 현재가 확인해줘" and get the current Samsung Electronics price, or review your portfolio holdings and pending orders in one request.

Quick Start

Set the TOSSINVEST_CLIENT_ID and TOSSINVEST_CLIENT_SECRET environment variables, then ask the agent to show my Toss Securities holdings and the current price of Samsung Electronics.

Frequently Asked Questions about toss-investment

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

FAQPage Schema
How do I check my Toss Securities holdings with the official API?

Set TOSSINVEST_CLIENT_ID and TOSSINVEST_CLIENT_SECRET from the Toss Securities OpenAPI console, then call the holdings helper with your accountSeq. The helper obtains an OAuth2 Client Credentials token and queries openapi.tossinvest.com directly.

What data can the Toss Securities Open API provide?

It provides account lists, held stocks, current prices, order books, trades, candles, stock info, exchange rates, KR/US market calendars, pending orders, order details, buyable amounts, sellable quantities, and fees.

Can this skill place or cancel stock orders?

No. The skill is strictly read-only and only supports query endpoints. Any real trading mutation is explicitly out of scope and the skill states it is unsupported rather than attempting it.

What happens without Toss Securities API credentials?

The helper fails with a TossCredentialsError and tells you which environment variables are required. It never bypasses the official API with unofficial CLIs, session reuse, or crawling.

How are rate limits and token expiry handled?

On HTTP 429 the helper waits for the Retry-After or X-RateLimit-Reset window before backing off and retrying. On HTTP 401 it reissues the OAuth token once and retries the request.