Agent Skills

spot

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

Installation
CLI
npx skills add https://github.com/kucoin/kucoin-skills-hub --skill spot

Install this skill with the CLI and start using the SKILL.md workflow in your workspace.

Last updated 4/22/2026

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/<name>/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

spot — Spot Trading
  • Market Data: announcements, currencies, symbols, tickers, order book (L1/L2/full), trade history, klines, call auction, fiat prices, 24hr stats, market list
  • HF Order Queries: get order by ID/clientOid, open orders, closed orders, trade fills, DCP settings
  • Stop Order Queries: list, get by orderId/clientOid
  • OCO Order Queries: get by orderId/clientOid, order list, order detail
margin-trading — Margin Trading
  • Market Data: cross/isolated margin symbols, ETF info, margin config, mark price list, collateral ratio, available inventory
  • HF Order Queries: get by orderId/clientOid, open orders (by symbol), closed orders, trade fills
  • Stop Order Queries: list, get by orderId/clientOid
  • OCO Order Queries: get by orderId/clientOid, order list, order detail
  • Debit (Borrow/Repay): borrow interest rate, borrow history, repay history, interest history
  • Credit (Lending): loan market, market interest rate, purchase orders, redeem orders
  • Risk Limit: margin risk limit per currency/symbol
futures-trading — Futures Trading
  • Market Data: server time, service status, mark price, contracts (single/all), tickers, order book (full/partial), trade history, klines, spot index, interest rate index, premium index, 24hr stats
  • Order Queries: stop orders, get order by orderId/clientOid, recent closed orders, open order value, recent fills
  • Position Queries: margin mode, position mode, max open size, position details, position list, position history, max withdraw margin, cross leverage, cross risk limit, isolated risk limit
  • Funding Fees: current funding rate, public funding history, private funding history
assets — Account & Assets
  • Account & Funding: account summary, API key info, account type, account list/detail (spot/cross margin/isolated margin/futures), account ledgers (spot, trade_hf, margin_hf, futures)
  • Sub-Accounts: sub-account list (summary/spot balance/futures balance), sub-account detail, sub-account API keys
  • Deposit: deposit address (V3), deposit history
  • Withdrawals: withdrawal quotas, withdrawal history (by ID / list)
  • Transfer: transfer quotas
  • Trade Fee: basic fee (spot/margin), actual fee (futures)
earn — Earn Products
  • Simple Earn: redeem preview, savings products, promotion products, staking products, KCS staking products, ETH staking products, account holdings
  • Structured Earn: structured product orders, dual investment products (endpoints may be unavailable — returns 400100)
convert — Instant Convert
  • Convert symbol info, available currencies, market quote, market order detail/history
  • Limit convert quote, limit order detail, limit order list
broker — Broker & Affiliate
  • Affiliate: invitee list, commission records, trade history by UID/time, KuMining commission
  • Broker Pro: rebate download, commission records, user list, user transactions
  • ND Exchange Broker: KYC status, broker info, sub-account list/API keys, transfer history, deposit list/detail, withdrawal detail, rebate download (some endpoints may return 404 — see skill notes)

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-name>/
├── 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