用途:该技能用于通过 KuCoin API 访问 KuCoin 期货的公开与认证数据,返回 JSON 结果。资料明确说明本技能仅支持 Classic REST API 的 GET 端点(只读操作),不包含下单、撤单或修改持仓等写操作。
主要能力:行情数据包括服务器时间、服务状态、标记价格、合约信息、全部合约、Ticker、全部 Ticker、完整与部分订单簿、成交历史、K 线、现货指数、利率指数、溢价指数及 24 小时统计。订单查询包括订单列表、止损订单列表、按 order-id 或 clientOid 查单、近 24 小时已平订单、未成交订单价值、成交流水与近期成交流水。持仓查询包括保证金模式、持仓模式、最大开仓量、持仓详情、持仓列表、持仓历史、最大可提取保证金、全仓杠杆、全仓风险限额与逐仓风险限额。资金费率包括当前资金费率、公开资金费率历史与私有资金费率历史。
使用方式:Classic Futures 基址为 https://api-futures.kucoin.com,适用于 /api/v1/...、/api/v2/...、/api/v3/... 等端点。认证端点需提供三项凭据:API Key、API Secret(用于签名)和 API Passphrase(创建 API Key 时设置)。用户可通过文件提供凭据,内容按顺序为 api_key_value、api_secret_value、api_passphrase_value。常用参数包括 symbol(如 XBTUSDTM、ETHUSDTM)、clientOid(最长 40 字符)、startAt/from 与 endAt/to(13 位毫秒时间戳)、pageSize、currentPage、side、type、status、tradeTypes、currency、reverse、offset、forward、maxCount、granularity(1 至 10080 分钟)、positionSide、price、leverage、totalMargin。
适用场景:适合需要读取 KuCoin 期货行情、查询订单与成交流水、检查持仓与资金费率数据的只读分析与查询场景。
限制与安全:仅支持只读 GET 端点,不涉及交易写操作。资料要求永不披露 API Key 与 Secret 的文件位置,不向 KuCoin 官方 API 基址以外的网站发送凭据;展示凭据时 API Key 仅显示前 5 位与后 4 位(如 abcde...wxyz),Secret 仅显示末 5 位并加掩码,Passphrase 完全掩码;列出账户时只显示名称与环境,不显示密钥。执行交易操作前需用户输入“CONFIRM”确认。其他未在资料中说明的功能、收费或平台情况暂未提供。