Merge pull request #12 from binance/v2.0.0

Author: alplabin

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Change log
 
+## 2.0.0 - 2025-11-06
+
+### Updated
+- update connector dependencies to new connector
+- upgrade dependency packages
+
 ## 1.2.2 - 2024-08-21
 
 ### Updated

README.md

@@ -34,6 +34,9 @@ export BINANCE_FUTURES_API_SECRET=<the_api_secret>
 # For SPOT
 export SERVER=https://testnet.binance.vision
 
+# For Websocket Streams
+export SERVER=wss://stream.binance.com:9443
+
 # For Futures
 export FUTURES_SERVER=https://testnet.binancefuture.com
 # then the command request will be sent to the testnet.
@@ -62,58 +65,77 @@ binance-cli i | jq '.symbols[] | select(.symbol == "BNBUSDT") |.filters'
 ```bash
 # binance-cli book <symbol>
 # binance-cli book -l <limit> <symbol>
-binance-cli book bnbusdt
-binance-cli book --limit 10 bnbusdt
+binance-cli book BNBUSDT
+binance-cli book --limit 10 BNBUSDT
 ```
 
 ##### Get Trades
 ```bash
 # binance-cli trades <symbol>
-binance-cli trades bnbusdt
-binance-cli trades -l 10 bnbusdt
+binance-cli trades BNBUSDT
+binance-cli trades -l 10 BNBUSDT
+```
+
+##### UI Klines Data
+```bash
+# binance-cli ui_k <symbol> <interval>
+binance-cli ui_k BNBUSDT 1m
+binance-cli ui_k -l 1 BNBUSDT 1m
 ```
 
 ##### Get Aggregate Trades List
 ```bash
 # binance-cli at <symbol>
-binance-cli at bnbusdt
+binance-cli at BNBUSDT
 
 # get aggregate Trades List with parameters
 # binance-cli at <symbol>
-binance-cli at --limit 10 --startTime 1595937694913 --endTime 1595937794913 bnbusdt
+binance-cli at --limit 10 --startTime 1595937694913 --endTime 1595937794913 BNBUSDT
 ```
 
 ##### Get Klines Data
 ```bash
 # binance-cli k <symbol> <interval>
-binance-cli k bnbusdt 1m
-binance-cli k -l 1 bnbusdt 1m
+binance-cli k BNBUSDT 1m
+binance-cli k -l 1 BNBUSDT 1m
 
 ```
 ##### Get Average Price
 ```bash
 # binance-cli ap <symbol>
-binance-cli ap bnbusdt
+binance-cli ap BNBUSDT
 ```
 
-##### Get 24hr Ticker
+##### Get Ticker
 ```bash
 # binance-cli ticker -s <symbol>
-binance-cli ticker -s bnbusdt
+binance-cli ticker -s BNBUSDT
+```
+
+##### Get 24hr Ticker
+```bash
+# binance-cli ticker24 -s <symbol>
+binance-cli ticker24 -s BNBUSDT
+```
+
+##### Get Ticker Trading Day
+```bash
+# binance-cli td -s <symbol>
+binance-cli td -s BNBUSDT
 ```
 
 ##### Get Ticker Price
 ```bash
 binance-cli price
 # or with a symbol
-binance-cli price -s bnbusdt
+binance-cli price -s BNBUSDT
 ```
 
 ##### Get Order Book Ticker
 ```bash
 # binance-cli bt
 # binance-cli bt -s <symbol>
-binance-cli bt -s bnbusdt
+binance-cli bt -s BNBUSDT
 ```
 
 #### Listen To Streams
@@ -133,26 +155,30 @@ binance-cli buy -s BNBUSDT -t LIMIT -q 0.05 -p 350 -f GTC
 ##### Sell
 ```bash
 # place a limit sell order on BNBUSDT with price=500 and qty=0.03
-binance-cli sell -s bnbusdt -t limit -q 0.03 -p 500 -f GTC
+binance-cli sell -s BNBUSDT -t limit -q 0.03 -p 500 -f GTC
 ```
 
 ##### Get Order Details
 ```bash
-binance-cli get bnbusdt -i 12345
-binance-cli get bnbusdt -c my_order_123
+binance-cli get BNBUSDT -i 12345
+binance-cli get BNBUSDT -c my_order_123
 ```
 
 ##### Cancel An Order
 ```bash
-binance-cli cancel bnbusdt -i 12345
-binance-cli cancel bnbusdt -c my_order_123
+binance-cli cancel BNBUSDT -i 12345
+binance-cli cancel BNBUSDT -c my_order_123
 ```
 
 ##### Cancel All Open Orders
 ```bash
-binance-cli cancel_all bnbusdt
+binance-cli cancel_all BNBUSDT
 ```
 
