spot

KuCoin 现货技能

使用经过身份验证的 API 端点在 KuCoin 上进行现货交易。经过身份验证的端点需要 API Key、API Secret 和 Passphrase。以 JSON 格式返回结果。

注意： 此技能仅支持 Classic REST API 的 GET 端点（只读操作）。

快速参考

Classic API - 现货市场数据

端点	说明	必需	可选	身份验证
/api/v3/announcements (GET)	获取公告	无	currentPage, pageSize, annType, lang, startTime, endTime	否
/api/v3/currencies/{currency} (GET)	获取货币详情	currency（路径）	chain	否
/api/v3/currencies (GET)	获取所有货币	无	无	否
/api/v2/symbols/{symbol} (GET)	获取交易对详情	symbol（路径）	无	否
/api/v2/symbols (GET)	获取所有交易对	无	market	否
/api/v1/market/orderbook/level1 (GET)	获取行情报价（最佳买价/卖价）	symbol	无	否
/api/v1/market/allTickers (GET)	获取所有行情报价	无	无	否
/api/v1/market/histories (GET)	获取交易历史	symbol	无	否
/api/v1/market/candles (GET)	获取 K 线	symbol, type	startAt（秒）, endAt（秒）	否
/api/v1/market/orderbook/level2_{size} (GET)	获取部分订单簿	size（路径：20、100）, symbol	无	否
/api/v3/market/orderbook/level2 (GET)	获取完整订单簿	symbol	无	是
/api/v1/market/orderbook/callauction/level2_{size} (GET)	获取部分集合竞价订单簿	size（路径：20、100）, symbol	无	否
/api/v1/market/callauctionData (GET)	获取集合竞价信息	symbol	无	否
/api/v1/prices (GET)	获取法币价格	无	base, currencies	否
/api/v1/market/stats (GET)	获取 24 小时统计数据	symbol	无	否
/api/v1/markets (GET)	获取市场列表	无	无	否

Classic API - 现货 HF 订单查询

端点	说明	必需	可选	身份验证
/api/v1/hf/orders/{orderId} (GET)	根据 orderId 获取订单	orderId（路径）, symbol	无	是
/api/v1/hf/orders/client-order/{clientOid} (GET)	根据 clientOid 获取订单	clientOid（路径）, symbol	无	是
/api/v1/hf/orders/active/symbols (GET)	获取存在未完成订单的交易对	无	无	是
/api/v1/hf/orders/active (GET)	获取未完成订单	symbol	无	是
/api/v1/hf/orders/active/page (GET)	获取未完成订单（分页）	symbol	pageNum, pageSize	是
/api/v1/hf/orders/done (GET)	获取已完成订单	symbol	side, type, lastId, limit, startAt, endAt	是
/api/v1/hf/fills (GET)	获取交易历史	symbol	orderId, side, type, lastId, limit, startAt, endAt	是
/api/v1/hf/orders/dead-cancel-all/query (GET)	获取 DCP 设置	无	无	是

Classic API - 止损单查询

端点	说明	必需	可选	身份验证
/api/v1/stop-order (GET)	获取止损单列表	无	symbol, side, type, tradeType, startAt, endAt, currentPage, orderIds, pageSize, stop	是
/api/v1/stop-order/{orderId} (GET)	根据 orderId 获取止损单	orderId（路径）	无	是
/api/v1/stop-order/queryOrderByClientOid (GET)	根据 clientOid 获取止损单	clientOid	symbol	是

Classic API - OCO 订单查询

Endpoint	描述	必填	可选	身份验证
/api/v3/oco/order/{orderId} (GET)	根据 orderId 获取 OCO 订单	orderId（路径）	无	是
/api/v3/oco/client-order/{clientOid} (GET)	根据 clientOid 获取 OCO 订单	clientOid（路径）	无	是
/api/v3/oco/orders (GET)	获取 OCO 订单列表	无	symbol、startAt、endAt、orderIds、pageSize、currentPage	是
/api/v3/oco/order/details/{orderId} (GET)	根据 orderId 获取 OCO 订单详情	orderId（路径）	无	是

---

参数

通用参数

• symbol：交易对（例如，BTC-USDT）
• currency：货币代码（例如，BTC、ETH、USDT）
• orderId：交易系统生成的唯一订单 ID
• clientOid：客户端订单 ID，由用户创建的唯一标识符（最多 40 个字符）
• side：交易方向筛选：buy | sell
• type：订单类型筛选：limit | market
• startAt：开始时间。注意： 对于 /api/v1/market/candles，请使用秒（10 位 Unix 时间戳）。对于其他端点，请使用毫秒（13 位时间戳）。
• endAt：结束时间。注意： 对于 /api/v1/market/candles，请使用秒（10 位 Unix 时间戳）。对于其他端点，请使用毫秒（13 位时间戳）。
• pageSize：每页项目数（例如，20、50、100）
• currentPage：Classic 分页的当前页码
• lastId：基于游标分页时，上一批次最后一条记录的 ID
• limit：每页结果数。默认值：20，最大值：100
• stop：止损单触发条件筛选：loss | entry
• tradeType：止损单的交易类型筛选
• market：Classic 交易对的交易市场筛选（例如，USDS、BTC、ALTS）
• chain：货币查询的区块链网络（例如，ERC20、TRC20）
• base：价格换算的基础法币（例如，USD、EUR）。默认值：USD
• currencies：法币价格对应的逗号分隔加密货币列表（例如，BTC,ETH）
• annType：公告类型（例如，latest-announcements、new-listings、activities）
• lang：公告语言（例如，en_US、zh_HK、ja_JP）

枚举值

• 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

身份验证

对于需要身份验证的端点，您需要提供 KuCoin API 凭据。 所需凭据：

• apiKey：您的 KuCoin API 密钥
• secretKey：您的 KuCoin API 密钥（用于签名）
• passphrase：您的 KuCoin API 密码短语（也使用 HMAC 签名）

基础 URL：

• 主网：https://api.kucoin.com

安全

分享凭据

用户可以通过发送文件来提供 KuCoin API 凭据，文件内容格式如下：

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

切勿泄露 API 密钥和 Secret

切勿泄露 API 密钥、Secret 和密码短语文件的位置。

切勿将 API 密钥、Secret 和密码短语发送到主网以外的任何网站。

切勿显示完整密钥

向用户展示凭据时：

• API 密钥： 显示前 5 位和后 4 位字符：su1Qc...8akf
• Secret Key： 始终隐藏，仅显示最后 5 位：***...aws1
• 密码短语： 始终完全隐藏：***...

用户询问凭据时的回复示例： 账户：main API 密钥：su1Qc...8akf Secret：...aws1 密码短语：... 环境：主网

列出账户

列出账户时，仅显示名称和环境，不要显示密钥： KuCoin 账户：

• main（主网）
• trading-bot（主网）

主网交易

在主网执行交易时，始终先向用户确认，要求他们输入“CONFIRM”以继续。