An AI coding agent skill for executing Korean stock trades and managing portfolios via the Korea Investment & Securities (KIS) Open API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install kis-trading
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install kis-trading using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is KIS Trading?
The KIS Trading skill is a comprehensive financial integration designed for the KRX market (KOSPI and KOSDAQ). By utilizing the Korea Investment & Securities (KIS) Open API, this skill allows users to perform critical financial operations such as balance inquiries, real-time price monitoring, and trade execution directly within an AI-driven workflow.
This Openclaw Skills component bridges the gap between raw financial data and actionable trading strategies. It provides a structured interface for managing assets, checking profit margins, and tracking market trends, making it an essential tool for developers building automated trading bots or personal finance assistants.
KIS Trading Use Cases
- Checking real-time account balances and available cash for trading.
- Retrieving live stock quotes and market data for specific KRX stock codes.
- Executing market or limit buy/sell orders with mandatory safety confirmations.
- Monitoring portfolio performance and calculating investment returns.
- Tracking market-wide trends such as volume rankings and major indices.
How KIS Trading Works
- The skill initializes by reading API credentials from a local configuration file.
- It establishes a secure connection to the Korea Investment & Securities Open API servers.
- Upon user request, the skill fetches requested data (like quotes or balance) or prepares a trade order payload.
- For trading operations, the skill presents a summary to the user and awaits explicit confirmation to prevent accidental trades.
- Once confirmed, the order is transmitted to the exchange, and the execution results are returned to the user interface.
KIS Trading Setup
First, ensure you have the necessary dependencies installed:
pip install requests
Create a configuration file at ~/.kis-trading/config.ini with your API credentials:
[KIS]
APP_KEY = your_app_key
APP_SECRET = your_app_secret
ACCOUNT_NO = 12345678-01
BASE_URL = https://openapi.koreainvestment.com:9443
Verify the setup using the provided script:
python3 scripts/setup.py --config ~/.kis-trading/config.ini --check
KIS Trading Data Schema & Taxonomy
The skill manages data across several key domains to ensure accurate trading and reporting:
| Category | Metadata Fields | Description |
|---|---|---|
| Account | Balance, Cash, Profit Ratio | Current financial standing and liquidation value. |
| Market | Stock Code, Price, Volume | Real-time data from KOSPI and KOSDAQ. |
| Orders | Side (Buy/Sell), Qty, Type | Parameters for executing market or limit orders. |
| History | Date, Execution Price, Status | Log of past transactions for auditing and analysis. |
KIS Trading Advanced Features
- Support for both real-world trading and virtual mock investment environments via URL switching.
- Integrated safety mechanism requiring user confirmation for every financial transaction.
- Automated rate limiting to handle the KIS API constraint of 20 requests per second.
- Dry-run capability to preview trade details without committing funds.
- Comprehensive market overview tools including index tracking and volume leaderboards.
SKILL.md
Loading
Related Openclaw Skills
Test Audit Badge
A specialized demonstration skill designed to showcase and verify the audit badge functionality within the environment.
Clawcast EVM Wallet Manager
A comprehensive toolset for managing EVM wallets and executing blockchain transactions directly through an AI agent via Foundry cast.
Clawbrowser
A terminal-driven browser automation skill that allows AI agents to navigate the web, interact with elements, and manage persistent sessions via Playwright CLI.
clawaudit
An automated security checker designed to perform comprehensive audits on code repositories.
Symbolic Memory
A stateless symbolic memory workflow that stores facts in PostgreSQL and activates semantics just-in-time for Ollama-powered LLM agents.
LocalSquare: AI-Driven Local Business Advertising
LocalSquare allows AI agents to claim and pay for permanent digital bulletin board advertisements for local businesses across 43,000+ ZIP codes.
Featured*