+##### Get Account Information
+```bash
+binance-cli account
+```
 
 
 ### UM Futures

bin/binance-cli.js

@@ -225,18 +225,43 @@ program
   .option('-u, --quoteOrderQty [quoteOrderQty]', 'For market order, please see details from API document.')
   .action(async (args) => await Trade.newOrder({ side: 'SELL', ...args }))
 
-// get 24hr ticker data
+// get latest price for a symbol or symbols
 //
 // binance-cli ticker -s <symbol>
 //
 // Example:
 //  - `binance-cli ticker -s bnbusdt`
 program
   .command('ticker')
-  .description('Get 24hr ticker data')
+  .description('Get latest price for a symbol or symbols')
   .option('-s, --symbol <symbol>', 'trading symbol, e.g. bnbusdt')
   .action(async (args) => await Market.ticker(args))
 
+// get 24hr ticker data
+//
+// binance-cli ticker24 -s <symbol>
+//
+// Example:
+//  - `binance-cli ticker24 -s bnbusdt`
+program
+  .command('ticker24')
+  .description('Get 24hr ticker data')
+  .option('-s, --symbol <symbol>', 'trading symbol, e.g. bnbusdt')
+  .action(async (args) => await Market.ticker24hr(args))
+
+// get Price change statistics for a trading day
+//
+// binance-cli ticker_day -s <symbol>
+//
+// Example:
+//  - `binance-cli ticker_day -s bnbusdt`
+program
+    .command('ticker_day')
+    .alias('td')
+    .description('Get Price change statistics for a trading day')
+    .option('-s, --symbol <symbol>', 'trading symbol, e.g. bnbusdt')
+    .action(async (args) => await Market.tickerTradingDay(args))
+
 // get current server time
 //
 // Example:
@@ -259,6 +284,24 @@ program
   .option('-l, --limit <limit>', 'Default 500; max 1000.')
   .action(async (symbol, args) => await Market.trades(symbol, args.limit))
 
+// get UIKlines data
+//
+// binance-cli uik <symbol> <interval>
+//
+// Example:
+//  - `binance-cli ui_k bnbusdt 1m`
+//  - `binance-cli ui_k -l 10 -s 1722336104001 -e 1722336214030 bnbusdt 3m`
+program
+    .command('uiklines')
+    .description('Get UI Kline/Candlestick data')
+    .alias('ui_k')
+    .argument('<symbol>', 'trading symbol, e.g. bnbusdt')
+    .argument('<interval>', 'kline interval, values: 1m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M')
+    .option('-l, --limit <limit>', 'Default 500; max 1000.')
+    .option('-s, --startTime <startTime>', 'Timestamp in ms to get aggregate trades from INCLUSIVE.')
+    .option('-e, --endTime <endTime>', 'Timestamp in ms to get aggregate trades until INCLUSIVE.')
+    .action(async (symbol, interval, args) => await Market.uiKlines(symbol, interval, args))
+
 // Futures UM
 
 // get current UM futures server time

commands/futures/cm/market.js

@@ -1,33 +1,39 @@
-const { CMFutures } = require("@binance/futures-connector")
+const { 
+    DerivativesTradingCoinFutures,
+    DERIVATIVES_TRADING_COIN_FUTURES_REST_API_PROD_URL 
+} = require("@binance/derivatives-trading-coin-futures")
 const { print, printError } = require('../../../helpers/prettyPrint')
 const { checkAPIKey } = require('../../../helpers/util')
 
-const apiKey = process.env.BINANCE_FUTURES_API_KEY
-const server = process.env.FUTURES_SERVER || "https://dapi.binance.com"
+const configurationRestAPI = {
+  apiKey: process.env.BINANCE_FUTURES_API_KEY,
+  basePath: process.env.FUTURES_SERVER || DERIVATIVES_TRADING_COIN_FUTURES_REST_API_PROD_URL
+}
 
