skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
kucoin/kucoin-skills-hub95 installs

spot

KuCoin Spot trading using the KuCoin API. Authentication requires API Key, API Secret, and Passphrase.

How do I install this agent skill?

npx skills add https://github.com/kucoin/kucoin-skills-hub --skill spot
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill facilitates integration with the KuCoin cryptocurrency exchange API. It includes comprehensive documentation for authentication and provides specific security rules for masking API credentials in conversations and requiring confirmation for mainnet transactions. No malicious patterns were detected.

  • Socketpass

    No alerts

  • Snykwarn

    Risk: MEDIUM · 1 issue

  • ZeroLeakspass

    Score: 93/100 · 2 sections analyzed

What does this agent skill do?

KuCoin Spot Skill

Spot trading on KuCoin using authenticated API endpoints. Requires API Key, API Secret, and Passphrase for authenticated endpoints. Return the result in JSON format.

Note: This skill only supports Classic REST API GET endpoints (read-only operations).

Quick Reference

Classic API - Spot Market Data

EndpointDescriptionRequiredOptionalAuthentication
/api/v3/announcements (GET)Get announcementsNonecurrentPage, pageSize, annType, lang, startTime, endTimeNo
/api/v3/currencies/{currency} (GET)Get currency detailcurrency (path)chainNo
/api/v3/currencies (GET)Get all currenciesNoneNoneNo
/api/v2/symbols/{symbol} (GET)Get symbol detailsymbol (path)NoneNo
/api/v2/symbols (GET)Get all symbolsNonemarketNo
/api/v1/market/orderbook/level1 (GET)Get ticker (best bid/ask)symbolNoneNo
/api/v1/market/allTickers (GET)Get all tickersNoneNoneNo
/api/v1/market/histories (GET)Get trade historysymbolNoneNo
/api/v1/market/candles (GET)Get klinessymbol, typestartAt (sec), endAt (sec)No
/api/v1/market/orderbook/level2_{size} (GET)Get part orderbooksize (path: 20, 100), symbolNoneNo
/api/v3/market/orderbook/level2 (GET)Get full orderbooksymbolNoneYes
/api/v1/market/orderbook/callauction/level2_{size} (GET)Get call auction part orderbooksize (path: 20, 100), symbolNoneNo
/api/v1/market/callauctionData (GET)Get call auction infosymbolNoneNo
/api/v1/prices (GET)Get fiat priceNonebase, currenciesNo
/api/v1/market/stats (GET)Get 24hr statssymbolNoneNo
/api/v1/markets (GET)Get market listNoneNoneNo

Classic API - Spot HF Order Queries

EndpointDescriptionRequiredOptionalAuthentication
/api/v1/hf/orders/{orderId} (GET)Get order by orderIdorderId (path), symbolNoneYes
/api/v1/hf/orders/client-order/{clientOid} (GET)Get order by clientOidclientOid (path), symbolNoneYes
/api/v1/hf/orders/active/symbols (GET)Get symbols with open ordersNoneNoneYes
/api/v1/hf/orders/active (GET)Get open orderssymbolNoneYes
/api/v1/hf/orders/active/page (GET)Get open orders (paginated)symbolpageNum, pageSizeYes
/api/v1/hf/orders/done (GET)Get closed orderssymbolside, type, lastId, limit, startAt, endAtYes
/api/v1/hf/fills (GET)Get trade historysymbolorderId, side, type, lastId, limit, startAt, endAtYes
/api/v1/hf/orders/dead-cancel-all/query (GET)Get DCP settingsNoneNoneYes

Classic API - Stop Order Queries

EndpointDescriptionRequiredOptionalAuthentication
/api/v1/stop-order (GET)Get stop orders listNonesymbol, side, type, tradeType, startAt, endAt, currentPage, orderIds, pageSize, stopYes
/api/v1/stop-order/{orderId} (GET)Get stop order by orderIdorderId (path)NoneYes
/api/v1/stop-order/queryOrderByClientOid (GET)Get stop order by clientOidclientOidsymbolYes

