Kucoin 允许您通过其 REST API 进行现货交易。
首先,您必须在 Kucoin 账户中创建一个 API Key,并为现货交易添加相应权限。
完成此操作后,您可以开始现货交易。
首先,在 Kucoin 客户端组件中设置您的 ApiKey、ApiSecret 和 Passphrase,这将用于对发送到 Kucoin 服务器的请求进行签名。
要下新订单,只需调用 Kucoin 客户端组件的 REST_API.PlaceOrder 方法。
根据订单类型(市价、限价等),API 所需的字段多少有所不同。
| 参数 | type | 描述 |
|---|---|---|
| clientOid | String | 用户创建的唯一订单 id,用于标识订单,例如 UUID。 |
| side | String | 买入 或 卖出 |
| symbol | String | 有效的交易品种代码,例如 ETH-BTC |
| type | String | [可选] limit 或 market (默认为 limit) |
| 备注 | String | [可选] 订单备注,长度不得超过 100 个 utf8 字符。 |
| stp | String | [可选] 自成交预防, CN、 CO、 CB 或 DC |
| tradeType | String | [可选] 交易类型: TRADE(现货交易), MARGIN_TRADE (杠杆交易)。默认值为 TRADE。 注意:为提升系统性能、加快下单和处理速度,KuCoin 已新增杠杆下单接口。仍在使用当前接口的交易者请尽快迁移至新接口。当前接口将于 2021 年 5 月 1 日(UTC)起不再接受杠杆订单。届时,KuCoin 将通过公告通知用户,请关注。 |
| 参数 | type | 描述 |
|---|---|---|
| price | String | 基础货币的单价 |
| size | String | 要买入或卖出的基础货币数量 |
| timeInForce | String | [可选] GTC, GTT, IOC, 或 FOK (默认值为 GTC),请阅读 有效时间。 |
| cancelAfter | long | [可选] 在 n 秒后取消,需要 timeInForce 为 GTT |
| postOnly | boolean | [可选] 仅挂单标志,当 timeInForce 为 IOC 或 FOK 时无效 |
| hidden | boolean | [可选] 订单不会显示在订单薄中 |
| iceberg | boolean | [可选] 订单簿中仅显示订单的一部分 |
| visibleSize | String | [可选] 冰山订单的最大可见数量 |
| 参数 | type | 描述 |
|---|---|---|
| size | String | [可选] 以基础货币计价的所需金额 |
| funds | String | [可选] 希望使用的报价货币数量。 |
下订单时,有 2 种可能性:
1. 成功:函数 PlaceOrder 返回 Kucoin 服务器发送的消息。
2. 错误:异常将在 OnKucoinHTTPException 事件中返回。
下市价单 1 BTC-USDT
oKucoin := TsgcWSAPI_Kucoin.Create(nil);
oKucoin.Kucoin.ApiKey := '<api key>';
oKucoin.Kucoin.ApiSecret := '<api secret>';
oKucoin.Kucoin.Passphrase := '<passphrase>';
ShowMessage(oKucoin.REST_API.PlaceMarketOrder(kosBuy, 'BTC-USDT', 1));
以 40000 下限价单购买 1 BTC-USDT
oKucoin := TsgcWSAPI_Kucoin.Create(nil);
oKucoin.Kucoin.ApiKey := '<api key>';
oKucoin.Kucoin.ApiSecret := '<api secret>';
oKucoin.Kucoin.Passphrase := '<passphrase>';
ShowMessage(oKucoin.REST_API.PlaceLimitOrder(kosBuy, 'BTC-USDT', 1, 40000));