ccxt 4.2.17 → 4.2.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (439) hide show
  1. package/README.md +9 -9
  2. package/dist/ccxt.browser.js +48992 -47725
  3. package/dist/ccxt.browser.min.js +3 -3
  4. package/dist/cjs/ccxt.js +12 -1
  5. package/dist/cjs/src/alpaca.js +18 -18
  6. package/dist/cjs/src/ascendex.js +13 -6
  7. package/dist/cjs/src/base/Exchange.js +266 -27
  8. package/dist/cjs/src/bigone.js +434 -168
  9. package/dist/cjs/src/binance.js +163 -34
  10. package/dist/cjs/src/binanceus.js +8 -0
  11. package/dist/cjs/src/bingx.js +183 -41
  12. package/dist/cjs/src/bitfinex.js +2 -3
  13. package/dist/cjs/src/bitget.js +59 -16
  14. package/dist/cjs/src/bitmart.js +5 -5
  15. package/dist/cjs/src/bitmex.js +4 -6
  16. package/dist/cjs/src/bitpanda.js +5 -1991
  17. package/dist/cjs/src/bitstamp.js +8 -0
  18. package/dist/cjs/src/bybit.js +27 -47
  19. package/dist/cjs/src/coinbase.js +176 -26
  20. package/dist/cjs/src/coincheck.js +1 -0
  21. package/dist/cjs/src/coinex.js +3 -0
  22. package/dist/cjs/src/coinlist.js +13 -6
  23. package/dist/cjs/src/coinone.js +2 -2
  24. package/dist/cjs/src/coinsph.js +4 -5
  25. package/dist/cjs/src/delta.js +7 -1
  26. package/dist/cjs/src/deribit.js +17 -4
  27. package/dist/cjs/src/gate.js +151 -169
  28. package/dist/cjs/src/gemini.js +1 -1
  29. package/dist/cjs/src/hitbtc.js +2 -3
  30. package/dist/cjs/src/htx.js +157 -7
  31. package/dist/cjs/src/huobijp.js +2 -3
  32. package/dist/cjs/src/independentreserve.js +7 -5
  33. package/dist/cjs/src/kraken.js +86 -54
  34. package/dist/cjs/src/kucoin.js +5 -0
  35. package/dist/cjs/src/kucoinfutures.js +131 -77
  36. package/dist/cjs/src/lbank.js +60 -33
  37. package/dist/cjs/src/luno.js +84 -2
  38. package/dist/cjs/src/mexc.js +3 -3
  39. package/dist/cjs/src/oceanex.js +1 -1
  40. package/dist/cjs/src/okx.js +23 -11
  41. package/dist/cjs/{js/src/bitpanda.js → src/onetrading.js} +39 -39
  42. package/dist/cjs/src/phemex.js +37 -27
  43. package/dist/cjs/src/poloniexfutures.js +1 -0
  44. package/dist/cjs/src/pro/binance.js +66 -25
  45. package/dist/cjs/src/pro/bitget.js +1 -1
  46. package/dist/cjs/src/pro/bitpanda.js +5 -1330
  47. package/dist/cjs/src/pro/coinbase.js +4 -1
  48. package/dist/cjs/src/pro/coincheck.js +208 -0
  49. package/dist/cjs/src/pro/hitbtc.js +5 -4
  50. package/dist/cjs/src/pro/htx.js +6 -1
  51. package/dist/cjs/src/pro/kraken.js +1 -1
  52. package/dist/cjs/src/pro/krakenfutures.js +7 -1
  53. package/dist/cjs/src/pro/kucoin.js +46 -36
  54. package/dist/cjs/src/pro/kucoinfutures.js +45 -37
  55. package/dist/cjs/src/pro/lbank.js +881 -0
  56. package/dist/cjs/src/pro/okx.js +52 -2
  57. package/dist/cjs/{js/src/pro/bitpanda.js → src/pro/onetrading.js} +4 -7
  58. package/dist/cjs/src/pro/poloniex.js +2 -2
  59. package/dist/cjs/src/pro/poloniexfutures.js +43 -35
  60. package/dist/cjs/src/pro/woo.js +126 -0
  61. package/dist/cjs/src/probit.js +4 -2
  62. package/dist/cjs/src/upbit.js +12 -12
  63. package/dist/cjs/src/wavesexchange.js +1 -1
  64. package/dist/cjs/src/whitebit.js +1 -0
  65. package/dist/cjs/src/woo.js +56 -0
  66. package/js/ccxt.d.ts +14 -2
  67. package/js/ccxt.js +10 -2
  68. package/js/src/abstract/bitpanda.d.ts +4 -4
  69. package/js/src/abstract/bitstamp.d.ts +8 -0
  70. package/js/src/abstract/gate.d.ts +1 -0
  71. package/js/src/abstract/gateio.d.ts +1 -0
  72. package/js/src/abstract/htx.d.ts +3 -0
  73. package/js/src/abstract/huobi.d.ts +3 -0
  74. package/js/src/abstract/luno.d.ts +1 -0
  75. package/js/src/abstract/onetrading.d.ts +38 -0
  76. package/js/src/ascendex.js +2 -0
  77. package/js/src/base/Exchange.d.ts +2 -3
  78. package/js/src/base/Exchange.js +5 -2
  79. package/js/src/binance.js +7 -1
  80. package/js/src/bingx.d.ts +1 -0
  81. package/js/src/bingx.js +26 -0
  82. package/js/src/bitget.js +22 -3
  83. package/js/src/bitpanda.d.ts +2 -72
  84. package/js/src/bitpanda.js +5 -1991
  85. package/js/src/bitstamp.js +8 -0
  86. package/js/src/bybit.js +21 -47
  87. package/js/src/coincheck.js +1 -0
  88. package/js/src/deribit.js +16 -4
  89. package/js/src/gate.d.ts +1 -0
  90. package/js/src/gate.js +50 -110
  91. package/js/src/htx.js +3 -0
  92. package/js/src/kraken.d.ts +1 -0
  93. package/js/src/kraken.js +40 -39
  94. package/js/src/lbank.js +1 -0
  95. package/js/src/luno.d.ts +3 -1
  96. package/js/src/luno.js +84 -2
  97. package/js/src/mexc.js +1 -2
  98. package/js/src/onetrading.d.ts +74 -0
  99. package/js/src/onetrading.js +2003 -0
  100. package/js/src/poloniexfutures.js +1 -0
  101. package/js/src/pro/binance.js +7 -2
  102. package/js/src/pro/bitget.js +1 -1
  103. package/js/src/pro/bitpanda.d.ts +2 -34
  104. package/js/src/pro/bitpanda.js +5 -1330
  105. package/js/src/pro/coincheck.d.ts +12 -0
  106. package/js/src/pro/coincheck.js +209 -0
  107. package/js/src/pro/kucoin.js +43 -35
  108. package/js/src/pro/kucoinfutures.js +45 -37
  109. package/js/src/pro/lbank.d.ts +29 -0
  110. package/js/src/pro/lbank.js +882 -0
  111. package/js/src/pro/onetrading.d.ts +36 -0
  112. package/js/src/pro/onetrading.js +1339 -0
  113. package/js/src/pro/poloniexfutures.js +43 -35
  114. package/js/src/whitebit.js +1 -0
  115. package/package.json +2 -2
  116. package/rollup.config.js +2 -0
  117. package/skip-tests.json +14 -2
  118. package/test-commonjs.cjs +25 -1
  119. package/dist/cjs/js/ccxt.js +0 -476
  120. package/dist/cjs/js/src/abstract/alpaca.js +0 -9
  121. package/dist/cjs/js/src/abstract/ascendex.js +0 -9
  122. package/dist/cjs/js/src/abstract/bigone.js +0 -9
  123. package/dist/cjs/js/src/abstract/binance.js +0 -9
  124. package/dist/cjs/js/src/abstract/bingx.js +0 -9
  125. package/dist/cjs/js/src/abstract/bit2c.js +0 -9
  126. package/dist/cjs/js/src/abstract/bitbank.js +0 -9
  127. package/dist/cjs/js/src/abstract/bitbns.js +0 -9
  128. package/dist/cjs/js/src/abstract/bitfinex.js +0 -9
  129. package/dist/cjs/js/src/abstract/bitfinex2.js +0 -9
  130. package/dist/cjs/js/src/abstract/bitflyer.js +0 -9
  131. package/dist/cjs/js/src/abstract/bitforex.js +0 -9
  132. package/dist/cjs/js/src/abstract/bitget.js +0 -9
  133. package/dist/cjs/js/src/abstract/bithumb.js +0 -9
  134. package/dist/cjs/js/src/abstract/bitmart.js +0 -9
  135. package/dist/cjs/js/src/abstract/bitmex.js +0 -9
  136. package/dist/cjs/js/src/abstract/bitopro.js +0 -9
  137. package/dist/cjs/js/src/abstract/bitpanda.js +0 -9
  138. package/dist/cjs/js/src/abstract/bitrue.js +0 -9
  139. package/dist/cjs/js/src/abstract/bitso.js +0 -9
  140. package/dist/cjs/js/src/abstract/bitstamp.js +0 -9
  141. package/dist/cjs/js/src/abstract/bitteam.js +0 -9
  142. package/dist/cjs/js/src/abstract/bitvavo.js +0 -9
  143. package/dist/cjs/js/src/abstract/bl3p.js +0 -9
  144. package/dist/cjs/js/src/abstract/blockchaincom.js +0 -9
  145. package/dist/cjs/js/src/abstract/btcalpha.js +0 -9
  146. package/dist/cjs/js/src/abstract/btcbox.js +0 -9
  147. package/dist/cjs/js/src/abstract/btcmarkets.js +0 -9
  148. package/dist/cjs/js/src/abstract/btcturk.js +0 -9
  149. package/dist/cjs/js/src/abstract/bybit.js +0 -9
  150. package/dist/cjs/js/src/abstract/cex.js +0 -9
  151. package/dist/cjs/js/src/abstract/coinbase.js +0 -9
  152. package/dist/cjs/js/src/abstract/coinbasepro.js +0 -9
  153. package/dist/cjs/js/src/abstract/coincheck.js +0 -9
  154. package/dist/cjs/js/src/abstract/coinex.js +0 -9
  155. package/dist/cjs/js/src/abstract/coinlist.js +0 -9
  156. package/dist/cjs/js/src/abstract/coinmate.js +0 -9
  157. package/dist/cjs/js/src/abstract/coinone.js +0 -9
  158. package/dist/cjs/js/src/abstract/coinsph.js +0 -9
  159. package/dist/cjs/js/src/abstract/coinspot.js +0 -9
  160. package/dist/cjs/js/src/abstract/cryptocom.js +0 -9
  161. package/dist/cjs/js/src/abstract/currencycom.js +0 -9
  162. package/dist/cjs/js/src/abstract/delta.js +0 -9
  163. package/dist/cjs/js/src/abstract/deribit.js +0 -9
  164. package/dist/cjs/js/src/abstract/digifinex.js +0 -9
  165. package/dist/cjs/js/src/abstract/exmo.js +0 -9
  166. package/dist/cjs/js/src/abstract/gate.js +0 -9
  167. package/dist/cjs/js/src/abstract/gemini.js +0 -9
  168. package/dist/cjs/js/src/abstract/hitbtc.js +0 -9
  169. package/dist/cjs/js/src/abstract/hollaex.js +0 -9
  170. package/dist/cjs/js/src/abstract/htx.js +0 -9
  171. package/dist/cjs/js/src/abstract/huobijp.js +0 -9
  172. package/dist/cjs/js/src/abstract/idex.js +0 -9
  173. package/dist/cjs/js/src/abstract/independentreserve.js +0 -9
  174. package/dist/cjs/js/src/abstract/indodax.js +0 -9
  175. package/dist/cjs/js/src/abstract/kraken.js +0 -9
  176. package/dist/cjs/js/src/abstract/krakenfutures.js +0 -9
  177. package/dist/cjs/js/src/abstract/kucoin.js +0 -9
  178. package/dist/cjs/js/src/abstract/kucoinfutures.js +0 -9
  179. package/dist/cjs/js/src/abstract/kuna.js +0 -9
  180. package/dist/cjs/js/src/abstract/latoken.js +0 -9
  181. package/dist/cjs/js/src/abstract/lbank.js +0 -9
  182. package/dist/cjs/js/src/abstract/luno.js +0 -9
  183. package/dist/cjs/js/src/abstract/lykke.js +0 -9
  184. package/dist/cjs/js/src/abstract/mercado.js +0 -9
  185. package/dist/cjs/js/src/abstract/mexc.js +0 -9
  186. package/dist/cjs/js/src/abstract/ndax.js +0 -9
  187. package/dist/cjs/js/src/abstract/novadax.js +0 -9
  188. package/dist/cjs/js/src/abstract/oceanex.js +0 -9
  189. package/dist/cjs/js/src/abstract/okcoin.js +0 -9
  190. package/dist/cjs/js/src/abstract/okx.js +0 -9
  191. package/dist/cjs/js/src/abstract/p2b.js +0 -9
  192. package/dist/cjs/js/src/abstract/paymium.js +0 -9
  193. package/dist/cjs/js/src/abstract/phemex.js +0 -9
  194. package/dist/cjs/js/src/abstract/poloniex.js +0 -9
  195. package/dist/cjs/js/src/abstract/poloniexfutures.js +0 -9
  196. package/dist/cjs/js/src/abstract/probit.js +0 -9
  197. package/dist/cjs/js/src/abstract/timex.js +0 -9
  198. package/dist/cjs/js/src/abstract/tokocrypto.js +0 -9
  199. package/dist/cjs/js/src/abstract/upbit.js +0 -9
  200. package/dist/cjs/js/src/abstract/wavesexchange.js +0 -9
  201. package/dist/cjs/js/src/abstract/wazirx.js +0 -9
  202. package/dist/cjs/js/src/abstract/whitebit.js +0 -9
  203. package/dist/cjs/js/src/abstract/woo.js +0 -9
  204. package/dist/cjs/js/src/abstract/yobit.js +0 -9
  205. package/dist/cjs/js/src/abstract/zaif.js +0 -9
  206. package/dist/cjs/js/src/abstract/zonda.js +0 -9
  207. package/dist/cjs/js/src/ace.js +0 -1058
  208. package/dist/cjs/js/src/alpaca.js +0 -1125
  209. package/dist/cjs/js/src/ascendex.js +0 -3365
  210. package/dist/cjs/js/src/base/Exchange.js +0 -5257
  211. package/dist/cjs/js/src/base/Precise.js +0 -263
  212. package/dist/cjs/js/src/base/errors.js +0 -299
  213. package/dist/cjs/js/src/base/functions/crypto.js +0 -78
  214. package/dist/cjs/js/src/base/functions/encode.js +0 -44
  215. package/dist/cjs/js/src/base/functions/generic.js +0 -193
  216. package/dist/cjs/js/src/base/functions/misc.js +0 -96
  217. package/dist/cjs/js/src/base/functions/number.js +0 -297
  218. package/dist/cjs/js/src/base/functions/platform.js +0 -28
  219. package/dist/cjs/js/src/base/functions/rsa.js +0 -34
  220. package/dist/cjs/js/src/base/functions/string.js +0 -48
  221. package/dist/cjs/js/src/base/functions/throttle.js +0 -66
  222. package/dist/cjs/js/src/base/functions/time.js +0 -187
  223. package/dist/cjs/js/src/base/functions/totp.js +0 -24
  224. package/dist/cjs/js/src/base/functions/type.js +0 -162
  225. package/dist/cjs/js/src/base/functions.js +0 -157
  226. package/dist/cjs/js/src/base/ws/Cache.js +0 -254
  227. package/dist/cjs/js/src/base/ws/Client.js +0 -299
  228. package/dist/cjs/js/src/base/ws/Future.js +0 -34
  229. package/dist/cjs/js/src/base/ws/OrderBook.js +0 -107
  230. package/dist/cjs/js/src/base/ws/OrderBookSide.js +0 -281
  231. package/dist/cjs/js/src/base/ws/WsClient.js +0 -69
  232. package/dist/cjs/js/src/bequant.js +0 -33
  233. package/dist/cjs/js/src/bigone.js +0 -2213
  234. package/dist/cjs/js/src/binance.js +0 -9845
  235. package/dist/cjs/js/src/binancecoinm.js +0 -45
  236. package/dist/cjs/js/src/binanceus.js +0 -92
  237. package/dist/cjs/js/src/binanceusdm.js +0 -58
  238. package/dist/cjs/js/src/bingx.js +0 -3846
  239. package/dist/cjs/js/src/bit2c.js +0 -916
  240. package/dist/cjs/js/src/bitbank.js +0 -1000
  241. package/dist/cjs/js/src/bitbay.js +0 -17
  242. package/dist/cjs/js/src/bitbns.js +0 -1220
  243. package/dist/cjs/js/src/bitcoincom.js +0 -17
  244. package/dist/cjs/js/src/bitfinex.js +0 -1670
  245. package/dist/cjs/js/src/bitfinex2.js +0 -2990
  246. package/dist/cjs/js/src/bitflyer.js +0 -1045
  247. package/dist/cjs/js/src/bitforex.js +0 -852
  248. package/dist/cjs/js/src/bitget.js +0 -8295
  249. package/dist/cjs/js/src/bithumb.js +0 -1090
  250. package/dist/cjs/js/src/bitmart.js +0 -4454
  251. package/dist/cjs/js/src/bitmex.js +0 -2881
  252. package/dist/cjs/js/src/bitopro.js +0 -1724
  253. package/dist/cjs/js/src/bitrue.js +0 -3253
  254. package/dist/cjs/js/src/bitso.js +0 -1753
  255. package/dist/cjs/js/src/bitstamp.js +0 -2188
  256. package/dist/cjs/js/src/bitteam.js +0 -2309
  257. package/dist/cjs/js/src/bitvavo.js +0 -1968
  258. package/dist/cjs/js/src/bl3p.js +0 -447
  259. package/dist/cjs/js/src/blockchaincom.js +0 -1160
  260. package/dist/cjs/js/src/btcalpha.js +0 -929
  261. package/dist/cjs/js/src/btcbox.js +0 -565
  262. package/dist/cjs/js/src/btcmarkets.js +0 -1237
  263. package/dist/cjs/js/src/btcturk.js +0 -929
  264. package/dist/cjs/js/src/bybit.js +0 -7650
  265. package/dist/cjs/js/src/cex.js +0 -1693
  266. package/dist/cjs/js/src/coinbase.js +0 -3424
  267. package/dist/cjs/js/src/coinbasepro.js +0 -1866
  268. package/dist/cjs/js/src/coincheck.js +0 -843
  269. package/dist/cjs/js/src/coinex.js +0 -5417
  270. package/dist/cjs/js/src/coinlist.js +0 -2337
  271. package/dist/cjs/js/src/coinmate.js +0 -989
  272. package/dist/cjs/js/src/coinone.js +0 -1185
  273. package/dist/cjs/js/src/coinsph.js +0 -1933
  274. package/dist/cjs/js/src/coinspot.js +0 -548
  275. package/dist/cjs/js/src/cryptocom.js +0 -3007
  276. package/dist/cjs/js/src/currencycom.js +0 -2015
  277. package/dist/cjs/js/src/delta.js +0 -3262
  278. package/dist/cjs/js/src/deribit.js +0 -3306
  279. package/dist/cjs/js/src/digifinex.js +0 -4307
  280. package/dist/cjs/js/src/exmo.js +0 -2645
  281. package/dist/cjs/js/src/fmfwio.js +0 -34
  282. package/dist/cjs/js/src/gate.js +0 -7077
  283. package/dist/cjs/js/src/gateio.js +0 -16
  284. package/dist/cjs/js/src/gemini.js +0 -1801
  285. package/dist/cjs/js/src/hitbtc.js +0 -3660
  286. package/dist/cjs/js/src/hitbtc3.js +0 -19
  287. package/dist/cjs/js/src/hollaex.js +0 -1882
  288. package/dist/cjs/js/src/htx.js +0 -9174
  289. package/dist/cjs/js/src/huobi.js +0 -16
  290. package/dist/cjs/js/src/huobijp.js +0 -1918
  291. package/dist/cjs/js/src/idex.js +0 -1770
  292. package/dist/cjs/js/src/independentreserve.js +0 -761
  293. package/dist/cjs/js/src/indodax.js +0 -1069
  294. package/dist/cjs/js/src/kraken.js +0 -2891
  295. package/dist/cjs/js/src/krakenfutures.js +0 -2407
  296. package/dist/cjs/js/src/kucoin.js +0 -4494
  297. package/dist/cjs/js/src/kucoinfutures.js +0 -2529
  298. package/dist/cjs/js/src/kuna.js +0 -1949
  299. package/dist/cjs/js/src/latoken.js +0 -1729
  300. package/dist/cjs/js/src/lbank.js +0 -2851
  301. package/dist/cjs/js/src/luno.js +0 -1044
  302. package/dist/cjs/js/src/lykke.js +0 -1303
  303. package/dist/cjs/js/src/mercado.js +0 -897
  304. package/dist/cjs/js/src/mexc.js +0 -5407
  305. package/dist/cjs/js/src/ndax.js +0 -2450
  306. package/dist/cjs/js/src/novadax.js +0 -1556
  307. package/dist/cjs/js/src/oceanex.js +0 -964
  308. package/dist/cjs/js/src/okcoin.js +0 -3115
  309. package/dist/cjs/js/src/okx.js +0 -7331
  310. package/dist/cjs/js/src/p2b.js +0 -1243
  311. package/dist/cjs/js/src/paymium.js +0 -597
  312. package/dist/cjs/js/src/phemex.js +0 -4725
  313. package/dist/cjs/js/src/poloniex.js +0 -2356
  314. package/dist/cjs/js/src/poloniexfutures.js +0 -1794
  315. package/dist/cjs/js/src/pro/alpaca.js +0 -714
  316. package/dist/cjs/js/src/pro/ascendex.js +0 -957
  317. package/dist/cjs/js/src/pro/bequant.js +0 -33
  318. package/dist/cjs/js/src/pro/binance.js +0 -2796
  319. package/dist/cjs/js/src/pro/binancecoinm.js +0 -23
  320. package/dist/cjs/js/src/pro/binanceus.js +0 -51
  321. package/dist/cjs/js/src/pro/binanceusdm.js +0 -32
  322. package/dist/cjs/js/src/pro/bingx.js +0 -944
  323. package/dist/cjs/js/src/pro/bitcoincom.js +0 -29
  324. package/dist/cjs/js/src/pro/bitfinex.js +0 -672
  325. package/dist/cjs/js/src/pro/bitfinex2.js +0 -1159
  326. package/dist/cjs/js/src/pro/bitget.js +0 -1733
  327. package/dist/cjs/js/src/pro/bitmart.js +0 -1486
  328. package/dist/cjs/js/src/pro/bitmex.js +0 -1576
  329. package/dist/cjs/js/src/pro/bitopro.js +0 -327
  330. package/dist/cjs/js/src/pro/bitrue.js +0 -462
  331. package/dist/cjs/js/src/pro/bitstamp.js +0 -547
  332. package/dist/cjs/js/src/pro/bitvavo.js +0 -704
  333. package/dist/cjs/js/src/pro/blockchaincom.js +0 -794
  334. package/dist/cjs/js/src/pro/bybit.js +0 -1843
  335. package/dist/cjs/js/src/pro/cex.js +0 -1510
  336. package/dist/cjs/js/src/pro/coinbase.js +0 -561
  337. package/dist/cjs/js/src/pro/coinbasepro.js +0 -968
  338. package/dist/cjs/js/src/pro/coinex.js +0 -1095
  339. package/dist/cjs/js/src/pro/cryptocom.js +0 -1020
  340. package/dist/cjs/js/src/pro/currencycom.js +0 -563
  341. package/dist/cjs/js/src/pro/deribit.js +0 -825
  342. package/dist/cjs/js/src/pro/exmo.js +0 -658
  343. package/dist/cjs/js/src/pro/gate.js +0 -1316
  344. package/dist/cjs/js/src/pro/gateio.js +0 -16
  345. package/dist/cjs/js/src/pro/gemini.js +0 -649
  346. package/dist/cjs/js/src/pro/hitbtc.js +0 -1294
  347. package/dist/cjs/js/src/pro/hollaex.js +0 -597
  348. package/dist/cjs/js/src/pro/htx.js +0 -2388
  349. package/dist/cjs/js/src/pro/huobi.js +0 -16
  350. package/dist/cjs/js/src/pro/huobijp.js +0 -606
  351. package/dist/cjs/js/src/pro/idex.js +0 -714
  352. package/dist/cjs/js/src/pro/independentreserve.js +0 -280
  353. package/dist/cjs/js/src/pro/kraken.js +0 -1364
  354. package/dist/cjs/js/src/pro/krakenfutures.js +0 -1506
  355. package/dist/cjs/js/src/pro/kucoin.js +0 -1054
  356. package/dist/cjs/js/src/pro/kucoinfutures.js +0 -981
  357. package/dist/cjs/js/src/pro/luno.js +0 -322
  358. package/dist/cjs/js/src/pro/mexc.js +0 -1170
  359. package/dist/cjs/js/src/pro/ndax.js +0 -545
  360. package/dist/cjs/js/src/pro/okcoin.js +0 -760
  361. package/dist/cjs/js/src/pro/okx.js +0 -1608
  362. package/dist/cjs/js/src/pro/phemex.js +0 -1511
  363. package/dist/cjs/js/src/pro/poloniex.js +0 -1253
  364. package/dist/cjs/js/src/pro/poloniexfutures.js +0 -1014
  365. package/dist/cjs/js/src/pro/probit.js +0 -586
  366. package/dist/cjs/js/src/pro/upbit.js +0 -234
  367. package/dist/cjs/js/src/pro/wazirx.js +0 -776
  368. package/dist/cjs/js/src/pro/whitebit.js +0 -927
  369. package/dist/cjs/js/src/pro/woo.js +0 -895
  370. package/dist/cjs/js/src/probit.js +0 -1867
  371. package/dist/cjs/js/src/static_dependencies/fflake/browser.js +0 -401
  372. package/dist/cjs/js/src/static_dependencies/jsencrypt/JSEncrypt.js +0 -195
  373. package/dist/cjs/js/src/static_dependencies/jsencrypt/JSEncryptRSAKey.js +0 -308
  374. package/dist/cjs/js/src/static_dependencies/jsencrypt/lib/asn1js/asn1.js +0 -554
  375. package/dist/cjs/js/src/static_dependencies/jsencrypt/lib/asn1js/base64.js +0 -94
  376. package/dist/cjs/js/src/static_dependencies/jsencrypt/lib/asn1js/hex.js +0 -70
  377. package/dist/cjs/js/src/static_dependencies/jsencrypt/lib/asn1js/int10.js +0 -91
  378. package/dist/cjs/js/src/static_dependencies/jsencrypt/lib/jsbn/base64.js +0 -16
  379. package/dist/cjs/js/src/static_dependencies/jsencrypt/lib/jsbn/jsbn.js +0 -1760
  380. package/dist/cjs/js/src/static_dependencies/jsencrypt/lib/jsbn/prng4.js +0 -52
  381. package/dist/cjs/js/src/static_dependencies/jsencrypt/lib/jsbn/rng.js +0 -81
  382. package/dist/cjs/js/src/static_dependencies/jsencrypt/lib/jsbn/rsa.js +0 -376
  383. package/dist/cjs/js/src/static_dependencies/jsencrypt/lib/jsbn/util.js +0 -70
  384. package/dist/cjs/js/src/static_dependencies/jsencrypt/lib/jsrsasign/asn1-1.0.js +0 -1580
  385. package/dist/cjs/js/src/static_dependencies/jsencrypt/lib/jsrsasign/yahoo.js +0 -74
  386. package/dist/cjs/js/src/static_dependencies/noble-curves/_shortw_utils.js +0 -24
  387. package/dist/cjs/js/src/static_dependencies/noble-curves/abstract/curve.js +0 -158
  388. package/dist/cjs/js/src/static_dependencies/noble-curves/abstract/edwards.js +0 -429
  389. package/dist/cjs/js/src/static_dependencies/noble-curves/abstract/hash-to-curve.js +0 -176
  390. package/dist/cjs/js/src/static_dependencies/noble-curves/abstract/modular.js +0 -324
  391. package/dist/cjs/js/src/static_dependencies/noble-curves/abstract/montgomery.js +0 -163
  392. package/dist/cjs/js/src/static_dependencies/noble-curves/abstract/utils.js +0 -245
  393. package/dist/cjs/js/src/static_dependencies/noble-curves/abstract/weierstrass.js +0 -1018
  394. package/dist/cjs/js/src/static_dependencies/noble-curves/ed25519.js +0 -383
  395. package/dist/cjs/js/src/static_dependencies/noble-curves/secp256k1.js +0 -258
  396. package/dist/cjs/js/src/static_dependencies/noble-hashes/_assert.js +0 -53
  397. package/dist/cjs/js/src/static_dependencies/noble-hashes/_sha2.js +0 -120
  398. package/dist/cjs/js/src/static_dependencies/noble-hashes/_u64.js +0 -69
  399. package/dist/cjs/js/src/static_dependencies/noble-hashes/crypto.js +0 -7
  400. package/dist/cjs/js/src/static_dependencies/noble-hashes/hmac.js +0 -83
  401. package/dist/cjs/js/src/static_dependencies/noble-hashes/md5.js +0 -240
  402. package/dist/cjs/js/src/static_dependencies/noble-hashes/sha1.js +0 -91
  403. package/dist/cjs/js/src/static_dependencies/noble-hashes/sha256.js +0 -130
  404. package/dist/cjs/js/src/static_dependencies/noble-hashes/sha3.js +0 -214
  405. package/dist/cjs/js/src/static_dependencies/noble-hashes/sha512.js +0 -239
  406. package/dist/cjs/js/src/static_dependencies/noble-hashes/utils.js +0 -93
  407. package/dist/cjs/js/src/static_dependencies/node-fetch/body.js +0 -354
  408. package/dist/cjs/js/src/static_dependencies/node-fetch/errors/abort-error.js +0 -16
  409. package/dist/cjs/js/src/static_dependencies/node-fetch/errors/base.js +0 -20
  410. package/dist/cjs/js/src/static_dependencies/node-fetch/errors/fetch-error.js +0 -30
  411. package/dist/cjs/js/src/static_dependencies/node-fetch/headers.js +0 -239
  412. package/dist/cjs/js/src/static_dependencies/node-fetch/index.js +0 -372
  413. package/dist/cjs/js/src/static_dependencies/node-fetch/request.js +0 -273
  414. package/dist/cjs/js/src/static_dependencies/node-fetch/response.js +0 -139
  415. package/dist/cjs/js/src/static_dependencies/node-fetch/utils/get-search.js +0 -14
  416. package/dist/cjs/js/src/static_dependencies/node-fetch/utils/is-redirect.js +0 -16
  417. package/dist/cjs/js/src/static_dependencies/node-fetch/utils/is.js +0 -81
  418. package/dist/cjs/js/src/static_dependencies/node-fetch/utils/referrer.js +0 -292
  419. package/dist/cjs/js/src/static_dependencies/proxies/agent-base/index.js +0 -103
  420. package/dist/cjs/js/src/static_dependencies/proxies/http-proxy-agent/index.js +0 -140
  421. package/dist/cjs/js/src/static_dependencies/proxies/https-proxy-agent/index.js +0 -175
  422. package/dist/cjs/js/src/static_dependencies/proxies/https-proxy-agent/parse-proxy-response.js +0 -95
  423. package/dist/cjs/js/src/static_dependencies/qs/index.cjs.js +0 -7
  424. package/dist/cjs/js/src/static_dependencies/scure-base/index.js +0 -383
  425. package/dist/cjs/js/src/timex.js +0 -1562
  426. package/dist/cjs/js/src/tokocrypto.js +0 -2542
  427. package/dist/cjs/js/src/upbit.js +0 -1844
  428. package/dist/cjs/js/src/wavesexchange.js +0 -2607
  429. package/dist/cjs/js/src/wazirx.js +0 -953
  430. package/dist/cjs/js/src/whitebit.js +0 -2309
  431. package/dist/cjs/js/src/woo.js +0 -2769
  432. package/dist/cjs/js/src/yobit.js +0 -1314
  433. package/dist/cjs/js/src/zaif.js +0 -736
  434. package/dist/cjs/js/src/zonda.js +0 -1883
  435. package/dist/cjs/src/abstract/bitpanda.js +0 -9
  436. package/test.ts +0 -0
  437. /package/dist/cjs/{js/src/abstract/ace.js → src/abstract/onetrading.js} +0 -0
  438. /package/dist/cjs/{js/src → src}/pro/coinone.js +0 -0
  439. /package/js/src/abstract/{bitpanda.js → onetrading.js} +0 -0