Classic API - OCO Order Queries

EndpointDescriptionRequiredOptionalAuthentication
/api/v3/oco/order/{orderId} (GET)Get OCO order by orderIdorderId (path)NoneYes
/api/v3/oco/client-order/{clientOid} (GET)Get OCO order by clientOidclientOid (path)NoneYes
/api/v3/oco/orders (GET)Get OCO order listNonesymbol, startAt, endAt, orderIds, pageSize, currentPageYes
/api/v3/oco/order/details/{orderId} (GET)Get OCO order detail by orderIdorderId (path)NoneYes

Parameters

Common Parameters

  • symbol: Trading pair (e.g., BTC-USDT)
  • currency: Currency code (e.g., BTC, ETH, USDT)
  • orderId: The unique order ID generated by the trading system
  • clientOid: Client order ID, unique identifier created by the user (max 40 characters)
  • side: Trade direction filter: buy | sell
  • type: Order type filter: limit | market
  • startAt: Start time. Note: For /api/v1/market/candles, use seconds (10-digit Unix timestamp). For other endpoints, use milliseconds (13-digit timestamp).
  • endAt: End time. Note: For /api/v1/market/candles, use seconds (10-digit Unix timestamp). For other endpoints, use milliseconds (13-digit timestamp).
  • pageSize: Number of items per page (e.g., 20, 50, 100)
  • currentPage: Current page number for Classic pagination
  • lastId: ID of last record from previous batch for cursor-based pagination
  • limit: Number of results per page. Default: 20, Max: 100
  • stop: Stop order trigger condition filter: loss | entry
  • tradeType: Trade type filter for stop orders
  • market: Trading market filter for Classic symbols (e.g., USDS, BTC, ALTS)
  • chain: Blockchain network for currency query (e.g., ERC20, TRC20)
  • base: Base fiat currency for price conversion (e.g., USD, EUR). Default: USD
  • currencies: Comma-separated cryptocurrency list for fiat price (e.g., BTC,ETH)
  • annType: Announcement type (e.g., latest-announcements, new-listings, activities)
  • lang: Announcement language (e.g., en_US, zh_HK, ja_JP)

Enums

  • side: buy | sell
  • type: limit | market
  • stop: loss | entry
  • kline type: 1min | 3min | 5min | 15min | 30min | 1hour | 2hour | 4hour | 6hour | 8hour | 12hour | 1day | 1week | 1month
  • annType: latest-announcements | activities | product-updates | vip | maintenance-updates | delistings | others | api-campaigns | new-listings | futures-announcements

Authentication

For endpoints that require authentication, you will need to provide KuCoin API credentials. Required credentials:

  • apiKey: Your KuCoin API key
  • secretKey: Your KuCoin API secret (for signing)
  • passphrase: Your KuCoin API passphrase (also HMAC signed)

Base URL:

Security

Share Credentials

Users can provide KuCoin API credentials by sending a file where the content is in the following format:

abc123...xyz
secret123...key
passphrase123...abc

Never Disclose API Key and Secret

Never disclose the location of the API key, secret, and passphrase file.

Never send the API key, secret, and passphrase to any website other than Mainnet.

Never Display Full Secrets

When showing credentials to users:

  • API Key: Show first 5 + last 4 characters: su1Qc...8akf
  • Secret Key: Always mask, show only last 5: ***...aws1
  • Passphrase: Always mask entirely: ***...

Example response when asked for credentials: Account: main API Key: su1Qc...8akf Secret: ***...aws1 Passphrase: ***... Environment: Mainnet

Listing Accounts

When listing accounts, show names and environment only -- never keys: KuCoin Accounts:

  • main (Mainnet)
  • trading-bot (Mainnet)

Transactions in Mainnet

When performing transactions in mainnet, always confirm with the user before proceeding by asking them to write "CONFIRM" to proceed.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/kucoin/kucoin-skills-hub/spot">View spot on skillZs</a>