ccxt 4.2.36 → 4.2.37

package/dist/cjs/src/pro/gemini.js

@@ -16,9 +16,11 @@ class gemini extends gemini$1 {
                 'watchTicker': false,
                 'watchTickers': false,
                 'watchTrades': true,
+                'watchTradesForSymbols': true,
                 'watchMyTrades': false,
                 'watchOrders': true,
                 'watchOrderBook': true,
+                'watchOrderBookForSymbols': true,
                 'watchOHLCV': true,
             },
             'hostname': 'api.gemini.com',
@@ -67,7 +69,29 @@ class gemini extends gemini$1 {
         }
         return this.filterBySinceLimit(trades, since, limit, 'timestamp', true);
     }
+    async watchTradesForSymbols(symbols, since = undefined, limit = undefined, params = {}) {
+        /**
+         * @method
+         * @name gemini#watchTradesForSymbols
+         * @see https://docs.gemini.com/websocket-api/#multi-market-data
+         * @description get the list of most recent trades for a list of symbols
+         * @param {string[]} symbols unified symbol of the market to fetch trades for
+         * @param {int} [since] timestamp in ms of the earliest trade to fetch
+         * @param {int} [limit] the maximum amount of trades to fetch
+         * @param {object} [params] extra parameters specific to the exchange API endpoint
+         * @returns {object[]} a list of [trade structures]{@link https://docs.ccxt.com/#/?id=public-trades}
+         */
+        const trades = await this.helperForWatchMultipleConstruct('trades', symbols, params);
+        if (this.newUpdates) {
+            const first = this.safeList(trades, 0);
+            const tradeSymbol = this.safeString(first, 'symbol');
+            limit = trades.getLimit(tradeSymbol, limit);
+        }
+        return this.filterBySinceLimit(trades, since, limit, 'timestamp', true);
+    }
     parseWsTrade(trade, market = undefined) {
+        //
+        // regular v2 trade
         //
         //     {
         //         "type": "trade",
@@ -79,11 +103,31 @@ class gemini extends gemini$1 {
         //         "side": "buy"
         //     }
         //
+        // multi data trade
+        //
+        //    {
+        //        "type": "trade",
+        //        "symbol": "ETHUSD",
+        //        "tid": "1683002242170204", // this is not TS, but somewhat ID
+        //        "price": "2299.24",
+        //        "amount": "0.002662",
+        //        "makerSide": "bid"
+        //    }
+        //
         const timestamp = this.safeInteger(trade, 'timestamp');
-        const id = this.safeString(trade, 'event_id');
+        const id = this.safeString2(trade, 'event_id', 'tid');
         const priceString = this.safeString(trade, 'price');
-        const amountString = this.safeString(trade, 'quantity');
-        const side = this.safeStringLower(trade, 'side');
+        const amountString = this.safeString2(trade, 'quantity', 'amount');
+        let side = this.safeStringLower(trade, 'side');
+        if (side === undefined) {
+            const marketSide = this.safeStringLower(trade, 'makerSide');
+            if (marketSide === 'bid') {
+                side = 'sell';
+            }
+            else if (marketSide === 'ask') {
+                side = 'buy';
+            }
+        }
         const marketId = this.safeStringLower(trade, 'symbol');
         const symbol = this.safeSymbol(marketId, market);
         return this.safeTrade({
@@ -183,6 +227,34 @@ class gemini extends gemini$1 {
             client.resolve(stored, messageHash);
         }
     }
+    handleTradesForMultidata(client, trades, timestamp) {
+        if (trades !== undefined) {
+            const tradesLimit = this.safeInteger(this.options, 'tradesLimit', 1000);
+            const storesForSymbols = {};
+            for (let i = 0; i < trades.length; i++) {
+                const marketId = trades[i]['symbol'];
+                const market = this.safeMarket(marketId.toLowerCase());
+                const symbol = market['symbol'];
+                const trade = this.parseWsTrade(trades[i], market);
+                trade['timestamp'] = timestamp;
+                trade['datetime'] = this.iso8601(timestamp);
+                let stored = this.safeValue(this.trades, symbol);
+                if (stored === undefined) {
+                    stored = new Cache.ArrayCache(tradesLimit);
+                    this.trades[symbol] = stored;
+                }
+                stored.append(trade);
+                storesForSymbols[symbol] = stored;
+            }
+            const symbols = Object.keys(storesForSymbols);
+            for (let i = 0; i < symbols.length; i++) {
+                const symbol = symbols[i];
+                const stored = storesForSymbols[symbol];
+                const messageHash = 'trades:' + symbol;
+                client.resolve(stored, messageHash);
+            }
+        }
+    }
     async watchOHLCV(symbol, timeframe = '1m', since = undefined, limit = undefined, params = {}) {
         /**
          * @method
@@ -328,6 +400,93 @@ class gemini extends gemini$1 {
         this.orderbooks[symbol] = orderbook;
         client.resolve(orderbook, messageHash);
     }
+    async watchOrderBookForSymbols(symbols, limit = undefined, params = {}) {
+        /**
+         * @method
+         * @name gemini#watchOrderBookForSymbols
+         * @description watches information on open orders with bid (buy) and ask (sell) prices, volumes and other data
+         * @see https://docs.gemini.com/websocket-api/#multi-market-data
+         * @param {string[]} symbols unified array of symbols
+         * @param {int} [limit] the maximum amount of order book entries to return
+         * @param {object} [params] extra parameters specific to the exchange API endpoint
+         * @returns {object} A dictionary of [order book structures]{@link https://docs.ccxt.com/#/?id=order-book-structure} indexed by market symbols
+         */
+        const orderbook = await this.helperForWatchMultipleConstruct('orderbook', symbols, params);
+        return orderbook.limit();
+    }
+    async helperForWatchMultipleConstruct(itemHashName, symbols, params = {}) {
+        await this.loadMarkets();
+        symbols = this.marketSymbols(symbols, undefined, false, true, true);
+        const firstMarket = this.market(symbols[0]);
+        if (!firstMarket['spot'] && !firstMarket['linear']) {
+            throw new errors.NotSupported(this.id + ' watchMultiple supports only spot or linear-swap symbols');
+        }
+        const messageHashes = [];
+        const marketIds = [];
+        for (let i = 0; i < symbols.length; i++) {
+            const symbol = symbols[i];
+            const messageHash = itemHashName + ':' + symbol;
+            messageHashes.push(messageHash);
+            const market = this.market(symbol);
+            marketIds.push(market['id']);
+        }
+        const queryStr = marketIds.join(',');
+        let url = this.urls['api']['ws'] + '/v1/multimarketdata?symbols=' + queryStr + '&heartbeat=true&';
+        if (itemHashName === 'orderbook') {
+            url += 'trades=false&bids=true&offers=true';
+        }
+        else if (itemHashName === 'trades') {
+            url += 'trades=true&bids=false&offers=false';
+        }
+        return await this.watchMultiple(url, messageHashes, undefined);
+    }
+    handleOrderBookForMultidata(client, rawOrderBookChanges, timestamp, nonce) {
+        //
+        // rawOrderBookChanges
+        //
+        // [
+        //   {
+        //     delta: "4105123935484.817624",
+        //     price: "0.000000001",
+        //     reason: "initial", // initial|cancel|place
+        //     remaining: "4105123935484.817624",
+        //     side: "bid", // bid|ask
+        //     symbol: "SHIBUSD",
+        //     type: "change", // seems always change
+        //   },
+        //   ...
+        //
+        const marketId = rawOrderBookChanges[0]['symbol'];
+        const market = this.safeMarket(marketId.toLowerCase());
+        const symbol = market['symbol'];
+        const messageHash = 'orderbook:' + symbol;
+        let orderbook = this.safeDict(this.orderbooks, symbol);
+        if (orderbook === undefined) {
+            orderbook = this.orderBook();
+        }
+        const bids = orderbook['bids'];
+        const asks = orderbook['asks'];
+        for (let i = 0; i < rawOrderBookChanges.length; i++) {
+            const entry = rawOrderBookChanges[i];
+            const price = this.safeNumber(entry, 'price');
+            const size = this.safeNumber(entry, 'remaining');
+            const rawSide = this.safeString(entry, 'side');
+            if (rawSide === 'bid') {
+                bids.store(price, size);
+            }
+            else {
+                asks.store(price, size);
+            }
+        }
+        orderbook['bids'] = bids;
+        orderbook['asks'] = asks;
+        orderbook['symbol'] = symbol;
+        orderbook['nonce'] = nonce;
+        orderbook['timestamp'] = timestamp;
+        orderbook['datetime'] = this.iso8601(timestamp);
+        this.orderbooks[symbol] = orderbook;
+        client.resolve(orderbook, messageHash);
+    }
     handleL2Updates(client, message) {
         //
         //     {
@@ -408,6 +567,7 @@ class gemini extends gemini$1 {
         //         "socket_sequence": 7
         //     }
         //
+        client.lastPong = this.milliseconds();
         return message;
     }
     handleSubscription(client, message) {
@@ -610,6 +770,33 @@ class gemini extends gemini$1 {
         if (method !== undefined) {
             method.call(this, client, message);
         }
+        // handle multimarketdata
+        if (type === 'update') {
+            const ts = this.safeInteger(message, 'timestampms', this.milliseconds());
+            const eventId = this.safeInteger(message, 'eventId');
+            const events = this.safeList(message, 'events');
+            const orderBookItems = [];
+            const collectedEventsOfTrades = [];
+            for (let i = 0; i < events.length; i++) {
+                const event = events[i];
+                const eventType = this.safeString(event, 'type');
+                const isOrderBook = (eventType === 'change') && ('side' in event) && this.inArray(event['side'], ['ask', 'bid']);
+                if (isOrderBook) {
+                    orderBookItems.push(event);
+                }
+                else if (eventType === 'trade') {
+                    collectedEventsOfTrades.push(events[i]);
+                }
+            }
+            const lengthOb = orderBookItems.length;
+            if (lengthOb > 0) {
+                this.handleOrderBookForMultidata(client, orderBookItems, ts, eventId);
+            }
+            const lengthTrades = collectedEventsOfTrades.length;
+            if (lengthTrades > 0) {
+                this.handleTradesForMultidata(client, collectedEventsOfTrades, ts);
+            }
+        }
     }
     async authenticate(params = {}) {
         const url = this.safeString(params, 'url');

package/js/ccxt.d.ts

@@ -4,7 +4,7 @@ import * as functions from './src/base/functions.js';
 import * as errors from './src/base/errors.js';
 import type { Market, Trade, Fee, Ticker, OrderBook, Order, Transaction, Tickers, Currency, Balance, DepositAddress, WithdrawalResponse, DepositAddressResponse, OHLCV, Balances, PartialBalances, Dictionary, MinMax, Position, FundingRateHistory, Liquidation, FundingHistory, MarginMode, Greeks } from './src/base/types.js';
 import { BaseError, ExchangeError, PermissionDenied, AccountNotEnabled, AccountSuspended, ArgumentsRequired, BadRequest, BadSymbol, MarginModeAlreadySet, BadResponse, NullResponse, InsufficientFunds, InvalidAddress, InvalidOrder, OrderNotFound, OrderNotCached, CancelPending, OrderImmediatelyFillable, OrderNotFillable, DuplicateOrderId, NotSupported, NetworkError, DDoSProtection, RateLimitExceeded, ExchangeNotAvailable, OnMaintenance, InvalidNonce, RequestTimeout, AuthenticationError, AddressPending, NoChange } from './src/base/errors.js';
-declare const version = "4.2.35";
+declare const version = "4.2.36";
 import ace from './src/ace.js';
 import alpaca from './src/alpaca.js';
 import ascendex from './src/ascendex.js';

package/js/ccxt.js

@@ -38,7 +38,7 @@ import * as errors from './src/base/errors.js';
 import { BaseError, ExchangeError, PermissionDenied, AccountNotEnabled, AccountSuspended, ArgumentsRequired, BadRequest, BadSymbol, MarginModeAlreadySet, BadResponse, NullResponse, InsufficientFunds, InvalidAddress, InvalidOrder, OrderNotFound, OrderNotCached, CancelPending, OrderImmediatelyFillable, OrderNotFillable, DuplicateOrderId, NotSupported, NetworkError, DDoSProtection, RateLimitExceeded, ExchangeNotAvailable, OnMaintenance, InvalidNonce, RequestTimeout, AuthenticationError, AddressPending, NoChange } from './src/base/errors.js';
 //-----------------------------------------------------------------------------
 // this is updated by vss.js when building
-const version = '4.2.36';
+const version = '4.2.37';
 Exchange.ccxtVersion = version;
 //-----------------------------------------------------------------------------
 import ace from './src/ace.js';

package/js/src/base/types.d.ts

@@ -103,6 +103,7 @@ export interface Order {
     filled: number;
     remaining: number;
     stopPrice?: number;
+    triggerPrice?: number;
     takeProfitPrice?: number;
     stopLossPrice?: number;
     cost: number;
@@ -234,6 +235,7 @@ export interface Position {
     notional?: number;
     leverage?: number;
     unrealizedPnl?: number;
+    realizedPnl?: number;
     collateral?: number;
     entryPrice?: number;
     markPrice?: number;