@@ -1,2529 +0,0 @@
1
- 'use strict';
2
-
3
- var errors = require('./base/errors.js');
4
- var Precise = require('./base/Precise.js');
5
- var number = require('./base/functions/number.js');
6
- var kucoinfutures$1 = require('./abstract/kucoinfutures.js');
7
-
8
- // ---------------------------------------------------------------------------
9
- // ---------------------------------------------------------------------------
10
- class kucoinfutures extends kucoinfutures$1 {
11
- describe() {
12
- return this.deepExtend(super.describe(), {
13
- 'id': 'kucoinfutures',
14
- 'name': 'KuCoin Futures',
15
- 'countries': ['SC'],
16
- 'rateLimit': 75,
17
- 'version': 'v1',
18
- 'certified': true,
19
- 'pro': true,
20
- 'comment': 'Platform 2.0',
21
- 'quoteJsonNumbers': false,
22
- 'has': {
23
- 'CORS': undefined,
24
- 'spot': false,
25
- 'margin': false,
26
- 'swap': true,
27
- 'future': true,
28
- 'option': false,
29
- 'addMargin': true,
30
- 'cancelAllOrders': true,
31
- 'cancelOrder': true,
32
- 'closePosition': true,
33
- 'closePositions': false,
34
- 'createDepositAddress': true,
35
- 'createOrder': true,
36
- 'createOrders': true,
37
- 'createReduceOnlyOrder': true,
38
- 'createStopLimitOrder': true,
39
- 'createStopLossOrder': true,
40
- 'createStopMarketOrder': true,
41
- 'createStopOrder': true,
42
- 'createTakeProfitOrder': true,
43
- 'createTriggerOrder': true,
44
- 'fetchAccounts': true,
45
- 'fetchBalance': true,
46
- 'fetchBorrowRateHistories': false,
47
- 'fetchBorrowRateHistory': false,
48
- 'fetchClosedOrders': true,
49
- 'fetchCrossBorrowRate': false,
50
- 'fetchCrossBorrowRates': false,
51
- 'fetchCurrencies': false,
52
- 'fetchDepositAddress': true,
53
- 'fetchDeposits': true,
54
- 'fetchDepositWithdrawFee': false,
55
- 'fetchDepositWithdrawFees': false,
56
- 'fetchFundingHistory': true,
57
- 'fetchFundingRate': true,
58
- 'fetchFundingRateHistory': true,
59
- 'fetchIndexOHLCV': false,
60
- 'fetchIsolatedBorrowRate': false,
61
- 'fetchIsolatedBorrowRates': false,
62
- 'fetchL3OrderBook': true,
63
- 'fetchLedger': true,
64
- 'fetchLeverageTiers': false,
65
- 'fetchMarginMode': false,
66
- 'fetchMarketLeverageTiers': true,
67
- 'fetchMarkets': true,
68
- 'fetchMarkOHLCV': false,
69
- 'fetchMyTrades': true,
70
- 'fetchOHLCV': true,
71
- 'fetchOpenOrders': true,
72
- 'fetchOrder': true,
73
- 'fetchOrderBook': true,
74
- 'fetchPosition': true,
75
- 'fetchPositionMode': false,
76
- 'fetchPositions': true,
77
- 'fetchPremiumIndexOHLCV': false,
78
- 'fetchStatus': true,
79
- 'fetchTicker': true,
80
- 'fetchTickers': false,
81
- 'fetchTime': true,
82
- 'fetchTrades': true,
83
- 'fetchTransactionFee': false,
84
- 'fetchWithdrawals': true,
85
- 'setLeverage': false,
86
- 'setMarginMode': false,
87
- 'transfer': true,
88
- 'withdraw': undefined,
89
- },
90
- 'urls': {
91
- 'logo': 'https://user-images.githubusercontent.com/1294454/147508995-9e35030a-d046-43a1-a006-6fabd981b554.jpg',
92
- 'doc': [
93
- 'https://docs.kucoin.com/futures',
94
- 'https://docs.kucoin.com',
95
- ],
96
- 'www': 'https://futures.kucoin.com/',
97
- 'referral': 'https://futures.kucoin.com/?rcode=E5wkqe',
98
- 'api': {
99
- 'public': 'https://openapi-v2.kucoin.com',
100
- 'private': 'https://openapi-v2.kucoin.com',
101
- 'futuresPrivate': 'https://api-futures.kucoin.com',
102
- 'futuresPublic': 'https://api-futures.kucoin.com',
103
- 'webExchange': 'https://futures.kucoin.com/_api/web-front',
104
- },
105
- },
106
- 'requiredCredentials': {
107
- 'apiKey': true,
108
- 'secret': true,
109
- 'password': true,
110
- },
111
- 'api': {
112
- 'futuresPublic': {
113
- 'get': {
114
- 'contracts/active': 1,
115
- 'contracts/{symbol}': 1,
116
- 'contracts/risk-limit/{symbol}': 1,
117
- 'ticker': 1,
118
- 'level2/snapshot': 1.33,
119
- 'level2/depth{limit}': 1,
120
- 'level2/message/query': 1,
121
- 'level3/message/query': 1,
122
- 'level3/snapshot': 1,
123
- 'trade/history': 1,
124
- 'interest/query': 1,
125
- 'index/query': 1,
126
- 'mark-price/{symbol}/current': 1,
127
- 'premium/query': 1,
128
- 'funding-rate/{symbol}/current': 1,
129
- 'timestamp': 1,
130
- 'status': 1,
131
- 'kline/query': 1,
132
- },
133
- 'post': {
134
- 'bullet-public': 1,
135
- },
136
- },
137
- 'futuresPrivate': {
138
- 'get': {
139
- 'account-overview': 1.33,
140
- 'transaction-history': 4.44,
141
- 'deposit-address': 1,
142
- 'deposit-list': 1,
143
- 'withdrawals/quotas': 1,
144
- 'withdrawal-list': 1,
145
- 'transfer-list': 1,
146
- 'orders': 1.33,
147
- 'stopOrders': 1,
148
- 'recentDoneOrders': 1,
149
- 'orders/{orderId}': 1,
150
- 'orders/byClientOid': 1,
151
- 'fills': 4.44,
152
- 'recentFills': 4.44,
153
- 'openOrderStatistics': 1,
154
- 'position': 1,
155
- 'positions': 4.44,
156
- 'funding-history': 4.44,
157
- 'sub/api-key': 1,
158
- 'trade-statistics': 1,
159
- },
160
- 'post': {
161
- 'withdrawals': 1,
162
- 'transfer-out': 1,
163
- 'transfer-in': 1,
164
- 'orders': 1.33,
165
- 'orders/test': 1.33,
166
- 'position/margin/auto-deposit-status': 1,
167
- 'position/margin/deposit-margin': 1,
168
- 'position/risk-limit-level/change': 1,
169
- 'bullet-private': 1,
170
- 'sub/api-key': 1,
171
- 'sub/api-key/update': 1,
172
- },
173
- 'delete': {
174
- 'withdrawals/{withdrawalId}': 1,
175
- 'cancel/transfer-out': 1,
176
- 'orders/{orderId}': 1,
177
- 'orders': 4.44,
178
- 'stopOrders': 1,
179
- 'sub/api-key': 1,
180
- 'orders/client-order/{clientOid}': 1,
181
- },
182
- },
183
- 'webExchange': {
184
- 'get': {
185
- 'contract/{symbol}/funding-rates': 1,
186
- },
187
- },
188
- },
189
- 'precisionMode': number.TICK_SIZE,
190
- 'exceptions': {
191
- 'exact': {
192
- '400': errors.BadRequest,
193
- '401': errors.AuthenticationError,
194
- '403': errors.NotSupported,
195
- '404': errors.NotSupported,
196
- '405': errors.NotSupported,
197
- '415': errors.BadRequest,
198
- '429': errors.RateLimitExceeded,
199
- '500': errors.ExchangeNotAvailable,
200
- '503': errors.ExchangeNotAvailable,
201
- '100001': errors.InvalidOrder,
202
- '100004': errors.BadRequest,
203
- '101030': errors.PermissionDenied,
204
- '200004': errors.InsufficientFunds,
205
- '230003': errors.InsufficientFunds,
206
- '260100': errors.InsufficientFunds,
207
- '300003': errors.InsufficientFunds,
208
- '300012': errors.InvalidOrder,
209
- '400001': errors.AuthenticationError,
210
- '400002': errors.InvalidNonce,
211
- '400003': errors.AuthenticationError,
212
- '400004': errors.AuthenticationError,
213
- '400005': errors.AuthenticationError,
214
- '400006': errors.AuthenticationError,
215
- '400007': errors.AuthenticationError,
216
- '404000': errors.NotSupported,
217
- '400100': errors.BadRequest,
218
- '411100': errors.AccountSuspended,
219
- '500000': errors.ExchangeNotAvailable, // Internal Server Error -- We had a problem with our server. Try again later.
220
- },
221
- 'broad': {
222
- 'Position does not exist': errors.OrderNotFound, // { "code":"200000", "msg":"Position does not exist" }
223
- },
224
- },
225
- 'fees': {
226
- 'trading': {
227
- 'tierBased': true,
228
- 'percentage': true,
229
- 'taker': this.parseNumber('0.0006'),
230
- 'maker': this.parseNumber('0.0002'),
231
- 'tiers': {
232
- 'taker': [
233
- [this.parseNumber('0'), this.parseNumber('0.0006')],
234
- [this.parseNumber('50'), this.parseNumber('0.0006')],
235
- [this.parseNumber('200'), this.parseNumber('0.0006')],
236
- [this.parseNumber('500'), this.parseNumber('0.0005')],
237
- [this.parseNumber('1000'), this.parseNumber('0.0004')],
238
- [this.parseNumber('2000'), this.parseNumber('0.0004')],
239
- [this.parseNumber('4000'), this.parseNumber('0.00038')],
240
- [this.parseNumber('8000'), this.parseNumber('0.00035')],
241
- [this.parseNumber('15000'), this.parseNumber('0.00032')],
242
- [this.parseNumber('25000'), this.parseNumber('0.0003')],
243
- [this.parseNumber('40000'), this.parseNumber('0.0003')],
244
- [this.parseNumber('60000'), this.parseNumber('0.0003')],
245
- [this.parseNumber('80000'), this.parseNumber('0.0003')],
246
- ],
247
- 'maker': [
248
- [this.parseNumber('0'), this.parseNumber('0.02')],
249
- [this.parseNumber('50'), this.parseNumber('0.015')],
250
- [this.parseNumber('200'), this.parseNumber('0.01')],
251
- [this.parseNumber('500'), this.parseNumber('0.01')],
252
- [this.parseNumber('1000'), this.parseNumber('0.01')],
253
- [this.parseNumber('2000'), this.parseNumber('0')],
254
- [this.parseNumber('4000'), this.parseNumber('0')],
255
- [this.parseNumber('8000'), this.parseNumber('0')],
256
- [this.parseNumber('15000'), this.parseNumber('-0.003')],
257
- [this.parseNumber('25000'), this.parseNumber('-0.006')],
258
- [this.parseNumber('40000'), this.parseNumber('-0.009')],
259
- [this.parseNumber('60000'), this.parseNumber('-0.012')],
260
- [this.parseNumber('80000'), this.parseNumber('-0.015')],
261
- ],
262
- },
263
- },
264
- 'funding': {
265
- 'tierBased': false,
266
- 'percentage': false,
267
- 'withdraw': {},
268
- 'deposit': {},
269
- },
270
- },
271
- 'commonCurrencies': {
272
- 'HOT': 'HOTNOW',
273
- 'EDGE': 'DADI',
274
- 'WAX': 'WAXP',
275
- 'TRY': 'Trias',
276
- 'VAI': 'VAIOT',
277
- 'XBT': 'BTC',
278
- },
279
- 'timeframes': {
280
- '1m': 1,
281
- '3m': undefined,
282
- '5m': 5,
283
- '15m': 15,
284
- '30m': 30,
285
- '1h': 60,
286
- '2h': 120,
287
- '4h': 240,
288
- '6h': undefined,
289
- '8h': 480,
290
- '12h': 720,
291
- '1d': 1440,
292
- '1w': 10080,
293
- },
294
- 'options': {
295
- 'version': 'v1',
296
- 'symbolSeparator': '-',
297
- 'defaultType': 'swap',
298
- 'code': 'USDT',
299
- 'marginModes': {},
300
- 'marginTypes': {},
301
- // endpoint versions
302
- 'versions': {
303
- 'futuresPrivate': {
304
- 'POST': {
305
- 'transfer-out': 'v2',
306
- },
307
- },
308
- 'futuresPublic': {
309
- 'GET': {
310
- 'level3/snapshot': 'v2',
311
- },
312
- },
313
- },
314
- 'networks': {
315
- 'OMNI': 'omni',
316
- 'ERC20': 'eth',
317
- 'TRC20': 'trx',
318
- },
319
- // 'code': 'BTC',
320
- // 'fetchBalance': {
321
- // 'code': 'BTC',
322
- // },
323
- },
324
- });
325
- }
326
- async fetchStatus(params = {}) {
327
- /**
328
- * @method
329
- * @name kucoinfutures#fetchStatus
330
- * @description the latest known information on the availability of the exchange API
331
- * @see https://www.kucoin.com/docs/rest/futures-trading/market-data/get-service-status
332
- * @param {object} [params] extra parameters specific to the exchange API endpoint
333
- * @returns {object} a [status structure]{@link https://docs.ccxt.com/#/?id=exchange-status-structure}
334
- */
335
- const response = await this.futuresPublicGetStatus(params);
336
- //
337
- // {
338
- // "code":"200000",
339
- // "data":{
340
- // "status": "open", // open, close, cancelonly
341
- // "msg": "upgrade match engine" // remark for operation when status not open
342
- // }
343
- // }
344
- //
345
- const data = this.safeValue(response, 'data', {});
346
- const status = this.safeString(data, 'status');
347
- return {
348
- 'status': (status === 'open') ? 'ok' : 'maintenance',
349
- 'updated': undefined,
350
- 'eta': undefined,
351
- 'url': undefined,
352
- 'info': response,
353
- };
354
- }
355
- async fetchMarkets(params = {}) {
356
- /**
357
- * @method
358
- * @name kucoinfutures#fetchMarkets
359
- * @description retrieves data on all markets for kucoinfutures
360
- * @see https://www.kucoin.com/docs/rest/futures-trading/market-data/get-symbols-list
361
- * @param {object} [params] extra parameters specific to the exchange api endpoint
362
- * @returns {object[]} an array of objects representing market data
363
- */
364
- const response = await this.futuresPublicGetContractsActive(params);
365
- //
366
- // {
367
- // "code": "200000",
368
- // "data": {
369
- // "symbol": "ETHUSDTM",
370
- // "rootSymbol": "USDT",
371
- // "type": "FFWCSX",
372
- // "firstOpenDate": 1591086000000,
373
- // "expireDate": null,
374
- // "settleDate": null,
375
- // "baseCurrency": "ETH",
376
- // "quoteCurrency": "USDT",
377
- // "settleCurrency": "USDT",
378
- // "maxOrderQty": 1000000,
379
- // "maxPrice": 1000000.0000000000,
380
- // "lotSize": 1,
381
- // "tickSize": 0.05,
382
- // "indexPriceTickSize": 0.01,
383
- // "multiplier": 0.01,
384
- // "initialMargin": 0.01,
385
- // "maintainMargin": 0.005,
386
- // "maxRiskLimit": 1000000,
387
- // "minRiskLimit": 1000000,
388
- // "riskStep": 500000,
389
- // "makerFeeRate": 0.00020,
390
- // "takerFeeRate": 0.00060,
391
- // "takerFixFee": 0.0000000000,
392
- // "makerFixFee": 0.0000000000,
393
- // "settlementFee": null,
394
- // "isDeleverage": true,
395
- // "isQuanto": true,
396
- // "isInverse": false,
397
- // "markMethod": "FairPrice",
398
- // "fairMethod": "FundingRate",
399
- // "fundingBaseSymbol": ".ETHINT8H",
400
- // "fundingQuoteSymbol": ".USDTINT8H",
401
- // "fundingRateSymbol": ".ETHUSDTMFPI8H",
402
- // "indexSymbol": ".KETHUSDT",
403
- // "settlementSymbol": "",
404
- // "status": "Open",
405
- // "fundingFeeRate": 0.000535,
406
- // "predictedFundingFeeRate": 0.002197,
407
- // "openInterest": "8724443",
408
- // "turnoverOf24h": 341156641.03354263,
409
- // "volumeOf24h": 74833.54000000,
410
- // "markPrice": 4534.07,
411
- // "indexPrice":4531.92,
412
- // "lastTradePrice": 4545.4500000000,
413
- // "nextFundingRateTime": 25481884,
414
- // "maxLeverage": 100,
415
- // "sourceExchanges": [ "huobi", "Okex", "Binance", "Kucoin", "Poloniex", "Hitbtc" ],
416
- // "premiumsSymbol1M": ".ETHUSDTMPI",
417
- // "premiumsSymbol8H": ".ETHUSDTMPI8H",
418
- // "fundingBaseSymbol1M": ".ETHINT",
419
- // "fundingQuoteSymbol1M": ".USDTINT",
420
- // "lowPrice": 4456.90,
421
- // "highPrice": 4674.25,
422
- // "priceChgPct": 0.0046,
423
- // "priceChg": 21.15
424
- // }
425
- // }
426
- //
427
- const result = [];
428
- const data = this.safeValue(response, 'data', []);
429
- for (let i = 0; i < data.length; i++) {
430
- const market = data[i];
431
- const id = this.safeString(market, 'symbol');
432
- const expiry = this.safeInteger(market, 'expireDate');
433
- const future = expiry ? true : false;
434
- const swap = !future;
435
- const baseId = this.safeString(market, 'baseCurrency');
436
- const quoteId = this.safeString(market, 'quoteCurrency');
437
- const settleId = this.safeString(market, 'settleCurrency');
438
- const base = this.safeCurrencyCode(baseId);
439
- const quote = this.safeCurrencyCode(quoteId);
440
- const settle = this.safeCurrencyCode(settleId);
441
- let symbol = base + '/' + quote + ':' + settle;
442
- let type = 'swap';
443
- if (future) {
444
- symbol = symbol + '-' + this.yymmdd(expiry, '');
445
- type = 'future';
446
- }
447
- const inverse = this.safeValue(market, 'isInverse');
448
- const status = this.safeString(market, 'status');
449
- const multiplier = this.safeString(market, 'multiplier');
450
- const tickSize = this.safeNumber(market, 'tickSize');
451
- const lotSize = this.safeNumber(market, 'lotSize');
452
- let limitAmountMin = lotSize;
453
- if (limitAmountMin === undefined) {
454
- limitAmountMin = this.safeNumber(market, 'baseMinSize');
455
- }
456
- let limitAmountMax = this.safeNumber(market, 'maxOrderQty');
457
- if (limitAmountMax === undefined) {
458
- limitAmountMax = this.safeNumber(market, 'baseMaxSize');
459
- }
460
- let limitPriceMax = this.safeNumber(market, 'maxPrice');
461
- if (limitPriceMax === undefined) {
462
- const baseMinSizeString = this.safeString(market, 'baseMinSize');
463
- const quoteMaxSizeString = this.safeString(market, 'quoteMaxSize');
464
- limitPriceMax = this.parseNumber(Precise["default"].stringDiv(quoteMaxSizeString, baseMinSizeString));
465
- }
466
- result.push({
467
- 'id': id,
468
- 'symbol': symbol,
469
- 'base': base,
470
- 'quote': quote,
471
- 'settle': settle,
472
- 'baseId': baseId,
473
- 'quoteId': quoteId,
474
- 'settleId': settleId,
475
- 'type': type,
476
- 'spot': false,
477
- 'margin': false,
478
- 'swap': swap,
479
- 'future': future,
480
- 'option': false,
481
- 'active': (status === 'Open'),
482
- 'contract': true,
483
- 'linear': !inverse,
484
- 'inverse': inverse,
485
- 'taker': this.safeNumber(market, 'takerFeeRate'),
486
- 'maker': this.safeNumber(market, 'makerFeeRate'),
487
- 'contractSize': this.parseNumber(Precise["default"].stringAbs(multiplier)),
488
- 'expiry': expiry,
489
- 'expiryDatetime': this.iso8601(expiry),
490
- 'strike': undefined,
491
- 'optionType': undefined,
492
- 'precision': {
493
- 'amount': lotSize,
494
- 'price': tickSize,
495
- },
496
- 'limits': {
497
- 'leverage': {
498
- 'min': this.parseNumber('1'),
499
- 'max': this.safeNumber(market, 'maxLeverage'),
500
- },
501
- 'amount': {
502
- 'min': limitAmountMin,
503
- 'max': limitAmountMax,
504
- },
505
- 'price': {
506
- 'min': tickSize,
507
- 'max': limitPriceMax,
508
- },
509
- 'cost': {
510
- 'min': this.safeNumber(market, 'quoteMinSize'),
511
- 'max': this.safeNumber(market, 'quoteMaxSize'),
512
- },
513
- },
514
- 'created': this.safeInteger(market, 'firstOpenDate'),
515
- 'info': market,
516
- });
517
- }
518
- return result;
519
- }
520
- async fetchTime(params = {}) {
521
- /**
522
- * @method
523
- * @name kucoinfutures#fetchTime
524
- * @description fetches the current integer timestamp in milliseconds from the exchange server
525
- * @see https://www.kucoin.com/docs/rest/futures-trading/market-data/get-server-time
526
- * @param {object} [params] extra parameters specific to the exchange API endpoint
527
- * @returns {int} the current integer timestamp in milliseconds from the exchange server
528
- */
529
- const response = await this.futuresPublicGetTimestamp(params);
530
- //
531
- // {
532
- // "code": "200000",
533
- // "data": 1637385119302,
534
- // }
535
- //
536
- return this.safeInteger(response, 'data');
537
- }
538
- async fetchOHLCV(symbol, timeframe = '1m', since = undefined, limit = undefined, params = {}) {
539
- /**
540
- * @method
541
- * @name kucoinfutures#fetchOHLCV
542
- * @description fetches historical candlestick data containing the open, high, low, and close price, and the volume of a market
543
- * @see https://www.kucoin.com/docs/rest/futures-trading/market-data/get-klines
544
- * @param {string} symbol unified symbol of the market to fetch OHLCV data for
545
- * @param {string} timeframe the length of time each candle represents
546
- * @param {int} [since] timestamp in ms of the earliest candle to fetch
547
- * @param {int} [limit] the maximum amount of candles to fetch
548
- * @param {object} [params] extra parameters specific to the exchange API endpoint
549
- * @param {boolean} [params.paginate] default false, when true will automatically paginate by calling this endpoint multiple times. See in the docs all the [availble parameters](https://github.com/ccxt/ccxt/wiki/Manual#pagination-params)
550
- * @returns {int[][]} A list of candles ordered as timestamp, open, high, low, close, volume
551
- */
552
- await this.loadMarkets();
553
- let paginate = false;
554
- [paginate, params] = this.handleOptionAndParams(params, 'fetchOHLCV', 'paginate');
555
- if (paginate) {
556
- return await this.fetchPaginatedCallDeterministic('fetchOHLCV', symbol, since, limit, timeframe, params, 200);
557
- }
558
- const market = this.market(symbol);
559
- const marketId = market['id'];
560
- const parsedTimeframe = this.safeInteger(this.timeframes, timeframe);
561
- const request = {
562
- 'symbol': marketId,
563
- };
564
- if (parsedTimeframe !== undefined) {
565
- request['granularity'] = parsedTimeframe;
566
- }
567
- else {
568
- request['granularity'] = timeframe;
569
- }
570
- const duration = this.parseTimeframe(timeframe) * 1000;
571
- let endAt = this.milliseconds();
572
- if (since !== undefined) {
573
- request['from'] = since;
574
- if (limit === undefined) {
575
- limit = this.safeInteger(this.options, 'fetchOHLCVLimit', 200);
576
- }
577
- endAt = this.sum(since, limit * duration);
578
- }
579
- else if (limit !== undefined) {
580
- since = endAt - limit * duration;
581
- request['from'] = since;
582
- }
583
- request['to'] = endAt;
584
- const response = await this.futuresPublicGetKlineQuery(this.extend(request, params));
585
- //
586
- // {
587
- // "code": "200000",
588
- // "data": [
589
- // [1636459200000, 4779.3, 4792.1, 4768.7, 4770.3, 78051],
590
- // [1636460100000, 4770.25, 4778.55, 4757.55, 4777.25, 80164],
591
- // [1636461000000, 4777.25, 4791.45, 4774.5, 4791.3, 51555]
592
- // ]
593
- // }
594
- //
595
- const data = this.safeValue(response, 'data', []);
596
- return this.parseOHLCVs(data, market, timeframe, since, limit);
597
- }
598
- parseOHLCV(ohlcv, market = undefined) {
599
- //
600
- // [
601
- // "1545904980000", // Start time of the candle cycle
602
- // "0.058", // opening price
603
- // "0.049", // closing price
604
- // "0.058", // highest price
605
- // "0.049", // lowest price
606
- // "0.018", // base volume
607
- // "0.000945", // quote volume
608
- // ]
609
- //
610
- return [
611
- this.safeInteger(ohlcv, 0),
612
- this.safeNumber(ohlcv, 1),
613
- this.safeNumber(ohlcv, 2),
614
- this.safeNumber(ohlcv, 3),
615
- this.safeNumber(ohlcv, 4),
616
- this.safeNumber(ohlcv, 5),
617
- ];
618
- }
619
- async fetchDepositAddress(code, params = {}) {
620
- /**
621
- * @method
622
- * @name kucoinfutures#fetchDepositAddress
623
- * @description fetch the deposit address for a currency associated with this account
624
- * @see https://www.kucoin.com/docs/rest/funding/deposit/get-deposit-address
625
- * @param {string} code unified currency code
626
- * @param {object} [params] extra parameters specific to the exchange API endpoint
627
- * @returns {object} an [address structure]{@link https://docs.ccxt.com/#/?id=address-structure}
628
- */
629
- await this.loadMarkets();
630
- const currency = this.currency(code);
631
- const currencyId = currency['id'];
632
- const request = {
633
- 'currency': currencyId, // Currency,including XBT,USDT
634
- };
635
- const response = await this.futuresPrivateGetDepositAddress(this.extend(request, params));
636
- //
637
- // {
638
- // "code": "200000",
639
- // "data": {
640
- // "address": "0x78d3ad1c0aa1bf068e19c94a2d7b16c9c0fcd8b1",//Deposit address
641
- // "memo": null//Address tag. If the returned value is null, it means that the requested token has no memo. If you are to transfer funds from another platform to KuCoin Futures and if the token to be //transferred has memo(tag), you need to fill in the memo to ensure the transferred funds will be sent //to the address you specified.
642
- // }
643
- // }
644
- //
645
- const data = this.safeValue(response, 'data', {});
646
- const address = this.safeString(data, 'address');
647
- if (currencyId !== 'NIM') {
648
- // contains spaces
649
- this.checkAddress(address);
650
- }
651
- return {
652
- 'info': response,
653
- 'currency': currencyId,
654
- 'address': address,
655
- 'tag': this.safeString(data, 'memo'),
656
- 'network': this.safeString(data, 'chain'),
657
- };
658
- }
659
- async fetchOrderBook(symbol, limit = undefined, params = {}) {
660
- /**
661
- * @method
662
- * @name kucoinfutures#fetchOrderBook
663
- * @description fetches information on open orders with bid (buy) and ask (sell) prices, volumes and other data
664
- * @see https://www.kucoin.com/docs/rest/futures-trading/market-data/get-part-order-book-level-2
665
- * @param {string} symbol unified symbol of the market to fetch the order book for
666
- * @param {int} [limit] the maximum amount of order book entries to return
667
- * @param {object} [params] extra parameters specific to the exchange API endpoint
668
- * @returns {object} A dictionary of [order book structures]{@link https://docs.ccxt.com/#/?id=order-book-structure} indexed by market symbols
669
- */
670
- await this.loadMarkets();
671
- const level = this.safeNumber(params, 'level');
672
- if (level !== 2 && level !== undefined) {
673
- throw new errors.BadRequest(this.id + ' fetchOrderBook() can only return level 2');
674
- }
675
- const market = this.market(symbol);
676
- const request = {
677
- 'symbol': market['id'],
678
- };
679
- if (limit !== undefined) {
680
- if ((limit === 20) || (limit === 100)) {
681
- request['limit'] = limit;
682
- }
683
- else {
684
- throw new errors.BadRequest(this.id + ' fetchOrderBook() limit argument must be 20 or 100');
685
- }
686
- }
687
- else {
688
- request['limit'] = 20;
689
- }
690
- const response = await this.futuresPublicGetLevel2DepthLimit(this.extend(request, params));
691
- //
692
- // {
693
- // "code": "200000",
694
- // "data": {
695
- // "symbol": "XBTUSDM", //Symbol
696
- // "sequence": 100, //Ticker sequence number
697
- // "asks": [
698
- // ["5000.0", 1000], //Price, quantity
699
- // ["6000.0", 1983] //Price, quantity
700
- // ],
701
- // "bids": [
702
- // ["3200.0", 800], //Price, quantity
703
- // ["3100.0", 100] //Price, quantity
704
- // ],
705
- // "ts": 1604643655040584408 // timestamp
706
- // }
707
- // }
708
- //
709
- const data = this.safeValue(response, 'data', {});
710
- const timestamp = this.parseToInt(this.safeInteger(data, 'ts') / 1000000);
711
- const orderbook = this.parseOrderBook(data, market['symbol'], timestamp, 'bids', 'asks', 0, 1);
712
- orderbook['nonce'] = this.safeInteger(data, 'sequence');
713
- return orderbook;
714
- }
715
- async fetchTicker(symbol, params = {}) {
716
- /**
717
- * @method
718
- * @name kucoinfutures#fetchTicker
719
- * @description fetches a price ticker, a statistical calculation with the information calculated over the past 24 hours for a specific market
720
- * @see https://www.kucoin.com/docs/rest/futures-trading/market-data/get-ticker
721
- * @param {string} symbol unified symbol of the market to fetch the ticker for
722
- * @param {object} [params] extra parameters specific to the exchange API endpoint
723
- * @returns {object} a [ticker structure]{@link https://docs.ccxt.com/#/?id=ticker-structure}
724
- */
725
- await this.loadMarkets();
726
- const market = this.market(symbol);
727
- const request = {
728
- 'symbol': market['id'],
729
- };
730
- const response = await this.futuresPublicGetTicker(this.extend(request, params));
731
- //
732
- // {
733
- // "code": "200000",
734
- // "data": {
735
- // "sequence": 1638444978558,
736
- // "symbol": "ETHUSDTM",
737
- // "side": "sell",
738
- // "size": 4,
739
- // "price": "4229.35",
740
- // "bestBidSize": 2160,
741
- // "bestBidPrice": "4229.0",
742
- // "bestAskPrice": "4229.05",
743
- // "tradeId": "61aaa8b777a0c43055fe4851",
744
- // "ts": 1638574296209786785,
745
- // "bestAskSize": 36,
746
- // }
747
- // }
748
- //
749
- return this.parseTicker(response['data'], market);
750
- }
751
- parseTicker(ticker, market = undefined) {
752
- //
753
- // {
754
- // "code": "200000",
755
- // "data": {
756
- // "sequence": 1629930362547,
757
- // "symbol": "ETHUSDTM",
758
- // "side": "buy",
759
- // "size": 130,
760
- // "price": "4724.7",
761
- // "bestBidSize": 5,
762
- // "bestBidPrice": "4724.6",
763
- // "bestAskPrice": "4724.65",
764
- // "tradeId": "618d2a5a77a0c4431d2335f4",
765
- // "ts": 1636641371963227600,
766
- // "bestAskSize": 1789
767
- // }
768
- // }
769
- //
770
- const last = this.safeString(ticker, 'price');
771
- const marketId = this.safeString(ticker, 'symbol');
772
- market = this.safeMarket(marketId, market, '-');
773
- const timestamp = this.safeIntegerProduct(ticker, 'ts', 0.000001);
774
- return this.safeTicker({
775
- 'symbol': market['symbol'],
776
- 'timestamp': timestamp,
777
- 'datetime': this.iso8601(timestamp),
778
- 'high': undefined,
779
- 'low': undefined,
780
- 'bid': this.safeString(ticker, 'bestBidPrice'),
781
- 'bidVolume': this.safeString(ticker, 'bestBidSize'),
782
- 'ask': this.safeString(ticker, 'bestAskPrice'),
783
- 'askVolume': this.safeString(ticker, 'bestAskSize'),
784
- 'vwap': undefined,
785
- 'open': undefined,
786
- 'close': last,
787
- 'last': last,
788
- 'previousClose': undefined,
789
- 'change': undefined,
790
- 'percentage': undefined,
791
- 'average': undefined,
792
- 'baseVolume': undefined,
793
- 'quoteVolume': undefined,
794
- 'info': ticker,
795
- }, market);
796
- }
797
- async fetchFundingHistory(symbol = undefined, since = undefined, limit = undefined, params = {}) {
798
- /**
799
- * @method
800
- * @name kucoinfutures#fetchFundingHistory
801
- * @description fetch the history of funding payments paid and received on this account
802
- * @see https://www.kucoin.com/docs/rest/futures-trading/funding-fees/get-funding-history
803
- * @param {string} symbol unified market symbol
804
- * @param {int} [since] the earliest time in ms to fetch funding history for
805
- * @param {int} [limit] the maximum number of funding history structures to retrieve
806
- * @param {object} [params] extra parameters specific to the exchange API endpoint
807
- * @returns {object} a [funding history structure]{@link https://docs.ccxt.com/#/?id=funding-history-structure}
808
- */
809
- if (symbol === undefined) {
810
- throw new errors.ArgumentsRequired(this.id + ' fetchFundingHistory() requires a symbol argument');
811
- }
812
- await this.loadMarkets();
813
- const market = this.market(symbol);
814
- const request = {
815
- 'symbol': market['id'],
816
- };
817
- if (since !== undefined) {
818
- request['startAt'] = since;
819
- }
820
- if (limit !== undefined) {
821
- // * Since is ignored if limit is defined
822
- request['maxCount'] = limit;
823
- }
824
- const response = await this.futuresPrivateGetFundingHistory(this.extend(request, params));
825
- //
826
- // {
827
- // "code": "200000",
828
- // "data": {
829
- // "dataList": [
830
- // {
831
- // "id": 239471298749817,
832
- // "symbol": "ETHUSDTM",
833
- // "timePoint": 1638532800000,
834
- // "fundingRate": 0.000100,
835
- // "markPrice": 4612.8300000000,
836
- // "positionQty": 12,
837
- // "positionCost": 553.5396000000,
838
- // "funding": -0.0553539600,
839
- // "settleCurrency": "USDT"
840
- // },
841
- // ...
842
- // ],
843
- // "hasMore": true
844
- // }
845
- // }
846
- //
847
- const data = this.safeValue(response, 'data');
848
- const dataList = this.safeValue(data, 'dataList', []);
849
- const fees = [];
850
- for (let i = 0; i < dataList.length; i++) {
851
- const listItem = dataList[i];
852
- const timestamp = this.safeInteger(listItem, 'timePoint');
853
- fees.push({
854
- 'info': listItem,
855
- 'symbol': symbol,
856
- 'code': this.safeCurrencyCode(this.safeString(listItem, 'settleCurrency')),
857
- 'timestamp': timestamp,
858
- 'datetime': this.iso8601(timestamp),
859
- 'id': this.safeNumber(listItem, 'id'),
860
- 'amount': this.safeNumber(listItem, 'funding'),
861
- 'fundingRate': this.safeNumber(listItem, 'fundingRate'),
862
- 'markPrice': this.safeNumber(listItem, 'markPrice'),
863
- 'positionQty': this.safeNumber(listItem, 'positionQty'),
864
- 'positionCost': this.safeNumber(listItem, 'positionCost'),
865
- });
866
- }
867
- return fees;
868
- }
869
- async fetchPosition(symbol, params = {}) {
870
- /**
871
- * @method
872
- * @name kucoinfutures#fetchPosition
873
- * @see https://docs.kucoin.com/futures/#get-position-details
874
- * @description fetch data on an open position
875
- * @param {string} symbol unified market symbol of the market the position is held in
876
- * @param {object} [params] extra parameters specific to the exchange API endpoint
877
- * @returns {object} a [position structure]{@link https://docs.ccxt.com/#/?id=position-structure}
878
- */
879
- await this.loadMarkets();
880
- const market = this.market(symbol);
881
- const request = {
882
- 'symbol': market['id'],
883
- };
884
- const response = await this.futuresPrivateGetPosition(this.extend(request, params));
885
- //
886
- // {
887
- // "code": "200000",
888
- // "data": {
889
- // "id": "6505ee6eaff4070001f651c4",
890
- // "symbol": "XBTUSDTM",
891
- // "autoDeposit": false,
892
- // "maintMarginReq": 0,
893
- // "riskLimit": 200,
894
- // "realLeverage": 0.0,
895
- // "crossMode": false,
896
- // "delevPercentage": 0.0,
897
- // "currentTimestamp": 1694887534594,
898
- // "currentQty": 0,
899
- // "currentCost": 0.0,
900
- // "currentComm": 0.0,
901
- // "unrealisedCost": 0.0,
902
- // "realisedGrossCost": 0.0,
903
- // "realisedCost": 0.0,
904
- // "isOpen": false,
905
- // "markPrice": 26611.71,
906
- // "markValue": 0.0,
907
- // "posCost": 0.0,
908
- // "posCross": 0,
909
- // "posInit": 0.0,
910
- // "posComm": 0.0,
911
- // "posLoss": 0.0,
912
- // "posMargin": 0.0,
913
- // "posMaint": 0.0,
914
- // "maintMargin": 0.0,
915
- // "realisedGrossPnl": 0.0,
916
- // "realisedPnl": 0.0,
917
- // "unrealisedPnl": 0.0,
918
- // "unrealisedPnlPcnt": 0,
919
- // "unrealisedRoePcnt": 0,
920
- // "avgEntryPrice": 0.0,
921
- // "liquidationPrice": 0.0,
922
- // "bankruptPrice": 0.0,
923
- // "settleCurrency": "USDT",
924
- // "maintainMargin": 0,
925
- // "riskLimitLevel": 1
926
- // }
927
- // }
928
- //
929
- const data = this.safeValue(response, 'data', {});
930
- return this.parsePosition(data, market);
931
- }
932
- async fetchPositions(symbols = undefined, params = {}) {
933
- /**
934
- * @method
935
- * @name kucoinfutures#fetchPositions
936
- * @description fetch all open positions
937
- * @see https://docs.kucoin.com/futures/#get-position-list
938
- * @param {string[]|undefined} symbols list of unified market symbols
939
- * @param {object} [params] extra parameters specific to the exchange API endpoint
940
- * @returns {object[]} a list of [position structure]{@link https://docs.ccxt.com/#/?id=position-structure}
941
- */
942
- await this.loadMarkets();
943
- const response = await this.futuresPrivateGetPositions(params);
944
- //
945
- // {
946
- // "code": "200000",
947
- // "data": [
948
- // {
949
- // "id": "615ba79f83a3410001cde321",
950
- // "symbol": "ETHUSDTM",
951
- // "autoDeposit": false,
952
- // "maintMarginReq": 0.005,
953
- // "riskLimit": 1000000,
954
- // "realLeverage": 18.61,
955
- // "crossMode": false,
956
- // "delevPercentage": 0.86,
957
- // "openingTimestamp": 1638563515618,
958
- // "currentTimestamp": 1638576872774,
959
- // "currentQty": 2,
960
- // "currentCost": 83.64200000,
961
- // "currentComm": 0.05018520,
962
- // "unrealisedCost": 83.64200000,
963
- // "realisedGrossCost": 0.00000000,
964
- // "realisedCost": 0.05018520,
965
- // "isOpen": true,
966
- // "markPrice": 4225.01,
967
- // "markValue": 84.50020000,
968
- // "posCost": 83.64200000,
969
- // "posCross": 0.0000000000,
970
- // "posInit": 3.63660870,
971
- // "posComm": 0.05236717,
972
- // "posLoss": 0.00000000,
973
- // "posMargin": 3.68897586,
974
- // "posMaint": 0.50637594,
975
- // "maintMargin": 4.54717586,
976
- // "realisedGrossPnl": 0.00000000,
977
- // "realisedPnl": -0.05018520,
978
- // "unrealisedPnl": 0.85820000,
979
- // "unrealisedPnlPcnt": 0.0103,
980
- // "unrealisedRoePcnt": 0.2360,
981
- // "avgEntryPrice": 4182.10,
982
- // "liquidationPrice": 4023.00,
983
- // "bankruptPrice": 4000.25,
984
- // "settleCurrency": "USDT",
985
- // "isInverse": false
986
- // }
987
- // ]
988
- // }
989
- //
990
- const data = this.safeValue(response, 'data');
991
- return this.parsePositions(data, symbols);
992
- }
993
- parsePosition(position, market = undefined) {
994
- //
995
- // {
996
- // "code": "200000",
997
- // "data": [
998
- // {
999
- // "id": "615ba79f83a3410001cde321", // Position ID
1000
- // "symbol": "ETHUSDTM", // Symbol
1001
- // "autoDeposit": false, // Auto deposit margin or not
1002
- // "maintMarginReq": 0.005, // Maintenance margin requirement
1003
- // "riskLimit": 1000000, // Risk limit
1004
- // "realLeverage": 25.92, // Leverage of the order
1005
- // "crossMode": false, // Cross mode or not
1006
- // "delevPercentage": 0.76, // ADL ranking percentile
1007
- // "openingTimestamp": 1638578546031, // Open time
1008
- // "currentTimestamp": 1638578563580, // Current timestamp
1009
- // "currentQty": 2, // Current postion quantity
1010
- // "currentCost": 83.787, // Current postion value
1011
- // "currentComm": 0.0167574, // Current commission
1012
- // "unrealisedCost": 83.787, // Unrealised value
1013
- // "realisedGrossCost": 0.0, // Accumulated realised gross profit value
1014
- // "realisedCost": 0.0167574, // Current realised position value
1015
- // "isOpen": true, // Opened position or not
1016
- // "markPrice": 4183.38, // Mark price
1017
- // "markValue": 83.6676, // Mark value
1018
- // "posCost": 83.787, // Position value
1019
- // "posCross": 0.0, // added margin
1020
- // "posInit": 3.35148, // Leverage margin
1021
- // "posComm": 0.05228309, // Bankruptcy cost
1022
- // "posLoss": 0.0, // Funding fees paid out
1023
- // "posMargin": 3.40376309, // Position margin
1024
- // "posMaint": 0.50707892, // Maintenance margin
1025
- // "maintMargin": 3.28436309, // Position margin
1026
- // "realisedGrossPnl": 0.0, // Accumulated realised gross profit value
1027
- // "realisedPnl": -0.0167574, // Realised profit and loss
1028
- // "unrealisedPnl": -0.1194, // Unrealised profit and loss
1029
- // "unrealisedPnlPcnt": -0.0014, // Profit-loss ratio of the position
1030
- // "unrealisedRoePcnt": -0.0356, // Rate of return on investment
1031
- // "avgEntryPrice": 4189.35, // Average entry price
1032
- // "liquidationPrice": 4044.55, // Liquidation price
1033
- // "bankruptPrice": 4021.75, // Bankruptcy price
1034
- // "settleCurrency": "USDT", // Currency used to clear and settle the trades
1035
- // "isInverse": false
1036
- // }
1037
- // ]
1038
- // }
1039
- //
1040
- const symbol = this.safeString(position, 'symbol');
1041
- market = this.safeMarket(symbol, market);
1042
- const timestamp = this.safeInteger(position, 'currentTimestamp');
1043
- const size = this.safeString(position, 'currentQty');
1044
- let side = undefined;
1045
- if (Precise["default"].stringGt(size, '0')) {
1046
- side = 'long';
1047
- }
1048
- else if (Precise["default"].stringLt(size, '0')) {
1049
- side = 'short';
1050
- }
1051
- const notional = Precise["default"].stringAbs(this.safeString(position, 'posCost'));
1052
- const initialMargin = this.safeString(position, 'posInit');
1053
- const initialMarginPercentage = Precise["default"].stringDiv(initialMargin, notional);
1054
- // const marginRatio = Precise.stringDiv (maintenanceRate, collateral);
1055
- const unrealisedPnl = this.safeString(position, 'unrealisedPnl');
1056
- const crossMode = this.safeValue(position, 'crossMode');
1057
- // currently crossMode is always set to false and only isolated positions are supported
1058
- const marginMode = crossMode ? 'cross' : 'isolated';
1059
- return this.safePosition({
1060
- 'info': position,
1061
- 'id': this.safeString(position, 'id'),
1062
- 'symbol': this.safeString(market, 'symbol'),
1063
- 'timestamp': timestamp,
1064
- 'datetime': this.iso8601(timestamp),
1065
- 'lastUpdateTimestamp': undefined,
1066
- 'initialMargin': this.parseNumber(initialMargin),
1067
- 'initialMarginPercentage': this.parseNumber(initialMarginPercentage),
1068
- 'maintenanceMargin': this.safeNumber(position, 'posMaint'),
1069
- 'maintenanceMarginPercentage': this.safeNumber(position, 'maintMarginReq'),
1070
- 'entryPrice': this.safeNumber(position, 'avgEntryPrice'),
1071
- 'notional': this.parseNumber(notional),
1072
- 'leverage': this.safeNumber(position, 'realLeverage'),
1073
- 'unrealizedPnl': this.parseNumber(unrealisedPnl),
1074
- 'contracts': this.parseNumber(Precise["default"].stringAbs(size)),
1075
- 'contractSize': this.safeValue(market, 'contractSize'),
1076
- 'realizedPnl': this.safeNumber(position, 'realisedPnl'),
1077
- 'marginRatio': undefined,
1078
- 'liquidationPrice': this.safeNumber(position, 'liquidationPrice'),
1079
- 'markPrice': this.safeNumber(position, 'markPrice'),
1080
- 'lastPrice': undefined,
1081
- 'collateral': this.safeNumber(position, 'maintMargin'),
1082
- 'marginMode': marginMode,
1083
- 'side': side,
1084
- 'percentage': undefined,
1085
- 'stopLossPrice': undefined,
1086
- 'takeProfitPrice': undefined,
1087
- });
1088
- }
1089
- async createOrder(symbol, type, side, amount, price = undefined, params = {}) {
1090
- /**
1091
- * @method
1092
- * @name kucoinfutures#createOrder
1093
- * @description Create an order on the exchange
1094
- * @see https://docs.kucoin.com/futures/#place-an-order
1095
- * @param {string} symbol Unified CCXT market symbol
1096
- * @param {string} type 'limit' or 'market'
1097
- * @param {string} side 'buy' or 'sell'
1098
- * @param {float} amount the amount of currency to trade
1099
- * @param {float} [price] *ignored in "market" orders* the price at which the order is to be fullfilled at in units of the quote currency
1100
- * @param {object} [params] extra parameters specific to the exchange API endpoint
1101
- * @param {float} [params.triggerPrice] The price a trigger order is triggered at
1102
- * @param {float} [params.stopLossPrice] price to trigger stop-loss orders
1103
- * @param {float} [params.takeProfitPrice] price to trigger take-profit orders
1104
- * @param {bool} [params.reduceOnly] A mark to reduce the position size only. Set to false by default. Need to set the position size when reduceOnly is true.
1105
- * @param {string} [params.timeInForce] GTC, GTT, IOC, or FOK, default is GTC, limit orders only
1106
- * @param {string} [params.postOnly] Post only flag, invalid when timeInForce is IOC or FOK
1107
- * ----------------- Exchange Specific Parameters -----------------
1108
- * @param {float} [params.leverage] Leverage size of the order
1109
- * @param {string} [params.clientOid] client order id, defaults to uuid if not passed
1110
- * @param {string} [params.remark] remark for the order, length cannot exceed 100 utf8 characters
1111
- * @param {string} [params.stop] 'up' or 'down', the direction the stopPrice is triggered from, requires stopPrice. down: Triggers when the price reaches or goes below the stopPrice. up: Triggers when the price reaches or goes above the stopPrice.
1112
- * @param {string} [params.stopPriceType] TP, IP or MP, defaults to MP: Mark Price
1113
- * @param {bool} [params.closeOrder] set to true to close position
1114
- * @param {bool} [params.test] set to true to use the test order endpoint (does not submit order, use to validate params)
1115
- * @param {bool} [params.forceHold] A mark to forcely hold the funds for an order, even though it's an order to reduce the position size. This helps the order stay on the order book and not get canceled when the position size changes. Set to false by default.
1116
- * @returns {object} an [order structure]{@link https://docs.ccxt.com/#/?id=order-structure}
1117
- */
1118
- await this.loadMarkets();
1119
- const market = this.market(symbol);
1120
- const testOrder = this.safeValue(params, 'test', false);
1121
- params = this.omit(params, 'test');
1122
- const orderRequest = this.createContractOrderRequest(symbol, type, side, amount, price, params);
1123
- let response = undefined;
1124
- if (testOrder) {
1125
- response = await this.futuresPrivatePostOrdersTest(orderRequest);
1126
- }
1127
- else {
1128
- response = await this.futuresPrivatePostOrders(orderRequest);
1129
- }
1130
- //
1131
- // {
1132
- // "code": "200000",
1133
- // "data": {
1134
- // "orderId": "619717484f1d010001510cde",
1135
- // },
1136
- // }
1137
- //
1138
- const data = this.safeValue(response, 'data', {});
1139
- return this.parseOrder(data, market);
1140
- }
1141
- async createOrders(orders, params = {}) {
1142
- /**
1143
- * @method
1144
- * @name kucoinfutures#createOrders
1145
- * @description create a list of trade orders
1146
- * @see https://www.kucoin.com/docs/rest/futures-trading/orders/place-multiple-orders
1147
- * @param {Array} orders list of orders to create, each object should contain the parameters required by createOrder, namely symbol, type, side, amount, price and params
1148
- * @param {object} [params] extra parameters specific to the exchange API endpoint
1149
- * @returns {object} an [order structure]{@link https://docs.ccxt.com/#/?id=order-structure}
1150
- */
1151
- await this.loadMarkets();
1152
- const ordersRequests = [];
1153
- for (let i = 0; i < orders.length; i++) {
1154
- const rawOrder = orders[i];
1155
- const symbol = this.safeString(rawOrder, 'symbol');
1156
- const market = this.market(symbol);
1157
- const type = this.safeString(rawOrder, 'type');
1158
- const side = this.safeString(rawOrder, 'side');
1159
- const amount = this.safeValue(rawOrder, 'amount');
1160
- const price = this.safeValue(rawOrder, 'price');
1161
- const orderParams = this.safeValue(rawOrder, 'params', {});
1162
- const orderRequest = this.createContractOrderRequest(market['id'], type, side, amount, price, orderParams);
1163
- ordersRequests.push(orderRequest);
1164
- }
1165
- const response = await this.futuresPrivatePostOrdersMulti(ordersRequests);
1166
- //
1167
- // {
1168
- // "code": "200000",
1169
- // "data": [
1170
- // {
1171
- // "orderId": "135241412609331200",
1172
- // "clientOid": "3d8fcc13-0b13-447f-ad30-4b3441e05213",
1173
- // "symbol": "LTCUSDTM",
1174
- // "code": "200000",
1175
- // "msg": "success"
1176
- // },
1177
- // {
1178
- // "orderId": "135241412747743234",
1179
- // "clientOid": "b878c7ee-ae3e-4d63-a20b-038acbb7306f",
1180
- // "symbol": "LTCUSDTM",
1181
- // "code": "200000",
1182
- // "msg": "success"
1183
- // }
1184
- // ]
1185
- // }
1186
- //
1187
- const data = this.safeValue(response, 'data', []);
1188
- return this.parseOrders(data);
1189
- }
1190
- createContractOrderRequest(symbol, type, side, amount, price = undefined, params = {}) {
1191
- const market = this.market(symbol);
1192
- // required param, cannot be used twice
1193
- const clientOrderId = this.safeString2(params, 'clientOid', 'clientOrderId', this.uuid());
1194
- params = this.omit(params, ['clientOid', 'clientOrderId']);
1195
- if (amount < 1) {
1196
- throw new errors.InvalidOrder(this.id + ' createOrder() minimum contract order amount is 1');
1197
- }
1198
- const preciseAmount = parseInt(this.amountToPrecision(symbol, amount));
1199
- const request = {
1200
- 'clientOid': clientOrderId,
1201
- 'side': side,
1202
- 'symbol': market['id'],
1203
- 'type': type,
1204
- 'size': preciseAmount,
1205
- 'leverage': 1,
1206
- };
1207
- const [triggerPrice, stopLossPrice, takeProfitPrice] = this.handleTriggerPrices(params);
1208
- const triggerPriceTypes = {
1209
- 'mark': 'MP',
1210
- 'last': 'TP',
1211
- 'index': 'IP',
1212
- };
1213
- const triggerPriceType = this.safeString(params, 'triggerPriceType', 'mark');
1214
- const triggerPriceTypeValue = this.safeString(triggerPriceTypes, triggerPriceType, triggerPriceType);
1215
- params = this.omit(params, ['stopLossPrice', 'takeProfitPrice', 'triggerPrice', 'stopPrice']);
1216
- if (triggerPrice) {
1217
- request['stop'] = (side === 'buy') ? 'up' : 'down';
1218
- request['stopPrice'] = this.priceToPrecision(symbol, triggerPrice);
1219
- request['stopPriceType'] = triggerPriceTypeValue;
1220
- }
1221
- else if (stopLossPrice || takeProfitPrice) {
1222
- if (stopLossPrice) {
1223
- request['stop'] = (side === 'buy') ? 'up' : 'down';
1224
- request['stopPrice'] = this.priceToPrecision(symbol, stopLossPrice);
1225
- }
1226
- else {
1227
- request['stop'] = (side === 'buy') ? 'down' : 'up';
1228
- request['stopPrice'] = this.priceToPrecision(symbol, takeProfitPrice);
1229
- }
1230
- request['reduceOnly'] = true;
1231
- request['stopPriceType'] = triggerPriceTypeValue;
1232
- }
1233
- const uppercaseType = type.toUpperCase();
1234
- const timeInForce = this.safeStringUpper(params, 'timeInForce');
1235
- if (uppercaseType === 'LIMIT') {
1236
- if (price === undefined) {
1237
- throw new errors.ArgumentsRequired(this.id + ' createOrder() requires a price argument for limit orders');
1238
- }
1239
- else {
1240
- request['price'] = this.priceToPrecision(symbol, price);
1241
- }
1242
- if (timeInForce !== undefined) {
1243
- request['timeInForce'] = timeInForce;
1244
- }
1245
- }
1246
- let postOnly = undefined;
1247
- [postOnly, params] = this.handlePostOnly(type === 'market', false, params);
1248
- if (postOnly) {
1249
- request['postOnly'] = true;
1250
- }
1251
- const hidden = this.safeValue(params, 'hidden');
1252
- if (postOnly && (hidden !== undefined)) {
1253
- throw new errors.BadRequest(this.id + ' createOrder() does not support the postOnly parameter together with a hidden parameter');
1254
- }
1255
- const iceberg = this.safeValue(params, 'iceberg');
1256
- if (iceberg) {
1257
- const visibleSize = this.safeValue(params, 'visibleSize');
1258
- if (visibleSize === undefined) {
1259
- throw new errors.ArgumentsRequired(this.id + ' createOrder() requires a visibleSize parameter for iceberg orders');
1260
- }
1261
- }
1262
- params = this.omit(params, ['timeInForce', 'stopPrice', 'triggerPrice', 'stopLossPrice', 'takeProfitPrice']); // Time in force only valid for limit orders, exchange error when gtc for market orders
1263
- return this.extend(request, params);
1264
- }
1265
- async cancelOrder(id, symbol = undefined, params = {}) {
1266
- /**
1267
- * @method
1268
- * @name kucoinfutures#cancelOrder
1269
- * @description cancels an open order
1270
- * @see https://www.kucoin.com/docs/rest/futures-trading/orders/cancel-futures-order-by-orderid
1271
- * @param {string} id order id
1272
- * @param {string} symbol unified symbol of the market the order was made in
1273
- * @param {object} [params] extra parameters specific to the exchange API endpoint
1274
- * @param {string} [params.clientOrderId] cancel order by client order id
1275
- * @returns {object} An [order structure]{@link https://docs.ccxt.com/#/?id=order-structure}
1276
- */
1277
- await this.loadMarkets();
1278
- const clientOrderId = this.safeString2(params, 'clientOid', 'clientOrderId');
1279
- params = this.omit(params, ['clientOrderId']);
1280
- const request = {};
1281
- let response = undefined;
1282
- if (clientOrderId !== undefined) {
1283
- if (symbol === undefined) {
1284
- throw new errors.ArgumentsRequired(this.id + ' cancelOrder() requires a symbol argument when cancelling by clientOrderId');
1285
- }
1286
- const market = this.market(symbol);
1287
- request['symbol'] = market['id'];
1288
- request['clientOid'] = clientOrderId;
1289
- response = await this.futuresPrivateDeleteOrdersClientOrderClientOid(this.extend(request, params));
1290
- }
1291
- else {
1292
- request['orderId'] = id;
1293
- response = await this.futuresPrivateDeleteOrdersOrderId(this.extend(request, params));
1294
- }
1295
- //
1296
- // {
1297
- // "code": "200000",
1298
- // "data": {
1299
- // "cancelledOrderIds": [
1300
- // "619714b8b6353000014c505a",
1301
- // ],
1302
- // },
1303
- // }
1304
- //
1305
- return this.safeValue(response, 'data');
1306
- }
1307
- async cancelAllOrders(symbol = undefined, params = {}) {
1308
- /**
1309
- * @method
1310
- * @name kucoinfutures#cancelAllOrders
1311
- * @description cancel all open orders
1312
- * @see https://www.kucoin.com/docs/rest/futures-trading/orders/cancel-multiple-futures-limit-orders
1313
- * @see https://www.kucoin.com/docs/rest/futures-trading/orders/cancel-multiple-futures-stop-orders
1314
- * @param {string} symbol unified market symbol, only orders in the market of this symbol are cancelled when symbol is not undefined
1315
- * @param {object} [params] extra parameters specific to the exchange API endpoint
1316
- * @param {object} [params.trigger] When true, all the trigger orders will be cancelled
1317
- * @returns Response from the exchange
1318
- */
1319
- await this.loadMarkets();
1320
- const request = {};
1321
- if (symbol !== undefined) {
1322
- request['symbol'] = this.marketId(symbol);
1323
- }
1324
- const stop = this.safeValue2(params, 'stop', 'trigger');
1325
- params = this.omit(params, ['stop', 'trigger']);
1326
- let response = undefined;
1327
- if (stop) {
1328
- response = await this.futuresPrivateDeleteStopOrders(this.extend(request, params));
1329
- }
1330
- else {
1331
- response = await this.futuresPrivateDeleteOrders(this.extend(request, params));
1332
- }
1333
- //
1334
- // {
1335
- // "code": "200000",
1336
- // "data": {
1337
- // "cancelledOrderIds": [
1338
- // "619714b8b6353000014c505a",
1339
- // ],
1340
- // },
1341
- // }
1342
- //
1343
- return this.safeValue(response, 'data');
1344
- }
1345
- async addMargin(symbol, amount, params = {}) {
1346
- /**
1347
- * @method
1348
- * @name kucoinfutures#addMargin
1349
- * @description add margin
1350
- * @see https://www.kucoin.com/docs/rest/futures-trading/positions/add-margin-manually
1351
- * @param {string} symbol unified market symbol
1352
- * @param {float} amount amount of margin to add
1353
- * @param {object} [params] extra parameters specific to the exchange API endpoint
1354
- * @returns {object} a [margin structure]{@link https://docs.ccxt.com/#/?id=add-margin-structure}
1355
- */
1356
- await this.loadMarkets();
1357
- const market = this.market(symbol);
1358
- const uuid = this.uuid();
1359
- const request = {
1360
- 'symbol': market['id'],
1361
- 'margin': this.amountToPrecision(symbol, amount),
1362
- 'bizNo': uuid,
1363
- };
1364
- const response = await this.futuresPrivatePostPositionMarginDepositMargin(this.extend(request, params));
1365
- //
1366
- // {
1367
- // "code": "200000",
1368
- // "data": {
1369
- // "id": "62311d26064e8f00013f2c6d",
1370
- // "symbol": "XRPUSDTM",
1371
- // "autoDeposit": false,
1372
- // "maintMarginReq": 0.01,
1373
- // "riskLimit": 200000,
1374
- // "realLeverage": 0.88,
1375
- // "crossMode": false,
1376
- // "delevPercentage": 0.4,
1377
- // "openingTimestamp": 1647385894798,
1378
- // "currentTimestamp": 1647414510672,
1379
- // "currentQty": -1,
1380
- // "currentCost": -7.658,
1381
- // "currentComm": 0.0053561,
1382
- // "unrealisedCost": -7.658,
1383
- // "realisedGrossCost": 0,
1384
- // "realisedCost": 0.0053561,
1385
- // "isOpen": true,
1386
- // "markPrice": 0.7635,
1387
- // "markValue": -7.635,
1388
- // "posCost": -7.658,
1389
- // "posCross": 1.00016084,
1390
- // "posInit": 7.658,
1391
- // "posComm": 0.00979006,
1392
- // "posLoss": 0,
1393
- // "posMargin": 8.6679509,
1394
- // "posMaint": 0.08637006,
1395
- // "maintMargin": 8.6909509,
1396
- // "realisedGrossPnl": 0,
1397
- // "realisedPnl": -0.0038335,
1398
- // "unrealisedPnl": 0.023,
1399
- // "unrealisedPnlPcnt": 0.003,
1400
- // "unrealisedRoePcnt": 0.003,
1401
- // "avgEntryPrice": 0.7658,
1402
- // "liquidationPrice": 1.6239,
1403
- // "bankruptPrice": 1.6317,
1404
- // "settleCurrency": "USDT"
1405
- // }
1406
- // }
1407
- //
1408
- //
1409
- // {
1410
- // "code":"200000",
1411
- // "msg":"Position does not exist"
1412
- // }
1413
- //
1414
- const data = this.safeValue(response, 'data');
1415
- return this.extend(this.parseMarginModification(data, market), {
1416
- 'amount': this.amountToPrecision(symbol, amount),
1417
- 'direction': 'in',
1418
- });
1419
- }
1420
- parseMarginModification(info, market = undefined) {
1421
- //
1422
- // {
1423
- // "id": "62311d26064e8f00013f2c6d",
1424
- // "symbol": "XRPUSDTM",
1425
- // "autoDeposit": false,
1426
- // "maintMarginReq": 0.01,
1427
- // "riskLimit": 200000,
1428
- // "realLeverage": 0.88,
1429
- // "crossMode": false,
1430
- // "delevPercentage": 0.4,
1431
- // "openingTimestamp": 1647385894798,
1432
- // "currentTimestamp": 1647414510672,
1433
- // "currentQty": -1,
1434
- // "currentCost": -7.658,
1435
- // "currentComm": 0.0053561,
1436
- // "unrealisedCost": -7.658,
1437
- // "realisedGrossCost": 0,
1438
- // "realisedCost": 0.0053561,
1439
- // "isOpen": true,
1440
- // "markPrice": 0.7635,
1441
- // "markValue": -7.635,
1442
- // "posCost": -7.658,
1443
- // "posCross": 1.00016084,
1444
- // "posInit": 7.658,
1445
- // "posComm": 0.00979006,
1446
- // "posLoss": 0,
1447
- // "posMargin": 8.6679509,
1448
- // "posMaint": 0.08637006,
1449
- // "maintMargin": 8.6909509,
1450
- // "realisedGrossPnl": 0,
1451
- // "realisedPnl": -0.0038335,
1452
- // "unrealisedPnl": 0.023,
1453
- // "unrealisedPnlPcnt": 0.003,
1454
- // "unrealisedRoePcnt": 0.003,
1455
- // "avgEntryPrice": 0.7658,
1456
- // "liquidationPrice": 1.6239,
1457
- // "bankruptPrice": 1.6317,
1458
- // "settleCurrency": "USDT"
1459
- // }
1460
- //
1461
- // {
1462
- // "code":"200000",
1463
- // "msg":"Position does not exist"
1464
- // }
1465
- //
1466
- const id = this.safeString(info, 'id');
1467
- market = this.safeMarket(id, market);
1468
- const currencyId = this.safeString(info, 'settleCurrency');
1469
- const crossMode = this.safeValue(info, 'crossMode');
1470
- const mode = crossMode ? 'cross' : 'isolated';
1471
- const marketId = this.safeString(market, 'symbol');
1472
- return {
1473
- 'info': info,
1474
- 'direction': undefined,
1475
- 'mode': mode,
1476
- 'amount': undefined,
1477
- 'code': this.safeCurrencyCode(currencyId),
1478
- 'symbol': this.safeSymbol(marketId, market),
1479
- 'status': undefined,
1480
- };
1481
- }
1482
- async fetchOrdersByStatus(status, symbol = undefined, since = undefined, limit = undefined, params = {}) {
1483
- /**
1484
- * @method
1485
- * @name kucoinfutures#fetchOrdersByStatus
1486
- * @description fetches a list of orders placed on the exchange
1487
- * @see https://docs.kucoin.com/futures/#get-order-list
1488
- * @see https://docs.kucoin.com/futures/#get-untriggered-stop-order-list
1489
- * @param {string} status 'active' or 'closed', only 'active' is valid for stop orders
1490
- * @param {string} symbol unified symbol for the market to retrieve orders from
1491
- * @param {int} [since] timestamp in ms of the earliest order to retrieve
1492
- * @param {int} [limit] The maximum number of orders to retrieve
1493
- * @param {object} [params] exchange specific parameters
1494
- * @param {bool} [params.trigger] set to true to retrieve untriggered stop orders
1495
- * @param {int} [params.until] End time in ms
1496
- * @param {string} [params.side] buy or sell
1497
- * @param {string} [params.type] limit or market
1498
- * @param {boolean} [params.paginate] default false, when true will automatically paginate by calling this endpoint multiple times. See in the docs all the [availble parameters](https://github.com/ccxt/ccxt/wiki/Manual#pagination-params)
1499
- * @returns An [array of order structures]{@link https://docs.ccxt.com/#/?id=order-structure}
1500
- */
1501
- await this.loadMarkets();
1502
- let paginate = false;
1503
- [paginate, params] = this.handleOptionAndParams(params, 'fetchOrdersByStatus', 'paginate');
1504
- if (paginate) {
1505
- return await this.fetchPaginatedCallDynamic('fetchOrdersByStatus', symbol, since, limit, params);
1506
- }
1507
- const stop = this.safeValue2(params, 'stop', 'trigger');
1508
- const until = this.safeInteger2(params, 'until', 'till');
1509
- params = this.omit(params, ['stop', 'until', 'till', 'trigger']);
1510
- if (status === 'closed') {
1511
- status = 'done';
1512
- }
1513
- else if (status === 'open') {
1514
- status = 'active';
1515
- }
1516
- const request = {};
1517
- if (!stop) {
1518
- request['status'] = status;
1519
- }
1520
- else if (status !== 'active') {
1521
- throw new errors.BadRequest(this.id + ' fetchOrdersByStatus() can only fetch untriggered stop orders');
1522
- }
1523
- let market = undefined;
1524
- if (symbol !== undefined) {
1525
- market = this.market(symbol);
1526
- request['symbol'] = market['id'];
1527
- }
1528
- if (since !== undefined) {
1529
- request['startAt'] = since;
1530
- }
1531
- if (until !== undefined) {
1532
- request['endAt'] = until;
1533
- }
1534
- let response = undefined;
1535
- if (stop) {
1536
- response = await this.futuresPrivateGetStopOrders(this.extend(request, params));
1537
- }
1538
- else {
1539
- response = await this.futuresPrivateGetOrders(this.extend(request, params));
1540
- }
1541
- //
1542
- // {
1543
- // "code": "200000",
1544
- // "data": {
1545
- // "currentPage": 1,
1546
- // "pageSize": 50,
1547
- // "totalNum": 4,
1548
- // "totalPage": 1,
1549
- // "items": [
1550
- // {
1551
- // "id": "64507d02921f1c0001ff6892",
1552
- // "symbol": "XBTUSDTM",
1553
- // "type": "market",
1554
- // "side": "buy",
1555
- // "price": null,
1556
- // "size": 1,
1557
- // "value": "27.992",
1558
- // "dealValue": "27.992",
1559
- // "dealSize": 1,
1560
- // "stp": "",
1561
- // "stop": "",
1562
- // "stopPriceType": "",
1563
- // "stopTriggered": false,
1564
- // "stopPrice": null,
1565
- // "timeInForce": "GTC",
1566
- // "postOnly": false,
1567
- // "hidden": false,
1568
- // "iceberg": false,
1569
- // "leverage": "17",
1570
- // "forceHold": false,
1571
- // "closeOrder": false,
1572
- // "visibleSize": null,
1573
- // "clientOid": null,
1574
- // "remark": null,
1575
- // "tags": null,
1576
- // "isActive": false,
1577
- // "cancelExist": false,
1578
- // "createdAt": 1682996482000,
1579
- // "updatedAt": 1682996483062,
1580
- // "endAt": 1682996483062,
1581
- // "orderTime": 1682996482953900677,
1582
- // "settleCurrency": "USDT",
1583
- // "status": "done",
1584
- // "filledValue": "27.992",
1585
- // "filledSize": 1,
1586
- // "reduceOnly": false
1587
- // }
1588
- // ]
1589
- // }
1590
- // }
1591
- //
1592
- const responseData = this.safeValue(response, 'data', {});
1593
- const orders = this.safeValue(responseData, 'items', []);
1594
- return this.parseOrders(orders, market, since, limit);
1595
- }
1596
- async fetchClosedOrders(symbol = undefined, since = undefined, limit = undefined, params = {}) {
1597
- /**
1598
- * @method
1599
- * @name kucoinfutures#fetchClosedOrders
1600
- * @description fetches information on multiple closed orders made by the user
1601
- * @see https://docs.kucoin.com/futures/#get-order-list
1602
- * @param {string} symbol unified market symbol of the market orders were made in
1603
- * @param {int} [since] the earliest time in ms to fetch orders for
1604
- * @param {int} [limit] the maximum number of order structures to retrieve
1605
- * @param {object} [params] extra parameters specific to the exchange API endpoint
1606
- * @param {int} [params.till] end time in ms
1607
- * @param {string} [params.side] buy or sell
1608
- * @param {string} [params.type] limit, or market
1609
- * @param {boolean} [params.paginate] default false, when true will automatically paginate by calling this endpoint multiple times. See in the docs all the [availble parameters](https://github.com/ccxt/ccxt/wiki/Manual#pagination-params)
1610
- * @returns {Order[]} a list of [order structures]{@link https://docs.ccxt.com/#/?id=order-structure}
1611
- */
1612
- await this.loadMarkets();
1613
- let paginate = false;
1614
- [paginate, params] = this.handleOptionAndParams(params, 'fetchClosedOrders', 'paginate');
1615
- if (paginate) {
1616
- return await this.fetchPaginatedCallDynamic('fetchClosedOrders', symbol, since, limit, params);
1617
- }
1618
- return await this.fetchOrdersByStatus('done', symbol, since, limit, params);
1619
- }
1620
- async fetchOrder(id = undefined, symbol = undefined, params = {}) {
1621
- /**
1622
- * @method
1623
- * @name kucoinfutures#fetchOrder
1624
- * @description fetches information on an order made by the user
1625
- * @see https://docs.kucoin.com/futures/#get-details-of-a-single-order
1626
- * @param {string} symbol unified symbol of the market the order was made in
1627
- * @param {object} [params] extra parameters specific to the exchange API endpoint
1628
- * @returns {object} An [order structure]{@link https://docs.ccxt.com/#/?id=order-structure}
1629
- */
1630
- await this.loadMarkets();
1631
- const request = {};
1632
- let response = undefined;
1633
- if (id === undefined) {
1634
- const clientOrderId = this.safeString2(params, 'clientOid', 'clientOrderId');
1635
- if (clientOrderId === undefined) {
1636
- throw new errors.InvalidOrder(this.id + ' fetchOrder() requires parameter id or params.clientOid');
1637
- }
1638
- request['clientOid'] = clientOrderId;
1639
- params = this.omit(params, ['clientOid', 'clientOrderId']);
1640
- response = await this.futuresPrivateGetOrdersByClientOid(this.extend(request, params));
1641
- }
1642
- else {
1643
- request['orderId'] = id;
1644
- response = await this.futuresPrivateGetOrdersOrderId(this.extend(request, params));
1645
- }
1646
- //
1647
- // {
1648
- // "code": "200000",
1649
- // "data": {
1650
- // "id": "64507d02921f1c0001ff6892",
1651
- // "symbol": "XBTUSDTM",
1652
- // "type": "market",
1653
- // "side": "buy",
1654
- // "price": null,
1655
- // "size": 1,
1656
- // "value": "27.992",
1657
- // "dealValue": "27.992",
1658
- // "dealSize": 1,
1659
- // "stp": "",
1660
- // "stop": "",
1661
- // "stopPriceType": "",
1662
- // "stopTriggered": false,
1663
- // "stopPrice": null,
1664
- // "timeInForce": "GTC",
1665
- // "postOnly": false,
1666
- // "hidden": false,
1667
- // "iceberg": false,
1668
- // "leverage": "17",
1669
- // "forceHold": false,
1670
- // "closeOrder": false,
1671
- // "visibleSize": null,
1672
- // "clientOid": null,
1673
- // "remark": null,
1674
- // "tags": null,
1675
- // "isActive": false,
1676
- // "cancelExist": false,
1677
- // "createdAt": 1682996482000,
1678
- // "updatedAt": 1682996483000,
1679
- // "endAt": 1682996483000,
1680
- // "orderTime": 1682996482953900677,
1681
- // "settleCurrency": "USDT",
1682
- // "status": "done",
1683
- // "filledSize": 1,
1684
- // "filledValue": "27.992",
1685
- // "reduceOnly": false
1686
- // }
1687
- // }
1688
- //
1689
- const market = (symbol !== undefined) ? this.market(symbol) : undefined;
1690
- const responseData = this.safeValue(response, 'data');
1691
- return this.parseOrder(responseData, market);
1692
- }
1693
- parseOrder(order, market = undefined) {
1694
- //
1695
- // fetchOrder, fetchOrdersByStatus
1696
- //
1697
- // {
1698
- // "id": "64507d02921f1c0001ff6892",
1699
- // "symbol": "XBTUSDTM",
1700
- // "type": "market",
1701
- // "side": "buy",
1702
- // "price": null,
1703
- // "size": 1,
1704
- // "value": "27.992",
1705
- // "dealValue": "27.992",
1706
- // "dealSize": 1,
1707
- // "stp": "",
1708
- // "stop": "",
1709
- // "stopPriceType": "",
1710
- // "stopTriggered": false,
1711
- // "stopPrice": null,
1712
- // "timeInForce": "GTC",
1713
- // "postOnly": false,
1714
- // "hidden": false,
1715
- // "iceberg": false,
1716
- // "leverage": "17",
1717
- // "forceHold": false,
1718
- // "closeOrder": false,
1719
- // "visibleSize": null,
1720
- // "clientOid": null,
1721
- // "remark": null,
1722
- // "tags": null,
1723
- // "isActive": false,
1724
- // "cancelExist": false,
1725
- // "createdAt": 1682996482000,
1726
- // "updatedAt": 1682996483062,
1727
- // "endAt": 1682996483062,
1728
- // "orderTime": 1682996482953900677,
1729
- // "settleCurrency": "USDT",
1730
- // "status": "done",
1731
- // "filledValue": "27.992",
1732
- // "filledSize": 1,
1733
- // "reduceOnly": false
1734
- // }
1735
- //
1736
- // createOrder
1737
- //
1738
- // {
1739
- // "orderId": "619717484f1d010001510cde"
1740
- // }
1741
- //
1742
- // createOrders
1743
- //
1744
- // {
1745
- // "orderId": "80465574458560512",
1746
- // "clientOid": "5c52e11203aa677f33e491",
1747
- // "symbol": "ETHUSDTM",
1748
- // "code": "200000",
1749
- // "msg": "success"
1750
- // }
1751
- //
1752
- const marketId = this.safeString(order, 'symbol');
1753
- market = this.safeMarket(marketId, market);
1754
- const symbol = market['symbol'];
1755
- const orderId = this.safeString2(order, 'id', 'orderId');
1756
- const type = this.safeString(order, 'type');
1757
- const timestamp = this.safeInteger(order, 'createdAt');
1758
- const datetime = this.iso8601(timestamp);
1759
- const price = this.safeString(order, 'price');
1760
- // price is zero for market order
1761
- // omitZero is called in safeOrder2
1762
- const side = this.safeString(order, 'side');
1763
- const feeCurrencyId = this.safeString(order, 'feeCurrency');
1764
- const feeCurrency = this.safeCurrencyCode(feeCurrencyId);
1765
- const feeCost = this.safeNumber(order, 'fee');
1766
- const amount = this.safeString(order, 'size');
1767
- const filled = this.safeString(order, 'filledSize');
1768
- const cost = this.safeString(order, 'filledValue');
1769
- let average = undefined;
1770
- if (Precise["default"].stringGt(filled, '0')) {
1771
- const contractSize = this.safeString(market, 'contractSize');
1772
- if (market['linear']) {
1773
- average = Precise["default"].stringDiv(cost, Precise["default"].stringMul(contractSize, filled));
1774
- }
1775
- else {
1776
- average = Precise["default"].stringDiv(Precise["default"].stringMul(contractSize, filled), cost);
1777
- }
1778
- }
1779
- // precision reported by their api is 8 d.p.
1780
- // const average = Precise.stringDiv (cost, Precise.stringMul (filled, market['contractSize']));
1781
- // bool
1782
- const isActive = this.safeValue(order, 'isActive');
1783
- const cancelExist = this.safeValue(order, 'cancelExist', false);
1784
- let status = undefined;
1785
- if (isActive !== undefined) {
1786
- status = isActive ? 'open' : 'closed';
1787
- }
1788
- status = cancelExist ? 'canceled' : status;
1789
- let fee = undefined;
1790
- if (feeCost !== undefined) {
1791
- fee = {
1792
- 'currency': feeCurrency,
1793
- 'cost': feeCost,
1794
- };
1795
- }
1796
- const clientOrderId = this.safeString(order, 'clientOid');
1797
- const timeInForce = this.safeString(order, 'timeInForce');
1798
- const stopPrice = this.safeNumber(order, 'stopPrice');
1799
- const postOnly = this.safeValue(order, 'postOnly');
1800
- const reduceOnly = this.safeValue(order, 'reduceOnly');
1801
- const lastUpdateTimestamp = this.safeInteger(order, 'updatedAt');
1802
- return this.safeOrder({
1803
- 'id': orderId,
1804
- 'clientOrderId': clientOrderId,
1805
- 'symbol': symbol,
1806
- 'type': type,
1807
- 'timeInForce': timeInForce,
1808
- 'postOnly': postOnly,
1809
- 'reduceOnly': reduceOnly,
1810
- 'side': side,
1811
- 'amount': amount,
1812
- 'price': price,
1813
- 'stopPrice': stopPrice,
1814
- 'triggerPrice': stopPrice,
1815
- 'cost': cost,
1816
- 'filled': filled,
1817
- 'remaining': undefined,
1818
- 'timestamp': timestamp,
1819
- 'datetime': datetime,
1820
- 'fee': fee,
1821
- 'status': status,
1822
- 'info': order,
1823
- 'lastTradeTimestamp': undefined,
1824
- 'lastUpdateTimestamp': lastUpdateTimestamp,
1825
- 'average': average,
1826
- 'trades': undefined,
1827
- }, market);
1828
- }
1829
- async fetchFundingRate(symbol, params = {}) {
1830
- /**
1831
- * @method
1832
- * @name kucoinfutures#fetchFundingRate
1833
- * @description fetch the current funding rate
1834
- * @see https://www.kucoin.com/docs/rest/futures-trading/market-data/get-current-funding-rate
1835
- * @param {string} symbol unified market symbol
1836
- * @param {object} [params] extra parameters specific to the exchange API endpoint
1837
- * @returns {object} a [funding rate structure]{@link https://docs.ccxt.com/#/?id=funding-rate-structure}
1838
- */
1839
- await this.loadMarkets();
1840
- const market = this.market(symbol);
1841
- const request = {
1842
- 'symbol': market['id'],
1843
- };
1844
- const response = await this.futuresPublicGetFundingRateSymbolCurrent(this.extend(request, params));
1845
- //
1846
- // {
1847
- // "code": "200000",
1848
- // "data": {
1849
- // "symbol": ".ETHUSDTMFPI8H",
1850
- // "granularity": 28800000,
1851
- // "timePoint": 1637380800000,
1852
- // "value": 0.0001,
1853
- // "predictedValue": 0.0001,
1854
- // },
1855
- // }
1856
- //
1857
- const data = this.safeValue(response, 'data');
1858
- const fundingTimestamp = this.safeNumber(data, 'timePoint');
1859
- // the website displayes the previous funding rate as "funding rate"
1860
- return {
1861
- 'info': data,
1862
- 'symbol': market['symbol'],
1863
- 'markPrice': undefined,
1864
- 'indexPrice': undefined,
1865
- 'interestRate': undefined,
1866
- 'estimatedSettlePrice': undefined,
1867
- 'timestamp': undefined,
1868
- 'datetime': undefined,
1869
- 'fundingRate': this.safeNumber(data, 'predictedValue'),
1870
- 'fundingTimestamp': undefined,
1871
- 'fundingDatetime': undefined,
1872
- 'nextFundingRate': undefined,
1873
- 'nextFundingTimestamp': undefined,
1874
- 'nextFundingDatetime': undefined,
1875
- 'previousFundingRate': this.safeNumber(data, 'value'),
1876
- 'previousFundingTimestamp': fundingTimestamp,
1877
- 'previousFundingDatetime': this.iso8601(fundingTimestamp),
1878
- };
1879
- }
1880
- parseBalance(response) {
1881
- const result = {
1882
- 'info': response,
1883
- 'timestamp': undefined,
1884
- 'datetime': undefined,
1885
- };
1886
- const data = this.safeValue(response, 'data');
1887
- const currencyId = this.safeString(data, 'currency');
1888
- const code = this.safeCurrencyCode(currencyId);
1889
- const account = this.account();
1890
- account['free'] = this.safeString(data, 'availableBalance');
1891
- account['total'] = this.safeString(data, 'accountEquity');
1892
- result[code] = account;
1893
- return this.safeBalance(result);
1894
- }
1895
- async fetchBalance(params = {}) {
1896
- /**
1897
- * @method
1898
- * @name kucoinfutures#fetchBalance
1899
- * @description query for balance and get the amount of funds available for trading or funds locked in orders
1900
- * @see https://www.kucoin.com/docs/rest/funding/funding-overview/get-account-detail-futures
1901
- * @param {object} [params] extra parameters specific to the exchange API endpoint
1902
- * @returns {object} a [balance structure]{@link https://docs.ccxt.com/#/?id=balance-structure}
1903
- */
1904
- await this.loadMarkets();
1905
- // only fetches one balance at a time
1906
- let defaultCode = this.safeString(this.options, 'code');
1907
- const fetchBalanceOptions = this.safeValue(this.options, 'fetchBalance', {});
1908
- defaultCode = this.safeString(fetchBalanceOptions, 'code', defaultCode);
1909
- const code = this.safeString(params, 'code', defaultCode);
1910
- const currency = this.currency(code);
1911
- const request = {
1912
- 'currency': currency['id'],
1913
- };
1914
- const response = await this.futuresPrivateGetAccountOverview(this.extend(request, params));
1915
- //
1916
- // {
1917
- // "code": "200000",
1918
- // "data": {
1919
- // "accountEquity": 0.00005,
1920
- // "unrealisedPNL": 0,
1921
- // "marginBalance": 0.00005,
1922
- // "positionMargin": 0,
1923
- // "orderMargin": 0,
1924
- // "frozenFunds": 0,
1925
- // "availableBalance": 0.00005,
1926
- // "currency": "XBT"
1927
- // }
1928
- // }
1929
- //
1930
- return this.parseBalance(response);
1931
- }
1932
- async transfer(code, amount, fromAccount, toAccount, params = {}) {
1933
- /**
1934
- * @method
1935
- * @name kucoinfutures#transfer
1936
- * @description transfer currency internally between wallets on the same account
1937
- * @param {string} code unified currency code
1938
- * @param {float} amount amount to transfer
1939
- * @param {string} fromAccount account to transfer from
1940
- * @param {string} toAccount account to transfer to
1941
- * @param {object} [params] extra parameters specific to the exchange API endpoint
1942
- * @returns {object} a [transfer structure]{@link https://docs.ccxt.com/#/?id=transfer-structure}
1943
- */
1944
- if ((toAccount !== 'main' && toAccount !== 'funding') || (fromAccount !== 'futures' && fromAccount !== 'future' && fromAccount !== 'contract')) {
1945
- throw new errors.BadRequest(this.id + ' transfer() only supports transfers from contract(future) account to main(funding) account');
1946
- }
1947
- await this.loadMarkets();
1948
- const currency = this.currency(code);
1949
- const amountToPrecision = this.currencyToPrecision(code, amount);
1950
- const request = {
1951
- 'currency': this.safeString(currency, 'id'),
1952
- 'amount': amountToPrecision,
1953
- };
1954
- // transfer from usdm futures wallet to spot wallet
1955
- const response = await this.futuresPrivatePostTransferOut(this.extend(request, params));
1956
- //
1957
- // {
1958
- // "code": "200000",
1959
- // "data": {
1960
- // "applyId": "5bffb63303aa675e8bbe18f9" // Transfer-out request ID
1961
- // }
1962
- // }
1963
- //
1964
- const data = this.safeValue(response, 'data');
1965
- return this.extend(this.parseTransfer(data, currency), {
1966
- 'amount': this.parseNumber(amountToPrecision),
1967
- 'fromAccount': 'future',
1968
- 'toAccount': 'spot',
1969
- });
1970
- }
1971
- parseTransfer(transfer, currency = undefined) {
1972
- //
1973
- // transfer
1974
- //
1975
- // {
1976
- // "applyId": "5bffb63303aa675e8bbe18f9" // Transfer-out request ID
1977
- // }
1978
- //
1979
- const timestamp = this.safeInteger(transfer, 'updatedAt');
1980
- return {
1981
- 'id': this.safeString(transfer, 'applyId'),
1982
- 'timestamp': timestamp,
1983
- 'datetime': this.iso8601(timestamp),
1984
- 'currency': this.safeCurrencyCode(undefined, currency),
1985
- 'amount': undefined,
1986
- 'fromAccount': undefined,
1987
- 'toAccount': undefined,
1988
- 'status': this.safeString(transfer, 'status'),
1989
- 'info': transfer,
1990
- };
1991
- }
1992
- parseTransferStatus(status) {
1993
- const statuses = {
1994
- 'PROCESSING': 'pending',
1995
- };
1996
- return this.safeString(statuses, status, status);
1997
- }
1998
- async fetchMyTrades(symbol = undefined, since = undefined, limit = undefined, params = {}) {
1999
- /**
2000
- * @method
2001
- * @name kucoinfutures#fetchMyTrades
2002
- * @see https://docs.kucoin.com/futures/#get-fills
2003
- * @description fetch all trades made by the user
2004
- * @param {string} symbol unified market symbol
2005
- * @param {int} [since] the earliest time in ms to fetch trades for
2006
- * @param {int} [limit] the maximum number of trades structures to retrieve
2007
- * @param {object} [params] extra parameters specific to the exchange API endpoint
2008
- * @param {int} [params.until] End time in ms
2009
- * @param {boolean} [params.paginate] default false, when true will automatically paginate by calling this endpoint multiple times. See in the docs all the [availble parameters](https://github.com/ccxt/ccxt/wiki/Manual#pagination-params)
2010
- * @returns {Trade[]} a list of [trade structures]{@link https://docs.ccxt.com/#/?id=trade-structure}
2011
- */
2012
- await this.loadMarkets();
2013
- let paginate = false;
2014
- [paginate, params] = this.handleOptionAndParams(params, 'fetchMyTrades', 'paginate');
2015
- if (paginate) {
2016
- return await this.fetchPaginatedCallDynamic('fetchMyTrades', symbol, since, limit, params);
2017
- }
2018
- let request = {
2019
- // orderId (String) [optional] Fills for a specific order (other parameters can be ignored if specified)
2020
- // symbol (String) [optional] Symbol of the contract
2021
- // side (String) [optional] buy or sell
2022
- // type (String) [optional] limit, market, limit_stop or market_stop
2023
- // startAt (long) [optional] Start time (milisecond)
2024
- // endAt (long) [optional] End time (milisecond)
2025
- };
2026
- let market = undefined;
2027
- if (symbol !== undefined) {
2028
- market = this.market(symbol);
2029
- request['symbol'] = market['id'];
2030
- }
2031
- if (since !== undefined) {
2032
- request['startAt'] = since;
2033
- }
2034
- [request, params] = this.handleUntilOption('endAt', request, params);
2035
- const response = await this.futuresPrivateGetFills(this.extend(request, params));
2036
- //
2037
- // {
2038
- // "code": "200000",
2039
- // "data": {
2040
- // "currentPage": 1,
2041
- // "pageSize": 1,
2042
- // "totalNum": 251915,
2043
- // "totalPage": 251915,
2044
- // "items": [
2045
- // {
2046
- // "symbol": "XBTUSDM", // Ticker symbol of the contract
2047
- // "tradeId": "5ce24c1f0c19fc3c58edc47c", // Trade ID
2048
- // "orderId": "5ce24c16b210233c36ee321d", // Order ID
2049
- // "side": "sell", // Transaction side
2050
- // "liquidity": "taker", // Liquidity- taker or maker
2051
- // "price": "8302", // Filled price
2052
- // "size": 10, // Filled amount
2053
- // "value": "0.001204529", // Order value
2054
- // "feeRate": "0.0005", // Floating fees
2055
- // "fixFee": "0.00000006", // Fixed fees
2056
- // "feeCurrency": "XBT", // Charging currency
2057
- // "stop": "", // A mark to the stop order type
2058
- // "fee": "0.0000012022", // Transaction fee
2059
- // "orderType": "limit", // Order type
2060
- // "tradeType": "trade", // Trade type (trade, liquidation, ADL or settlement)
2061
- // "createdAt": 1558334496000, // Time the order created
2062
- // "settleCurrency": "XBT", // settlement currency
2063
- // "tradeTime": 1558334496000000000 // trade time in nanosecond
2064
- // }
2065
- // ]
2066
- // }
2067
- // }
2068
- //
2069
- const data = this.safeValue(response, 'data', {});
2070
- const trades = this.safeValue(data, 'items', {});
2071
- return this.parseTrades(trades, market, since, limit);
2072
- }
2073
- async fetchTrades(symbol, since = undefined, limit = undefined, params = {}) {
2074
- /**
2075
- * @method
2076
- * @name kucoinfutures#fetchTrades
2077
- * @description get the list of most recent trades for a particular symbol
2078
- * @see https://www.kucoin.com/docs/rest/futures-trading/market-data/get-transaction-history
2079
- * @param {string} symbol unified symbol of the market to fetch trades for
2080
- * @param {int} [since] timestamp in ms of the earliest trade to fetch
2081
- * @param {int} [limit] the maximum amount of trades to fetch
2082
- * @param {object} [params] extra parameters specific to the exchange API endpoint
2083
- * @returns {Trade[]} a list of [trade structures]{@link https://docs.ccxt.com/#/?id=public-trades}
2084
- */
2085
- await this.loadMarkets();
2086
- const market = this.market(symbol);
2087
- const request = {
2088
- 'symbol': market['id'],
2089
- };
2090
- const response = await this.futuresPublicGetTradeHistory(this.extend(request, params));
2091
- //
2092
- // {
2093
- // "code": "200000",
2094
- // "data": [
2095
- // {
2096
- // "sequence": 32114961,
2097
- // "side": "buy",
2098
- // "size": 39,
2099
- // "price": "4001.6500000000",
2100
- // "takerOrderId": "61c20742f172110001e0ebe4",
2101
- // "makerOrderId": "61c2073fcfc88100010fcb5d",
2102
- // "tradeId": "61c2074277a0c473e69029b8",
2103
- // "ts": 1640105794099993896 // filled time
2104
- // }
2105
- // ]
2106
- // }
2107
- //
2108
- const trades = this.safeValue(response, 'data', []);
2109
- return this.parseTrades(trades, market, since, limit);
2110
- }
2111
- parseTrade(trade, market = undefined) {
2112
- //
2113
- // fetchTrades (public)
2114
- //
2115
- // {
2116
- // "sequence": 32114961,
2117
- // "side": "buy",
2118
- // "size": 39,
2119
- // "price": "4001.6500000000",
2120
- // "takerOrderId": "61c20742f172110001e0ebe4",
2121
- // "makerOrderId": "61c2073fcfc88100010fcb5d",
2122
- // "tradeId": "61c2074277a0c473e69029b8",
2123
- // "ts": 1640105794099993896 // filled time
2124
- // }
2125
- //
2126
- // fetchMyTrades (private) v2
2127
- //
2128
- // {
2129
- // "symbol":"BTC-USDT",
2130
- // "tradeId":"5c35c02709e4f67d5266954e",
2131
- // "orderId":"5c35c02703aa673ceec2a168",
2132
- // "counterOrderId":"5c1ab46003aa676e487fa8e3",
2133
- // "side":"buy",
2134
- // "liquidity":"taker",
2135
- // "forceTaker":true,
2136
- // "price":"0.083",
2137
- // "size":"0.8424304",
2138
- // "funds":"0.0699217232",
2139
- // "fee":"0",
2140
- // "feeRate":"0",
2141
- // "feeCurrency":"USDT",
2142
- // "stop":"",
2143
- // "type":"limit",
2144
- // "createdAt":1547026472000
2145
- // }
2146
- //
2147
- // fetchMyTrades (private) v1
2148
- //
2149
- // {
2150
- // "symbol":"DOGEUSDTM",
2151
- // "tradeId":"620ec41a96bab27b5f4ced56",
2152
- // "orderId":"620ec41a0d1d8a0001560bd0",
2153
- // "side":"sell",
2154
- // "liquidity":"taker",
2155
- // "forceTaker":true,
2156
- // "price":"0.13969",
2157
- // "size":1,
2158
- // "value":"13.969",
2159
- // "feeRate":"0.0006",
2160
- // "fixFee":"0",
2161
- // "feeCurrency":"USDT",
2162
- // "stop":"",
2163
- // "tradeTime":1645134874858018058,
2164
- // "fee":"0.0083814",
2165
- // "settleCurrency":"USDT",
2166
- // "orderType":"market",
2167
- // "tradeType":"trade",
2168
- // "createdAt":1645134874858
2169
- // }
2170
- //
2171
- // watchTrades
2172
- //
2173
- // {
2174
- // "makerUserId": "62286a4d720edf0001e81961",
2175
- // "symbol": "ADAUSDTM",
2176
- // "sequence": 41320766,
2177
- // "side": "sell",
2178
- // "size": 2,
2179
- // "price": 0.35904,
2180
- // "takerOrderId": "636dd9da9857ba00010cfa44",
2181
- // "makerOrderId": "636dd9c8df149d0001e62bc8",
2182
- // "takerUserId": "6180be22b6ab210001fa3371",
2183
- // "tradeId": "636dd9da0000d400d477eca7",
2184
- // "ts": 1668143578987357700
2185
- // }
2186
- //
2187
- const marketId = this.safeString(trade, 'symbol');
2188
- market = this.safeMarket(marketId, market, '-');
2189
- const id = this.safeString2(trade, 'tradeId', 'id');
2190
- const orderId = this.safeString(trade, 'orderId');
2191
- const takerOrMaker = this.safeString(trade, 'liquidity');
2192
- let timestamp = this.safeInteger(trade, 'ts');
2193
- if (timestamp !== undefined) {
2194
- timestamp = this.parseToInt(timestamp / 1000000);
2195
- }
2196
- else {
2197
- timestamp = this.safeInteger(trade, 'createdAt');
2198
- // if it's a historical v1 trade, the exchange returns timestamp in seconds
2199
- if (('dealValue' in trade) && (timestamp !== undefined)) {
2200
- timestamp = timestamp * 1000;
2201
- }
2202
- }
2203
- const priceString = this.safeString2(trade, 'price', 'dealPrice');
2204
- const amountString = this.safeString2(trade, 'size', 'amount');
2205
- const side = this.safeString(trade, 'side');
2206
- let fee = undefined;
2207
- const feeCostString = this.safeString(trade, 'fee');
2208
- if (feeCostString !== undefined) {
2209
- const feeCurrencyId = this.safeString(trade, 'feeCurrency');
2210
- let feeCurrency = this.safeCurrencyCode(feeCurrencyId);
2211
- if (feeCurrency === undefined) {
2212
- feeCurrency = (side === 'sell') ? market['quote'] : market['base'];
2213
- }
2214
- fee = {
2215
- 'cost': feeCostString,
2216
- 'currency': feeCurrency,
2217
- 'rate': this.safeString(trade, 'feeRate'),
2218
- };
2219
- }
2220
- let type = this.safeString2(trade, 'type', 'orderType');
2221
- if (type === 'match') {
2222
- type = undefined;
2223
- }
2224
- let costString = this.safeString2(trade, 'funds', 'value');
2225
- if (costString === undefined) {
2226
- const contractSize = this.safeString(market, 'contractSize');
2227
- const contractCost = Precise["default"].stringMul(priceString, amountString);
2228
- costString = Precise["default"].stringMul(contractCost, contractSize);
2229
- }
2230
- return this.safeTrade({
2231
- 'info': trade,
2232
- 'id': id,
2233
- 'order': orderId,
2234
- 'timestamp': timestamp,
2235
- 'datetime': this.iso8601(timestamp),
2236
- 'symbol': market['symbol'],
2237
- 'type': type,
2238
- 'takerOrMaker': takerOrMaker,
2239
- 'side': side,
2240
- 'price': priceString,
2241
- 'amount': amountString,
2242
- 'cost': costString,
2243
- 'fee': fee,
2244
- }, market);
2245
- }
2246
- async fetchDeposits(code = undefined, since = undefined, limit = undefined, params = {}) {
2247
- /**
2248
- * @method
2249
- * @name kucoinfutures#fetchDeposits
2250
- * @description fetch all deposits made to an account
2251
- * @param {string} code unified currency code
2252
- * @param {int} [since] the earliest time in ms to fetch deposits for
2253
- * @param {int} [limit] the maximum number of deposits structures to retrieve
2254
- * @param {object} [params] extra parameters specific to the exchange API endpoint
2255
- * @returns {object[]} a list of [transaction structures]{@link https://docs.ccxt.com/#/?id=transaction-structure}
2256
- */
2257
- await this.loadMarkets();
2258
- const request = {};
2259
- let currency = undefined;
2260
- if (code !== undefined) {
2261
- currency = this.currency(code);
2262
- request['currency'] = currency['id'];
2263
- }
2264
- if (limit !== undefined) {
2265
- request['pageSize'] = limit;
2266
- }
2267
- if (since !== undefined) {
2268
- request['startAt'] = since;
2269
- }
2270
- const response = await this.futuresPrivateGetDepositList(this.extend(request, params));
2271
- //
2272
- // {
2273
- // "code": "200000",
2274
- // "data": {
2275
- // "currentPage": 1,
2276
- // "pageSize": 5,
2277
- // "totalNum": 2,
2278
- // "totalPage": 1,
2279
- // "items": [
2280
- // {
2281
- // "address": "0x5f047b29041bcfdbf0e4478cdfa753a336ba6989",
2282
- // "memo": "5c247c8a03aa677cea2a251d",
2283
- // "amount": 1,
2284
- // "fee": 0.0001,
2285
- // "currency": "KCS",
2286
- // "isInner": false,
2287
- // "walletTxId": "5bbb57386d99522d9f954c5a@test004",
2288
- // "status": "SUCCESS",
2289
- // "createdAt": 1544178843000,
2290
- // "updatedAt": 1544178891000
2291
- // "remark":"foobar"
2292
- // },
2293
- // ...
2294
- // ]
2295
- // }
2296
- // }
2297
- //
2298
- const responseData = response['data']['items'];
2299
- return this.parseTransactions(responseData, currency, since, limit, { 'type': 'deposit' });
2300
- }
2301
- async fetchWithdrawals(code = undefined, since = undefined, limit = undefined, params = {}) {
2302
- /**
2303
- * @method
2304
- * @name kucoinfutures#fetchWithdrawals
2305
- * @description fetch all withdrawals made from an account
2306
- * @param {string} code unified currency code
2307
- * @param {int} [since] the earliest time in ms to fetch withdrawals for
2308
- * @param {int} [limit] the maximum number of withdrawals structures to retrieve
2309
- * @param {object} [params] extra parameters specific to the exchange API endpoint
2310
- * @returns {object[]} a list of [transaction structures]{@link https://docs.ccxt.com/#/?id=transaction-structure}
2311
- */
2312
- await this.loadMarkets();
2313
- const request = {};
2314
- let currency = undefined;
2315
- if (code !== undefined) {
2316
- currency = this.currency(code);
2317
- request['currency'] = currency['id'];
2318
- }
2319
- if (limit !== undefined) {
2320
- request['pageSize'] = limit;
2321
- }
2322
- if (since !== undefined) {
2323
- request['startAt'] = since;
2324
- }
2325
- const response = await this.futuresPrivateGetWithdrawalList(this.extend(request, params));
2326
- //
2327
- // {
2328
- // "code": "200000",
2329
- // "data": {
2330
- // "currentPage": 1,
2331
- // "pageSize": 5,
2332
- // "totalNum": 2,
2333
- // "totalPage": 1,
2334
- // "items": [
2335
- // {
2336
- // "id": "5c2dc64e03aa675aa263f1ac",
2337
- // "address": "0x5bedb060b8eb8d823e2414d82acce78d38be7fe9",
2338
- // "memo": "",
2339
- // "currency": "ETH",
2340
- // "amount": 1.0000000,
2341
- // "fee": 0.0100000,
2342
- // "walletTxId": "3e2414d82acce78d38be7fe9",
2343
- // "isInner": false,
2344
- // "status": "FAILURE",
2345
- // "createdAt": 1546503758000,
2346
- // "updatedAt": 1546504603000
2347
- // },
2348
- // ...
2349
- // ]
2350
- // }
2351
- // }
2352
- //
2353
- const responseData = response['data']['items'];
2354
- return this.parseTransactions(responseData, currency, since, limit, { 'type': 'withdrawal' });
2355
- }
2356
- async fetchMarketLeverageTiers(symbol, params = {}) {
2357
- /**
2358
- * @method
2359
- * @name kucoinfutures#fetchMarketLeverageTiers
2360
- * @description retrieve information on the maximum leverage, and maintenance margin for trades of varying trade sizes for a single market
2361
- * @see https://www.kucoin.com/docs/rest/futures-trading/risk-limit/get-futures-risk-limit-level
2362
- * @param {string} symbol unified market symbol
2363
- * @param {object} [params] extra parameters specific to the exchange API endpoint
2364
- * @returns {object} a [leverage tiers structure]{@link https://docs.ccxt.com/#/?id=leverage-tiers-structure}
2365
- */
2366
- await this.loadMarkets();
2367
- const market = this.market(symbol);
2368
- if (!market['contract']) {
2369
- throw new errors.BadRequest(this.id + ' fetchMarketLeverageTiers() supports contract markets only');
2370
- }
2371
- const request = {
2372
- 'symbol': market['id'],
2373
- };
2374
- const response = await this.futuresPublicGetContractsRiskLimitSymbol(this.extend(request, params));
2375
- //
2376
- // {
2377
- // "code": "200000",
2378
- // "data": [
2379
- // {
2380
- // "symbol": "ETHUSDTM",
2381
- // "level": 1,
2382
- // "maxRiskLimit": 300000,
2383
- // "minRiskLimit": 0,
2384
- // "maxLeverage": 100,
2385
- // "initialMargin": 0.0100000000,
2386
- // "maintainMargin": 0.0050000000
2387
- // },
2388
- // ...
2389
- // ]
2390
- // }
2391
- //
2392
- const data = this.safeValue(response, 'data');
2393
- return this.parseMarketLeverageTiers(data, market);
2394
- }
2395
- parseMarketLeverageTiers(info, market = undefined) {
2396
- /**
2397
- * @ignore
2398
- * @method
2399
- * @param {object} info Exchange market response for 1 market
2400
- * @param {object} market CCXT market
2401
- */
2402
- //
2403
- // {
2404
- // "symbol": "ETHUSDTM",
2405
- // "level": 1,
2406
- // "maxRiskLimit": 300000,
2407
- // "minRiskLimit": 0,
2408
- // "maxLeverage": 100,
2409
- // "initialMargin": 0.0100000000,
2410
- // "maintainMargin": 0.0050000000
2411
- // }
2412
- //
2413
- const tiers = [];
2414
- for (let i = 0; i < info.length; i++) {
2415
- const tier = info[i];
2416
- tiers.push({
2417
- 'tier': this.safeNumber(tier, 'level'),
2418
- 'currency': market['base'],
2419
- 'minNotional': this.safeNumber(tier, 'minRiskLimit'),
2420
- 'maxNotional': this.safeNumber(tier, 'maxRiskLimit'),
2421
- 'maintenanceMarginRate': this.safeNumber(tier, 'maintainMargin'),
2422
- 'maxLeverage': this.safeNumber(tier, 'maxLeverage'),
2423
- 'info': tier,
2424
- });
2425
- }
2426
- return tiers;
2427
- }
2428
- async fetchFundingRateHistory(symbol = undefined, since = undefined, limit = undefined, params = {}) {
2429
- /**
2430
- * @method
2431
- * @name kucoinfutures#fetchFundingRateHistory
2432
- * @see https://www.kucoin.com/docs/rest/futures-trading/funding-fees/get-public-funding-history#request-url
2433
- * @description fetches historical funding rate prices
2434
- * @param {string} symbol unified symbol of the market to fetch the funding rate history for
2435
- * @param {int} [since] not used by kucuoinfutures
2436
- * @param {int} [limit] the maximum amount of [funding rate structures]{@link https://docs.ccxt.com/#/?id=funding-rate-history-structure} to fetch
2437
- * @param {object} [params] extra parameters specific to the exchange API endpoint
2438
- * @param {int} [params.until] end time in ms
2439
- * @returns {object[]} a list of [funding rate structures]{@link https://docs.ccxt.com/#/?id=funding-rate-history-structure}
2440
- */
2441
- if (symbol === undefined) {
2442
- throw new errors.ArgumentsRequired(this.id + ' fetchFundingRateHistory() requires a symbol argument');
2443
- }
2444
- await this.loadMarkets();
2445
- const market = this.market(symbol);
2446
- const request = {
2447
- 'symbol': market['id'],
2448
- 'from': 0,
2449
- 'to': this.milliseconds(),
2450
- };
2451
- const until = this.safeInteger2(params, 'until', 'till');
2452
- params = this.omit(params, ['until', 'till']);
2453
- if (since !== undefined) {
2454
- request['from'] = since;
2455
- if (until === undefined) {
2456
- request['to'] = since + 1000 * 8 * 60 * 60 * 100;
2457
- }
2458
- }
2459
- if (until !== undefined) {
2460
- request['to'] = until;
2461
- if (since === undefined) {
2462
- request['to'] = until - 1000 * 8 * 60 * 60 * 100;
2463
- }
2464
- }
2465
- const response = await this.futuresPublicGetContractFundingRates(this.extend(request, params));
2466
- //
2467
- // {
2468
- // "code": "200000",
2469
- // "data": [
2470
- // {
2471
- // "symbol": "IDUSDTM",
2472
- // "fundingRate": 2.26E-4,
2473
- // "timepoint": 1702296000000
2474
- // }
2475
- // ]
2476
- // }
2477
- //
2478
- const data = this.safeValue(response, 'data');
2479
- return this.parseFundingRateHistories(data, market, since, limit);
2480
- }
2481
- parseFundingRateHistory(info, market = undefined) {
2482
- const timestamp = this.safeInteger(info, 'timepoint');
2483
- const marketId = this.safeString(info, 'symbol');
2484
- return {
2485
- 'info': info,
2486
- 'symbol': this.safeSymbol(marketId, market),
2487
- 'fundingRate': this.safeNumber(info, 'fundingRate'),
2488
- 'timestamp': timestamp,
2489
- 'datetime': this.iso8601(timestamp),
2490
- };
2491
- }
2492
- async closePosition(symbol, side = undefined, params = {}) {
2493
- /**
2494
- * @method
2495
- * @name kucoinfutures#closePosition
2496
- * @description closes open positions for a market
2497
- * @see https://www.kucoin.com/docs/rest/futures-trading/orders/place-order
2498
- * @param {string} symbol Unified CCXT market symbol
2499
- * @param {string} side not used by kucoinfutures closePositions
2500
- * @param {object} [params] extra parameters specific to the okx api endpoint
2501
- * @param {string} [params.clientOrderId] client order id of the order
2502
- * @returns {object[]} [A list of position structures]{@link https://docs.ccxt.com/#/?id=position-structure}
2503
- */
2504
- await this.loadMarkets();
2505
- const market = this.market(symbol);
2506
- let clientOrderId = this.safeString(params, 'clientOrderId');
2507
- const testOrder = this.safeValue(params, 'test', false);
2508
- params = this.omit(params, ['test', 'clientOrderId']);
2509
- if (clientOrderId === undefined) {
2510
- clientOrderId = this.numberToString(this.nonce());
2511
- }
2512
- const request = {
2513
- 'symbol': market['id'],
2514
- 'closeOrder': true,
2515
- 'clientOid': clientOrderId,
2516
- 'type': 'market',
2517
- };
2518
- let response = undefined;
2519
- if (testOrder) {
2520
- response = await this.futuresPrivatePostOrdersTest(this.extend(request, params));
2521
- }
2522
- else {
2523
- response = await this.futuresPrivatePostOrders(this.extend(request, params));
2524
- }
2525
- return this.parseOrder(response, market);
2526
- }
2527
- }
2528
-
2529
- module.exports = kucoinfutures;