-const cmFuturesClient = new CMFutures(apiKey, null, { baseURL: server })
+const client = new DerivativesTradingCoinFutures({ configurationRestAPI })
 
-const time = async () =>
-  cmFuturesClient.getTime().then(response => print(response.data))
-    .catch(error => print(error))
+const time = async () => client.restAPI.checkServerTime().then(async response => print(await response.data()))
+      .catch(error => print(error))
 
 const exchangeInfo = async () =>
-  cmFuturesClient.getExchangeInfo().then(response => print(response.data))
+  client.restAPI.exchangeInformation().then(async response => print(await response.data()))
     .catch(error => print(error))
 
 const depth = async (symbol, limit = 100) => {
   try {
-    const result = await cmFuturesClient.getDepth(symbol, Number.parseInt(limit, 10))
-    print(result.data)
+    const result = await client.restAPI.orderBook({ symbol, limit: Number.parseInt(limit, 10) })
+    const data = await result.data()
+    print(data)
   } catch (e) {
     printError(e)
   }
 }
 
 const trades = async (symbol, limit = 500) => {
   try {
-    const result = await cmFuturesClient.getTrades(symbol, Number.parseInt(limit, 10))
-    print(result.data)
+    const result = await client.restAPI.recentTradesList({ symbol, limit: Number.parseInt(limit, 10) })
+    const data = await result.data()
+    print(data)
   } catch (e) {
     printError(e)
   }
@@ -36,8 +42,9 @@ const trades = async (symbol, limit = 500) => {
 const histTrades = async (symbol, {limit, fromId}) => {
   if (checkAPIKey(apiKey)) {
     try {
-      const result = await cmFuturesClient.getHistoricalTrades(symbol, Number.parseInt(limit, 10), fromId)
-      print(result.data)
+      const result = await client.restAPI.oldTradesLookup({symbol, limit: Number.parseInt(limit, 10), fromId})
+      const data = await result.data()
+      print(data)
     } catch (e) {
       printError(e)
     }
@@ -46,44 +53,57 @@ const histTrades = async (symbol, {limit, fromId}) => {
 
 const aggTrades = async (symbol, { fromId, startTime, endTime, limit }) => {
   try {
-    const result = await cmFuturesClient.getAggTrades(symbol, fromId, startTime, endTime, Number.parseInt(limit) )
-    print(result.data)
+    let param = {}
+    if (limit) param.limit = Number.parseInt(limit)
+
+    const result = await client.restAPI.compressedAggregateTradesList(
+        { symbol, fromId, startTime, endTime, ...param }
+    )
+    const data = await result.data()
+    print(data)
   } catch (e) {
     printError(e)
   }
 }
 
 const klines = async (symbol, interval, { startTime, endTime, limit }) => {
   try {
-    const result = await cmFuturesClient.getKlines(symbol, interval, startTime, endTime, Number.parseInt(limit))
-    print(result.data)
+    let param = {}
+    if (limit) param.limit = Number.parseInt(limit)
+
+    const result = await client.restAPI.klineCandlestickData({ symbol, interval, startTime, endTime, ...param })
+    const data = await result.data()
+    print(data)
   } catch (e) {
     printError(e)
   }
 }
 
 const ticker = async ({ symbol }) => {
   try {
-    const result = await cmFuturesClient.get24hrTicker(symbol)
-    print(result.data)
+    const result = await client.restAPI.ticker24hrPriceChangeStatistics({ symbol })
+    const data = await result.data()
+    print(data)
   } catch (e) {
     printError(e)
   }
 }
 
 const tickerPrice = async ({ symbol }) => {
   try {
-    const result = await cmFuturesClient.getPriceTicker(symbol)
-    print(result.data)
+    const result = await client.restAPI.symbolPriceTicker({ symbol })
+    const data = await result.data()
+    print(data)
   } catch (e) {
     printError(e)
   }
 }
 
 const bookTicker = async ({ symbol }) => {
   try {
-    const result = await cmFuturesClient.getBookTicker(symbol)
-    print(result.data)
+    const result = await client.restAPI.symbolOrderBookTicker({ symbol })
+    const data = await result.data()
+    print(data)
   } catch (e) {
     printError(e)
   }