用途:基于 KuCoin API 查询保证金交易相关信息,支持全仓(cross margin)与逐仓(isolated margin)。该技能仅支持经典 REST API 的 GET 端点,即只读操作,不会下单或修改账户。
主要能力:市场数据方面可查询全仓与逐仓交易对配置、ETF 杠杆代币信息、标记价格、保证金配置、抵押率、可借库存等。订单查询方面覆盖高频(HF)保证金的单笔订单(按 orderId 或 clientOid)、当前挂单、已成交/已关闭订单、成交历史,以及止单(stop order)和 OCO 订单的查询。借还方面可查借款利率、借款历史、还款历史、利息历史。借贷方面可查借贷市场、市场利率、申购与赎回订单。风险方面可查各币种/交易对的风险限额。结果以 JSON 格式返回。
使用方式:需提供 KuCoin API Key、API Secret 和 Passphrase 用于需认证的端点,认证请求头分别为 KC-API-KEY、KC-API-PASSPHRASE,Secret 用于签名。生产环境基础 URL 为 https://api.kucoin.com。凭证可通过文件提供,内容依次为 API Key、API Secret、Passphrase。
常用参数:symbol(如 BTC-USDT)、side(buy|sell)、type(limit|market)、tradeType(MARGIN_TRADE 全仓 / MARGIN_ISOLATED_TRADE 逐仓)、isIsolated(true 为逐仓,默认 false)、currency、clientOid(建议 UUID,最长 40 字符)、分页参数 lastId/limit(默认 20,最大 100)或 currentPage/pageSize,以及 startAt/endAt 等时间过滤。
限制:仅支持只读 GET 接口,不能借币、还款或下单;需认证的端点必须提供有效凭证。资料未提供收费、价格及具体调用频率限制等信息。安全上应避免泄露凭证文件位置,不得把密钥发送至 KuCoin 官方端点以外的网站,展示时仅显示部分或掩码。