OpenClaw Skills Hub#
KuCoin Skills Hub is a public skills repository for OpenClaw that enables AI agents to access KuCoin exchange data through reusable, domain-based OpenClaw skills. The current implementation is based on the KuCoin Classic REST API and provides read-only access only.Each skill is packaged as a standard OpenClaw skill and can be installed into an OpenClaw workspace, where it becomes available to the active agent session. After installation, agents can invoke the corresponding business capabilities through skill-based prompts rather than direct REST endpoint handling.Note
All currently available skills support GET (read-only) endpoints only. State-changing operations, including order placement, order cancellation, transfers, repayments, subscriptions, redemptions, and other write actions, are not supported at this time.
Overview#
Protocol: KuCoin Classic REST API
Integration Target: OpenClaw, AI agents, LLM-powered tools
Current Repository: https://github.com/Kucoin/kucoin-skills-hub
Skill Directory#
| Skill | Business Domain | Main Capabilities |
|---|
spot | Spot Trading | Spot market data, high-frequency order queries, stop order queries, and OCO order queries |
margin-trading | Margin Trading | Cross margin data, isolated margin data, borrow history, repay history, lending data, and risk limit queries |
futures-trading | Futures Trading | Futures market data, order queries, position queries, and funding fee queries |
assets | Assets | Account balances, account ledgers, sub-accounts, deposits, withdrawals, and trading fee queries |
earn | Earn | Simple Earn product queries and Structured Earn product queries |
convert | Convert | Instant convert quotes, market order history, and limit order queries |
broker | Broker | Affiliate queries, Broker Pro queries, and ND Exchange Broker queries |
Quick Start#
Step 1. Create and enter a dedicated OpenClaw agent#
Before installing KuCoin skills, create a dedicated OpenClaw agent for the KuCoin workflow and switch into that agent's session context.After the TUI opens, switch to the dedicated KuCoin agent session:/session agent:kucoin:main
When prompted during agent creation, complete the setup flow and keep the generated workspace for KuCoin-related operations.Why create a dedicated agentCreating a dedicated kucoin agent provides a cleaner and safer installation scope for KuCoin Skills Hub:It creates an isolated KuCoin workspace instead of reusing the main agent workspace.
It keeps KuCoin-related session history separate from general-purpose conversations.
It reduces the risk of mixing demo data, installation artifacts, and KuCoin-specific rules with the user's primary agent.
It makes later management easier, including skill verification, session cleanup, and workspace-level troubleshooting.
Why switch to the dedicated agent sessionSkill installation and later KuCoin-related interactions should be performed inside the dedicated agent context, not inside the default main agent session.The following command explicitly switches the TUI to the KuCoin agent session:/session agent:kucoin:main
This ensures the next steps are executed in the KuCoin agent workspace.The main isolation boundary is the dedicated agent, not the session name itself.
A separate session such as agent:kucoin:demo can still be created later for demo or testing purposes.
If the user remains in the default main agent session, KuCoin-related installation and history may end up mixed with the main workspace.
Step 2. Install KuCoin skills#
Summary
Install a specific skill or the full KuCoin Skills Hub into the current OpenClaw workspace.
All npx skills ... commands in the following steps should be entered directly in the active OpenClaw session input box like /status session CLI.Install one specific skill, for example spot:
Install all skills into the current OpenClaw workspace:
If the installation stops at the interactive skill selector, rerun it in non-interactive mode:
Use --skill <name> when only one skill is needed.
The Skills CLI scans only the first directory level by default.
Because KuCoin Skills Hub stores each skill under skills/<name>/SKILL.md, --full-depth is required for correct skill discovery.
Without --full-depth, the repository may be cloned successfully but the installer may fail to detect all nested skill definitions.
By default, installation may stop at an interactive picker when multiple skills are discovered.
Adding --yes allows the installation to continue non-interactively.
In a project installation, skills are linked only to the current OpenClaw workspace context.
Different OpenClaw workspaces or sessions may require separate installation actions.
Step 3. Confirm the installed skill set#
Summary
A full successful installation of the current repository adds the following seven skills to the active OpenClaw workspace.assets
broker
convert
earn
futures-trading
margin-trading
spot
Step 4. Verify the installed skills#
Summary
Use this command to verify which project-level skills are currently available in the active OpenClaw workspace.
NotesThis command lists the skills currently available to the active workspace.
Run it after installation to confirm that the expected skills were discovered and linked correctly.
Step 5. Remove unnecessary skills#
Summary
Use the following commands to remove installed skills from the current project workspace.Remove installed skills interactively:Removal behavior may still involve interactive selection depending on the Session CLI flow.
In some cases, manual review of the resulting workspace state may still be required after removal.
Step 6. Review security implications before use#
Summary
Imported skills are executable capability layers inside the active agent environment, so each installed skill should be reviewed before being used in a sensitive workspace.During installation, the Skills CLI may display security or risk-assessment results.
Different scanners may produce different conclusions, including:dependency-related alerts
Because installed skills run with the effective permissions of the active agent and workspace, they should be reviewed before use in environments containing:production trading systems
other sensitive resources
Security Warning
Installed OpenClaw skills run with the effective permissions of the active agent and workspace. Review the skill contents before enabling them in environments containing API credentials, production trading systems, private data, or other sensitive resources.
Usage#
After installation, skills are used through the OpenClaw agent interface rather than as standalone shell commands.Example 1, after installing spot, an agent can be prompted with requests such as: What's the BTC price on KuCoin?
Example 2, after installing futures-trading, an agent can be prompted with requests such as: Get the Spot Index Price for the BTCUSDT contract.
In this model, the skill acts as the capability layer that maps an agent request to the corresponding KuCoin API query flow.Notes#
Skills are organized by business capability and can be installed independently.
The repository currently provides read-only integration only.
Project installation and global installation are distinct scopes.
Skill availability is tied to the OpenClaw workspace or installation scope in which the skill was installed.
The Skills Hub is intended to reduce repeated custom integration work for AI-agent-based KuCoin access.
Skill coverage may expand as additional KuCoin API capabilities are added in the future.
Modified at 2026-03-25 13:43:58