ccxt 4.2.23 → 4.2.24

package/js/src/binanceus.js

@@ -13,6 +13,7 @@ export default class binanceus extends binance {
             'id': 'binanceus',
             'name': 'Binance US',
             'countries': ['US'],
+            'hostname': 'binance.us',
             'rateLimit': 50,
             'certified': false,
             'pro': true,
@@ -20,10 +21,11 @@ export default class binanceus extends binance {
                 'logo': 'https://user-images.githubusercontent.com/1294454/65177307-217b7c80-da5f-11e9-876e-0b748ba0a358.jpg',
                 'api': {
                     'web': 'https://www.binance.us',
-                    'sapi': 'https://api.binance.us/sapi/v1',
-                    'wapi': 'https://api.binance.us/wapi/v3',
                     'public': 'https://api.binance.us/api/v3',
                     'private': 'https://api.binance.us/api/v3',
+                    'sapi': 'https://api.binance.us/sapi/v1',
+                    'sapiV2': 'https://api.binance.us/sapi/v2',
+                    'sapiV3': 'https://api.binance.us/sapi/v3',
                 },
                 'www': 'https://www.binance.us',
                 'referral': 'https://www.binance.us/?ref=35005074',
@@ -84,13 +86,13 @@ export default class binanceus extends binance {
             'api': {
                 'public': {
                     'get': {
-                        'exchangeInfo': 10,
                         'ping': 1,
                         'time': 1,
-                        'depth': { 'cost': 1, 'byLimit': [[100, 1], [500, 5], [1000, 10], [5000, 50]] },
+                        'exchangeInfo': 10,
                         'trades': 1,
-                        'aggTrades': 1,
                         'historicalTrades': 5,
+                        'aggTrades': 1,
+                        'depth': { 'cost': 1, 'byLimit': [[100, 1], [500, 5], [1000, 10], [5000, 50]] },
                         'klines': 1,
                         'ticker/price': { 'cost': 1, 'noSymbol': 2 },
                         'avgPrice': 1,
@@ -101,7 +103,107 @@ export default class binanceus extends binance {
                 },
                 'private': {
                     'get': {
-                        'status': 1,
+                        'account': 10,
+                        'rateLimit/order': 20,
+                        'order': 2,
+                        'openOrders': { 'cost': 3, 'noSymbol': 40 },
+                        'myTrades': 10,
+                        'myPreventedMatches': 10,
+                        'allOrders': 10,
+                        'orderList': 2,
+                        'allOrderList': 10,
+                        'openOrderList': 3,
+                    },
+                    'post': {
+                        'order': 1,
+                        'order/test': 1,
+                        'order/cancelReplace': 1,
+                        'order/oco': 1,
+                    },
+                    'delete': {
+                        'order': 1,
+                        'openOrders': 1,
+                        'orderList': 1,
+                    },
+                },
+                'sapi': {
+                    'get': {
+                        'system/status': 1,
+                        'asset/assetDistributionHistory': 1,
+                        'asset/query/trading-fee': 1,
+                        'asset/query/trading-volume': 1,
+                        'sub-account/spotSummary': 1,
+                        'sub-account/status': 1,
+                        'otc/coinPairs': 1,
+                        'otc/orders/{orderId}': 1,
+                        'otc/orders': 1,
+                        'ocbs/orders': 1,
+                        'capital/config/getall': 1,
+                        'capital/withdraw/history': 1,
+                        'fiatpayment/query/withdraw/history': 1,
+                        'capital/deposit/address': 1,
+                        'capital/deposit/hisrec': 1,
+                        'fiatpayment/query/deposit/history': 1,
+                        'capital/sub-account/deposit/address': 1,
+                        'capital/sub-account/deposit/history': 1,
+                        'asset/query/dust-logs': 1,
+                        'asset/query/dust-assets': 1,
+                        'marketing/referral/reward/history': 1,
+                        'staking/asset': 1,
+                        'staking/stakingBalance': 1,
+                        'staking/history': 1,
+                        'staking/stakingRewardsHistory': 1,
+                        'custodian/balance': 1,
+                        'custodian/supportedAssetList': 1,
+                        'custodian/walletTransferHistory': 1,
+                        'custodian/custodianTransferHistory': 1,
+                        'custodian/openOrders': 1,
+                        'custodian/order': 1,
+                        'custodian/orderHistory': 1,
+                        'custodian/tradeHistory': 1,
+                        'custodian/settlementSetting': 1,
+                        'custodian/settlementHistory': 1,
+                        'cl/transferHistory': 1,
+                        'apipartner/checkEligibility': 1,
+                        'apipartner/rebateHistory': 1,
+                    },
+                    'post': {
+                        'otc/quotes': 1,
+                        'otc/orders': 1,
+                        'fiatpayment/withdraw/apply': 1,
+                        'capital/withdraw/apply': 1,
+                        'asset/dust': 10,
+                        'staking/stake': 1,
+                        'staking/unstake': 1,
+                        'custodian/walletTransfer': 1,
+                        'custodian/custodianTransfer': 1,
+                        'custodian/undoTransfer': 1,
+                        'custodian/order': 1,
+                        'custodian/ocoOrder': 1,
+                        'cl/transfer': 1,
+                    },
+                    'delete': {
+                        'custodian/cancelOrder': 1,
+                        'custodian/cancelOrdersBySymbol': 1,
+                        'custodian/cancelOcoOrder': 1,
+                    },
+                },
+                'sapiV2': {
+                    'get': {
+                        'cl/account': 10,
+                        'cl/alertHistory': 1,
+                    },
+                },
+                'sapiV3': {
+                    'get': {
+                        'accountStatus': 1,
+                        'apiTradingStatus': 1,
+                        'sub-account/list': 1,
+                        'sub-account/transfer/history': 1,
+                        'sub-account/assets': 1,
+                    },
+                    'post': {
+                        'sub-account/transfer': 1,
                     },
                 },
             },

package/js/src/bingx.js

@@ -6,7 +6,7 @@
 
 //  ---------------------------------------------------------------------------
 import Exchange from './abstract/bingx.js';
-import { AuthenticationError, ExchangeNotAvailable, PermissionDenied, AccountSuspended, ExchangeError, InsufficientFunds, BadRequest, OrderNotFound, DDoSProtection, BadSymbol, ArgumentsRequired, NotSupported } from './base/errors.js';
+import { AuthenticationError, PermissionDenied, AccountSuspended, ExchangeError, InsufficientFunds, BadRequest, OrderNotFound, DDoSProtection, BadSymbol, ArgumentsRequired, NotSupported } from './base/errors.js';
 import { Precise } from './base/Precise.js';
 import { sha256 } from './static_dependencies/noble-hashes/sha256.js';
 import { DECIMAL_PLACES } from './base/functions/number.js';
@@ -363,7 +363,7 @@ export default class bingx extends Exchange {
                     '100500': ExchangeError,
                     '100503': ExchangeError,
                     '80001': BadRequest,
-                    '80012': ExchangeNotAvailable,
+                    '80012': InsufficientFunds,
                     '80014': BadRequest,
                     '80016': OrderNotFound,
                     '80017': OrderNotFound,

package/js/src/bitfinex2.d.ts

@@ -1,5 +1,5 @@
 import Exchange from './abstract/bitfinex2.js';
-import type { Int, OrderSide, OrderType, Trade, OHLCV, Order, FundingRateHistory, OrderBook, Str, Transaction, Ticker, Balances, Tickers, Strings, Currency, Market } from './base/types.js';
+import type { Int, OrderSide, OrderType, Trade, OHLCV, Order, FundingRateHistory, OrderBook, Str, Transaction, Ticker, Balances, Tickers, Strings, Currency, Market, OpenInterest } from './base/types.js';
 /**
  * @class bitfinex2
  * @augments Exchange
@@ -156,6 +156,7 @@ export default class bitfinex2 extends Exchange {
         previousFundingTimestamp: any;
         previousFundingDatetime: any;
     };
-    fetchOpenInterest(symbol: string, params?: {}): Promise<import("./base/types.js").OpenInterest>;
-    parseOpenInterest(interest: any, market?: Market): import("./base/types.js").OpenInterest;
+    fetchOpenInterest(symbol: string, params?: {}): Promise<OpenInterest>;
+    fetchOpenInterestHistory(symbol: string, timeframe?: string, since?: Int, limit?: Int, params?: {}): Promise<OpenInterest[]>;
+    parseOpenInterest(interest: any, market?: Market): OpenInterest;
 }

package/js/src/bitfinex2.js

@@ -58,6 +58,7 @@ export default class bitfinex2 extends Exchange {
                 'fetchMyTrades': true,
                 'fetchOHLCV': true,
                 'fetchOpenInterest': true,
+                'fetchOpenInterestHistory': true,
                 'fetchOpenOrder': true,
                 'fetchOpenOrders': true,
                 'fetchOrder': true,
@@ -3037,7 +3038,73 @@ export default class bitfinex2 extends Exchange {
         //
         return this.parseOpenInterest(response[0], market);
     }
+    async fetchOpenInterestHistory(symbol, timeframe = '1m', since = undefined, limit = undefined, params = {}) {
+        /**
+         * @method
+         * @name bitfinex2#fetchOpenInterestHistory
+         * @description retrieves the open interest history of a currency
+         * @see https://docs.bitfinex.com/reference/rest-public-derivatives-status-history
+         * @param {string} symbol unified CCXT market symbol
+         * @param {string} timeframe the time period of each row of data, not used by bitfinex2
+         * @param {int} [since] the time in ms of the earliest record to retrieve as a unix timestamp
+         * @param {int} [limit] the number of records in the response
+         * @param {object} [params] exchange specific parameters
+         * @param {int} [params.until] the time in ms of the latest record to retrieve as a unix timestamp
+         * @param {boolean} [params.paginate] default false, when true will automatically paginate by calling this endpoint multiple times. See in the docs all the [available parameters](https://github.com/ccxt/ccxt/wiki/Manual#pagination-params)
+         * @returns An array of [open interest structures]{@link https://docs.ccxt.com/#/?id=open-interest-structure}
+         */
+        await this.loadMarkets();
+        let paginate = false;
+        [paginate, params] = this.handleOptionAndParams(params, 'fetchOpenInterestHistory', 'paginate');
+        if (paginate) {
+            return await this.fetchPaginatedCallDeterministic('fetchOpenInterestHistory', symbol, since, limit, '8h', params, 5000);
+        }
+        const market = this.market(symbol);
+        let request = {
+            'symbol': market['id'],
+        };
+        if (since !== undefined) {
+            request['start'] = since;
+        }
+        if (limit !== undefined) {
+            request['limit'] = limit;
+        }
+        [request, params] = this.handleUntilOption('end', request, params);
+        const response = await this.publicGetStatusDerivSymbolHist(this.extend(request, params));
+        //
+        //     [
+        //         [
+        //             1706295191000,       // timestamp
+        //             null,
+        //             42152.425382,        // derivative mid price
+        //             42133,               // spot mid price
+        //             null,
+        //             37671589.7853521,    // insurance fund balance
+        //             null,
+        //             1706313600000,       // timestamp of next funding
+        //             0.00018734,          // accrued funding for next period
+        //             3343,                // next funding step
+        //             null,
+        //             0.00007587,          // current funding
+        //             null,
+        //             null,
+        //             42134.1,             // mark price
+        //             null,
+        //             null,
+        //             5775.20348804,       // open interest number of contracts
+        //             null,
+        //             null,
+        //             null,
+        //             0.0005,              // average spread without funding payment
+        //             0.0025               // funding payment cap
+        //         ],
+        //     ]
+        //
+        return this.parseOpenInterests(response, market, since, limit);
+    }
     parseOpenInterest(interest, market = undefined) {
+        //
+        // fetchOpenInterest:
         //
         //     [
         //         "tXRPF0:USTF0",  // market id
@@ -3066,11 +3133,41 @@ export default class bitfinex2 extends Exchange {
         //         0.0025           // funding payment cap
         //     ]
         //
+        // fetchOpenInterestHistory:
+        //
+        //     [
+        //         1706295191000,       // timestamp
+        //         null,
+        //         42152.425382,        // derivative mid price
+        //         42133,               // spot mid price
+        //         null,
+        //         37671589.7853521,    // insurance fund balance
+        //         null,
+        //         1706313600000,       // timestamp of next funding
+        //         0.00018734,          // accrued funding for next period
+        //         3343,                // next funding step
+        //         null,
+        //         0.00007587,          // current funding
+        //         null,
+        //         null,
+        //         42134.1,             // mark price
+        //         null,
+        //         null,
+        //         5775.20348804,       // open interest number of contracts
+        //         null,
+        //         null,
+        //         null,
+        //         0.0005,              // average spread without funding payment
+        //         0.0025               // funding payment cap
+        //     ]
+        //
+        const interestLength = interest.length;
+        const openInterestIndex = (interestLength === 23) ? 17 : 18;
         const timestamp = this.safeInteger(interest, 1);
         const marketId = this.safeString(interest, 0);
         return this.safeOpenInterest({
             'symbol': this.safeSymbol(marketId, market, undefined, 'swap'),
-            'openInterestAmount': this.safeNumber(interest, 18),
+            'openInterestAmount': this.safeNumber(interest, openInterestIndex),
             'openInterestValue': undefined,
             'timestamp': timestamp,
             'datetime': this.iso8601(timestamp),

package/js/src/phemex.js

@@ -3769,7 +3769,7 @@ export default class phemex extends Exchange {
         const contracts = this.safeString(position, 'size');
         const contractSize = this.safeValue(market, 'contractSize');
         const contractSizeString = this.numberToString(contractSize);
-        const leverage = this.parseNumber(Precise.stringAbs((this.safeString(position, 'leverage', 'leverageRr'))));
+        const leverage = this.parseNumber(Precise.stringAbs((this.safeString2(position, 'leverage', 'leverageRr'))));
         const entryPriceString = this.safeString2(position, 'avgEntryPrice', 'avgEntryPriceRp');
         const rawSide = this.safeString(position, 'side');
         let side = undefined;

package/js/src/pro/bitopro.d.ts

@@ -1,5 +1,5 @@
 import bitoproRest from '../bitopro.js';
-import type { Int, OrderBook, Trade, Ticker, Balances } from '../base/types.js';
+import type { Int, OrderBook, Trade, Ticker, Balances, Market, Str } from '../base/types.js';
 import Client from '../base/ws/Client.js';
 export default class bitopro extends bitoproRest {
     describe(): any;
@@ -8,6 +8,9 @@ export default class bitopro extends bitoproRest {
     handleOrderBook(client: Client, message: any): void;
     watchTrades(symbol: string, since?: Int, limit?: Int, params?: {}): Promise<Trade[]>;
     handleTrade(client: Client, message: any): void;
+    watchMyTrades(symbol?: Str, since?: Int, limit?: Int, params?: {}): Promise<Trade[]>;
+    handleMyTrade(client: Client, message: any): void;
+    parseWsTrade(trade: any, market?: Market): Trade;
     watchTicker(symbol: string, params?: {}): Promise<Ticker>;
     handleTicker(client: Client, message: any): void;
     authenticate(url: any): void;

package/js/src/pro/bitopro.js

@@ -7,7 +7,7 @@
 // ----------------------------------------------------------------------------
 import bitoproRest from '../bitopro.js';
 import { ExchangeError } from '../base/errors.js';
-import { ArrayCache } from '../base/ws/Cache.js';
+import { ArrayCache, ArrayCacheBySymbolById } from '../base/ws/Cache.js';
 import { sha384 } from '../static_dependencies/noble-hashes/sha512.js';
 // ----------------------------------------------------------------------------
 export default class bitopro extends bitoproRest {
@@ -16,7 +16,7 @@ export default class bitopro extends bitoproRest {
             'has': {
                 'ws': true,
                 'watchBalance': true,
-                'watchMyTrades': false,
+                'watchMyTrades': true,
                 'watchOHLCV': false,
                 'watchOrderBook': true,
                 'watchOrders': false,
@@ -177,6 +177,150 @@ export default class bitopro extends bitoproRest {
         this.trades[symbol] = tradesCache;
         client.resolve(tradesCache, messageHash);
     }
+    async watchMyTrades(symbol = undefined, since = undefined, limit = undefined, params = {}) {
+        /**
+         * @method
+         * @name bitopro#watchMyTrades
+         * @description watches information on multiple trades made by the user
+         * @see https://github.com/bitoex/bitopro-offical-api-docs/blob/master/ws/private/matches_stream.md
+         * @param {string} symbol unified market symbol of the market trades were made in
+         * @param {int} [since] the earliest time in ms to fetch trades for
+         * @param {int} [limit] the maximum number of trade structures to retrieve
+         * @param {object} [params] extra parameters specific to the exchange API endpoint
+         * @returns {object[]} a list of [trade structures]{@link https://docs.ccxt.com/#/?id=trade-structure
+         */
+        this.checkRequiredCredentials();
+        await this.loadMarkets();
+        let messageHash = 'USER_TRADE';
+        if (symbol !== undefined) {
+            const market = this.market(symbol);
+            messageHash = messageHash + ':' + market['symbol'];
+        }
+        const url = this.urls['ws']['private'] + '/' + 'user-trades';
+        this.authenticate(url);
+        const trades = await this.watch(url, messageHash, undefined, messageHash);
+        if (this.newUpdates) {
+            limit = trades.getLimit(symbol, limit);
+        }
+        return this.filterBySinceLimit(trades, since, limit, 'timestamp', true);
+    }
+    handleMyTrade(client, message) {
+        //
+        //     {
+        //         "event": "USER_TRADE",
+        //         "timestamp": 1694667358782,
+        //         "datetime": "2023-09-14T12:55:58.782Z",
+        //         "data": {
+        //             "base": "usdt",
+        //             "quote": "twd",
+        //             "side": "ask",
+        //             "price": "32.039",
+        //             "volume": "1",
+        //             "fee": "6407800",
+        //             "feeCurrency": "twd",
+        //             "transactionTimestamp": 1694667358,
+        //             "eventTimestamp": 1694667358,
+        //             "orderID": 390733918,
+        //             "orderType": "LIMIT",
+        //             "matchID": "bd07673a-94b1-419e-b5ee-d7b723261a5d",
+        //             "isMarket": false,
+        //             "isMaker": false
+        //         }
+        //     }
+        //
+        const data = this.safeValue(message, 'data', {});
+        const baseId = this.safeString(data, 'base');
+        const quoteId = this.safeString(data, 'quote');
+        const base = this.safeCurrencyCode(baseId);
+        const quote = this.safeCurrencyCode(quoteId);
+        const symbol = this.symbol(base + '/' + quote);
+        const messageHash = this.safeString(message, 'event');
+        if (this.myTrades === undefined) {
+            const limit = this.safeInteger(this.options, 'tradesLimit', 1000);
+            this.myTrades = new ArrayCacheBySymbolById(limit);
+        }
+        const trades = this.myTrades;
+        const parsed = this.parseWsTrade(data);
+        trades.append(parsed);
+        client.resolve(trades, messageHash);
+        client.resolve(trades, messageHash + ':' + symbol);
+    }
+    parseWsTrade(trade, market = undefined) {
+        //
+        //     {
+        //         "base": "usdt",
+        //         "quote": "twd",
+        //         "side": "ask",
+        //         "price": "32.039",
+        //         "volume": "1",
+        //         "fee": "6407800",
+        //         "feeCurrency": "twd",
+        //         "transactionTimestamp": 1694667358,
+        //         "eventTimestamp": 1694667358,
+        //         "orderID": 390733918,
+        //         "orderType": "LIMIT",
+        //         "matchID": "bd07673a-94b1-419e-b5ee-d7b723261a5d",
+        //         "isMarket": false,
+        //         "isMaker": false
+        //     }
+        //
+        const id = this.safeString(trade, 'matchID');
+        const orderId = this.safeString(trade, 'orderID');
+        const timestamp = this.safeTimestamp(trade, 'transactionTimestamp');
+        const baseId = this.safeString(trade, 'base');
+        const quoteId = this.safeString(trade, 'quote');
+        const base = this.safeCurrencyCode(baseId);
+        const quote = this.safeCurrencyCode(quoteId);
+        const symbol = this.symbol(base + '/' + quote);
+        market = this.safeMarket(symbol, market);
+        const price = this.safeString(trade, 'price');
+        const type = this.safeStringLower(trade, 'orderType');
+        let side = this.safeString(trade, 'side');
+        if (side !== undefined) {
+            if (side === 'ask') {
+                side = 'sell';
+            }
+            else if (side === 'bid') {
+                side = 'buy';
+            }
+        }
+        const amount = this.safeString(trade, 'volume');
+        let fee = undefined;
+        const feeAmount = this.safeString(trade, 'fee');
+        const feeSymbol = this.safeCurrencyCode(this.safeString(trade, 'feeCurrency'));
+        if (feeAmount !== undefined) {
+            fee = {
+                'cost': feeAmount,
+                'currency': feeSymbol,
+                'rate': undefined,
+            };
+        }
+        const isMaker = this.safeValue(trade, 'isMaker');
+        let takerOrMaker = undefined;
+        if (isMaker !== undefined) {
+            if (isMaker) {
+                takerOrMaker = 'maker';
+            }
+            else {
+                takerOrMaker = 'taker';
+            }
+        }
+        return this.safeTrade({
+            'id': id,
+            'info': trade,
+            'order': orderId,
+            'timestamp': timestamp,
+            'datetime': this.iso8601(timestamp),
+            'symbol': symbol,
+            'takerOrMaker': takerOrMaker,
+            'type': type,
+            'side': side,
+            'price': price,
+            'amount': amount,
+            'cost': undefined,
+            'fee': fee,
+        }, market);
+    }
     async watchTicker(symbol, params = {}) {
         /**
          * @method
@@ -319,6 +463,7 @@ export default class bitopro extends bitoproRest {
             'TICKER': this.handleTicker,
             'ORDER_BOOK': this.handleOrderBook,
             'ACCOUNT_BALANCE': this.handleBalance,
+            'USER_TRADE': this.handleMyTrade,
         };
         const event = this.safeString(message, 'event');
         const method = this.safeValue(methods, event);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccxt",
-  "version": "4.2.23",
+  "version": "4.2.24",
   "description": "A JavaScript / TypeScript / Python / C# / PHP cryptocurrency trading library with support for 100+ exchanges",
   "unpkg": "dist/ccxt.browser.js",
   "type": "module",

package/skip-tests.json

@@ -338,6 +338,7 @@
         }
     },
     "bitopro": {
+        "skipWs": true,
         "skipMethods": {
             "fetchCurrencies": {
                 "precision": "not provided",