KK

kucoin/kucoin-skills-hub

Developer tools
28 stars Quality 48 Trend 33

An open skills marketplace that gives AI agents native access to the KuCoin exchange via the KuCoin OpenAPI.

Overview

An open skills marketplace that gives AI agents read-only access to the KuCoin exchange via the KuCoin Classic REST API. All skills currently support . Write operations (placing/cancelling orders, transfers, etc.) are not yet supported. The skills CLI stops scanning at the first directory level by default. Since each skill lives under skills/ /SKILL.md, --full-depth is required to discover them. - : announcements, currencies, symbols, tickers, order book (L1/L2/full), trade history, klines, call auction, fiat prices, 24hr stats, market list - : get order by ID/clientOid, open orders, closed orders, trade fills, DCP settings - : list, get by orderId/clientOid - : get by orderId/clientOid, order list, order detail - : cross/isolated margin symbols, ETF info, margin config, mark price list, collateral ratio, available inventory - : get by orderId/clientOid, open orders (by symbol), closed orders, trade fills - : list, get by orderId/clientOid - : get by orderId/clientOid, order list,...

README

KuCoin Skills Hub

An open skills marketplace that gives AI agents read-only access to the KuCoin exchange via the KuCoin Classic REST API.

Note: All skills currently support GET (read-only) endpoints only. Write operations (placing/cancelling orders, transfers, etc.) are not yet supported.

Quick Start

Install all skills at once:

npx skills add https://github.com/Kucoin/kucoin-skills-hub --full-depth

Or install a specific skill:

npx skills add https://github.com/Kucoin/kucoin-skills-hub --full-depth --skill spot

Why --full-depth? The skills CLI stops scanning at the first directory level by default. Since each skill lives under skills//SKILL.md, --full-depth is required to discover them.

Available Skills

Skill Version Description
spot 1.0.0 Spot market data, HF order queries, stop orders, and OCO orders
margin-trading 1.0.0 Cross/isolated margin market data, HF order queries, stop orders, OCO orders, borrow/repay history, lending, and risk limits
futures-trading 1.0.0 Futures market data, order queries, position queries, and funding fees
assets 1.0.0 Account balances, ledgers, sub-accounts, deposits, withdrawals, transfers, and trade fees
earn 1.0.0 Simple Earn (savings, staking, promotions) and Structured Earn (dual investment) product queries
convert 1.0.0 Convert currencies, quotes, market order history, and limit order queries
broker 1.0.0 Affiliate invitee/commission queries, Broker Pro rebate/user queries, and ND Exchange Broker sub-account queries

Skill Coverage

Base URLs

Service URL
REST API https://api.kucoin.com
Futures REST API https://api-futures.kucoin.com

Futures endpoints must use https://api-futures.kucoin.com. This is noted individually in the relevant skill.

Authentication

Authenticated endpoints require the following HTTP headers:

Header Value
KC-API-KEY Your API Key
KC-API-SIGN HMAC-SHA256 signature of the request, Base64 encoded
KC-API-TIMESTAMP Current timestamp in milliseconds
KC-API-PASSPHRASE Passphrase encrypted with your Secret Key (HMAC-SHA256, Base64 encoded)
KC-API-KEY-VERSION API Key version — use 3

For full signing logic and code examples, see each skill’s references/authentication.md.

Response Format

All KuCoin API responses return a consistent JSON envelope:

{
  "code": "200000",
  "data": { ... }
}

"200000" indicates success. Any other code indicates an error.

Skill Format

Each skill follows this structure:

skills//
├── SKILL.md              # Skill definition (YAML frontmatter + endpoint reference)
├── CHANGELOG.md          # Version history
├── LICENSE.md            # License
└── references/
    └── authentication.md # Authentication & signing guide

Contributing

  1. Fork this repository
  2. Create a new skill folder under skills/ following the structure above
  3. Add a SKILL.md with YAML frontmatter (name, description, metadata, license) and a Markdown endpoint reference table
  4. Open a Pull Request

Disclaimer

KuCoin Skills Hub and any outputs, information, or analysis generated through it are provided on an “as is” and “as available” basis, without any representation or warranty of any kind. The information made available through KuCoin Skills Hub does not constitute investment, financial, trading, professional, or any other form of advice, and should not be relied upon as such. We do not guarantee the accuracy, timeliness, completeness, or reliability of any data, analysis, information, or output provided through KuCoin Skills Hub.

Investment in digital assets involves a high degree of risk. Before making any investment or trading decision, you should carefully assess your financial circumstances, investment objectives, and risk tolerance, and consult an independent professional adviser prior to making any investment. You acknowledge and agree that you are solely responsible for evaluating any information or output provided through KuCoin Skills Hub and for making your own investment and trading decisions. You are solely responsible for your investment decisions and we will not be liable for any losses you may incur.

Your use of KuCoin Skills Hub, and any information or output generated through it, is entirely at your own risk. We shall not be liable for any loss, damage, cost, or expense arising from or in connection with your use of, or reliance on, KuCoin Skills Hub, including any actions taken or not taken based on the information or outputs provided. To the fullest extent permitted by law, we expressly disclaim all liability for any direct, indirect, incidental, consequential, or other damages arising from or related to the use of KuCoin Skills Hub. Any execution errors, system failures, financial losses, or data inaccuracies arising from the use of, or resulting from, KuCoin Skills Hub shall be borne solely by you.

You are responsible for keeping your API keys secure, private, and properly managed, including when you use them with KuCoin Skills Hub and/or provide them to any third-party tools, applications, scripts, AI agents, or code repositories. We will not be responsible for any loss, unauthorized access, unauthorized transactions, asset loss, or other damage arising from your use of API keys with KuCoin Skills Hub, or from API keys that are stolen, exposed, misused, or otherwise improperly used, whether by you or someone else. This includes losses arising from your failure to properly protect, manage, monitor, restrict, or disable your API keys when necessary.

We reserve the right, at our sole discretion, to modify, suspend, or discontinue KuCoin Skills Hub at any time without prior notice. The availability and functionality of KuCoin Skills Hub may also vary depending on region or user profile.

License

MIT

View this README on GitHub

Recommended Tools

Try a different keyword or remove a filter.

Install

npx skillfish add kucoin/kucoin-skills-hub