KuCoin API使用需依次完成密钥创建、请求头配置、行情调用、订单提交及余额查询五步：1.在APP安全中心创建带权限与IP白名单的API密钥；2.按HMAC-SHA256规范构造含时间戳、签名等四要素的请求头；3.行情接口无需鉴权，但限频且禁用于高频策略；4.限价委托需POST订单体并确保price/size为字符串；5.账户余额查询需开启【账户信息】权限，注意频率限制与冻结资金识别。
其它主流交易所官网地址推荐：
币安Binance官网入口：
币安Binance官方APP下载链接：
欧易okx官网地址：
欧易官方APP下载链接：
Gate.io平台官方入口：
一、创建API密钥
在KuCoin APP中启用API访问前，需先通过账户安全中心生成专属API密钥。该密钥作为调用交易、查询余额等操作的身份凭证，具备可配置的权限粒度与IP白名单控制能力。
1、打开KuCoin APP，点击右下角【我的】进入个人中心。
2、选择【安全中心】→【API管理】→【创建API】。
3、设置API名称，勾选所需权限（如【只读】、【现货交易】、【资金划转】），开启IP白名单并填写可信IP地址。
4、完成Google验证器二次认证，点击【确认创建】获取API Key、Secret Key及Passphrase。
5、立即备份Secret Key与Passphrase，页面关闭后无法再次查看。
二、配置API请求头
KuCoin API采用HMAC-SHA256签名机制，每次请求必须携带时间戳、签名及必要身份字段，确保通信不可篡改且时效可控。
1、在HTTP请求Header中添加：KC-API-KEY对应生成的API Key。
2、添加KC-API-TIMESTAMP字段，值为当前毫秒级时间戳（如1743627060000）。
3、添加KC-API-PASSPHRASE，值为创建时设定的通行短语。
4、构造签名字符串：[timestamp] + [method] + [endpoint] + [body]（无body则为空字符串）。
5、使用Secret Key对签名字符串执行HMAC-SHA256运算，将结果Base64编码后填入KC-API-SIGNATURE字段。
三、调用行情数据接口
无需鉴权即可获取实时市场快照，适用于价格监控、K线绘制等公开场景，所有请求均通过HTTPS协议发送至KuCoin开放API网关。
1、向https://api.kucoin.com/api/v1/market/orderbook/level2_20?symbol=BTC-USDT发起GET请求。
2、解析返回JSON中的asks与bids数组，提取前五档买/卖价格及数量。
3、调用https://api.kucoin.com/api/v1/market/candles?symbol=ETH-USDT&granularity=300获取300秒粒度K线。
4、检查响应头X-RateLimit-Remaining值，确保未超出每分钟30次的公共接口限频。
5、禁止将行情接口用于高频做市或套利策略的实时决策主通道。
四、提交限价委托订单
使用具备【现货交易】权限的API密钥，可远程下达挂单指令，系统按匹配引擎规则自动撮合，订单状态可通过独立接口轮询获取。
1、构造POST请求体：{"clientOid":"uniq123","side":"buy","symbol":"SOL-USDT","type":"limit","price":"142.50","size":"0.8"}。
2、请求路径为https://api.kucoin.com/api/v1/orders，Header中完整填充KC-API-KEY、KC-API-TIMESTAMP等四要素。
3、发送请求后检查HTTP状态码，200表示已接收，非200需依据code字段查错（如40004代表余额不足）。
4、调用https://api.kucoin.com/api/v1/orders?status=active获取当前所有未成交委托。
5、订单price与size字段必须为字符串格式，禁止传入浮点数类型。
五、查询账户资产余额
通过资金类API可实时拉取各币种可用余额与冻结余额，适用于自动化风控、跨平台资产核对等合规性操作，需启用【账户信息】权限。
1、向https://api.kucoin.com/api/v1/accounts?currency=USDT发起GET请求。
2、解析响应中available字段值，即当前可划转或交易的USDT数量。
3、若需批量查询多币种，省略currency参数，调用https://api.kucoin.com/api/v1/accounts获取全账户列表。
4、检查response.data中holds字段，确认是否存在因挂单或提现导致的资金冻结。
5、每次调用间隔不得少于200毫秒，避免触发风控系统的频率拦截。
