JungHoonGhae/tossinvest-cli — 토스증권을 AI 에이전트·터미널에서 — 공식 Open API(예정)보다 넓은 조회·거래 범위(수급·AI시그널·스크리너·실시간 푸시·소수점 주문·dry-run preview)를 다루…

Description and use

**Summary**
JungHoonGhae /tossinvest‑cli is an unofficial Go‑based command‑line client that extends Toss Securities’ upcoming Open API, offering a richer set of market data and trading capabilities such as supply‑demand insights, AI‑generated signals, screeners, real‑time push notifications, fractional orders, and dry‑run previews. It is designed for developers and quantitative traders who want to script, back‑test, and automate their Toss‑based strategies from a terminal or AI agent.

**Value**

• **Broader functionality** than the official API, giving users access to advanced analytics (AI signals, order‑book depth) and features (fractional sizing, dry‑run previews) that are otherwise unavailable.
• **Automation‑ready**: the CLI can be integrated into scripts, CI pipelines, or AI agents, enabling end‑to‑end research, monitoring, and execution workflows without manual UI interaction.
• **Open‑source transparency**: the Go source code is auditable, extensible, and can be forked or wrapped in custom tooling, which is attractive for quantitative teams that need to verify trading logic.

**Practical adoption path**

1. **Evaluation** – Clone the repo, review the README and Go modules, and run the built‑in --help commands to explore available endpoints.
2. **Credential setup** – Configure Toss API keys or OAuth tokens as documented; the CLI stores them securely via environment variables or a config file.
3. **Proof‑of‑concept** – Write small shell or Go scripts that fetch AI signals, perform a dry‑run order, and log results; iterate on back‑testing logic using the provided preview mode.
4. **Integration** – Wrap the CLI in Docker containers or invoke it from orchestration tools (Airflow, Prefect) to embed it in larger trading pipelines or AI‑agent frameworks.
5. **Production hardening** – Add logging, rate‑limit handling, and fallback mechanisms; optionally fork the repo to pin dependencies and apply internal security reviews.

**Production readiness**

• **Activity & community**: Recent commits (as of 2026‑06‑23), 68 forks, and an active issue/PR flow indicate a healthy maintainer presence.
• **Maturity**: The CLI already implements critical trading functions (order preview, fractional sizing) and provides real‑time push support, reducing the need for custom wrappers.
• **Risk considerations**: The project lacks a formal license declaration and has not undergone a third‑party security audit; organizations should verify licensing compliance and perform a security review before deploying in live environments.
• **Overall**: With the above checks completed, the tool is a strong OSS candidate for pilot projects and can be promoted to production for automated Toss‑based trading workflows.

Problem

JungHoonGhae/tossinvest-cli helps research and automate market workflows.

Outcome

High for an OSS candidate: recent activity, adoption, and ecosystem signals are strong enough for a serious pilot.

Workflow

• research trading systems
• backtest strategies
• monitor market workflows

Evidence

토스증권을 AI 에이전트·터미널에서 — 공식 Open API(예정)보다 넓은 조회·거래 범위(수급·AI시그널·스크리너·실시간 푸시·소수점 주문·dry-run preview)를 다루는 비공식 CLI

Source