trading-upbit-skill

What This Skill Does

The trading-upbit-skill is a robust, automated trading agent specifically designed for the Upbit exchange. It facilitates an aggressive breakout trading strategy through a modular architecture that separates market monitoring from order execution. Unlike persistent bots that might lock system resources, this skill utilizes a cron-friendly design, allowing users to schedule 'run-once' jobs. It autonomously scans your watchlist or high-volume market segments, detects breakout signals, and processes them through an internal event queue stored in resources/events.json.

A key feature of this skill is its sophisticated budget management. The balance_pct_split policy allows you to define a specific percentage of your available KRW balance to be deployed, ensuring that your risk is proportional to your account size. When multiple buy signals occur simultaneously, the skill automatically divides the budget across those opportunities, maintaining healthy portfolio diversification and preventing capital concentration. It keeps track of your portfolio state in resources/positions.json, providing a clear audit trail of your automated activities.

Installation

To integrate this skill, navigate to your OpenClaw environment and use the command: clawhub install openclaw/skills/skills/kuns9/trading-upbit-skill. Before running, you must configure your environment variables. Ensure that UPBIT_OPEN_API_ACCESS_KEY and UPBIT_OPEN_API_SECRET_KEY are provided through the OpenClaw secure secret store. Always create a config.json file following the provided documentation schema, but ensure it is never committed to version control. Finally, verify your environment with node skill.js smoke_test to confirm connectivity to the Upbit API.

Use Cases

• Automated Breakout Trading: Execute trades based on momentum spikes captured in real-time volume analysis.
• Systematic Portfolio Management: Maintain a consistent percentage-based allocation of your KRW balance across multiple assets.
• Cron-based Market Monitoring: Keep a lightweight, non-blocking agent running in the background of your server to watch markets without needing an always-on memory-heavy instance.

Example Prompts

• "OpenClaw, run the monitor cycle for Upbit to check for new breakout opportunities on my watchlist."
• "Execute the pending trade worker to process all signals in the current event queue for Upbit."
• "Perform a smoke test on the Upbit skill to ensure the configuration and API keys are correctly authenticated."

Tips & Limitations

This skill is designed for advanced users who understand the risks of programmatic trading. Always initiate your configuration in dryRun mode set to true to observe behavior without real capital. Because the skill relies on local JSON files for state management, it is intended to be run from a persistent local directory. Avoid manual tampering with resources/positions.json while the worker is active to prevent synchronization errors. Remember that the skill does not include any telemetry; you are fully responsible for monitoring your own account activity and API usage limits.