ccxt 4.2.99 → 4.3.1

package/examples/js/create-order-with-retry.js

@@ -1,65 +0,0 @@
-
-
-import ccxt from '../../js/ccxt.js';
-
-// ----------------------------------------------------------------------------
-
-const tryToCreateOrder = async function (exchange, symbol, type, side, amount, price, params) {
-
-    try {
-
-        const order = await exchange.createOrder (symbol, type, side, amount, price, params)
-        return order
-
-    } catch (e) {
-
-        console.log (e.constructor.name, e.message)
-
-        if (e instanceof ccxt.NetworkError) {
-
-            // retry on networking errors
-            return false
-
-        } else {
-
-            throw e // break on all other exceptions
-        }
-    }
-}
-
-// ----------------------------------------------------------------------------
-
-const exchange = new ccxt.bytetrade ({
-    'apiKey': 'classic123', // edit here
-    'secret': 'ebcefff7de475ffe15e864ca3e3e410edf7e94fffd1f9af34edf9434e2bfff1b',  // edit here
-})
-
-//
-// make a classic bytetrade account - one that is linked to an email or phone number
-// then click on your username in the top right and then export
-// you will get a file like this:
-//
-// future garage icon motion panda garage motion task science head garage notable
-// ebcefff7de475ffe15e864ca3e3e410edf7e94fffd1f9af34edf9434e2bfff1b
-// classic123
-//
-// the second line is your secret and the third line is your apiKey
-//
-
-const symbol = 'XRP/USDT' // edit here
-const type = 'limit '     // edit here
-const side = 'buy'        // edit here
-const amount = 10         // edit here
-const price = 1           // edit here
-const params = {}         // edit here
-
-;(async () => {
-    let order = false
-    while (true) {
-        order = await tryToCreateOrder (exchange, symbol, type, side, amount, price, params)
-        if (order !== false) {
-            break
-        }
-    }
-    console.log (order)
-}) ()

package/examples/js/create-order-ws-example.js

@@ -1,25 +0,0 @@
-import ccxt from '../../js/ccxt.js';
-// AUTO-TRANSPILE //
-async function example() {
-    const exchange = new ccxt.pro.binance({
-        'apiKey': 'MY_API_KEY',
-        'secret': 'MY_SECRET',
-    });
-    exchange.setSandboxMode(true);
-    exchange.verbose = true; // uncomment for debugging purposes if necessary
-    // load markets
-    await exchange.loadMarkets();
-    const symbol = 'ETH/USDT';
-    const type = 'limit';
-    const side = 'buy';
-    const amount = 0.01;
-    let price = 1000;
-    let orders = [];
-    for (let i = 1; i < 5; i++) {
-        const response = await exchange.createOrderWs(symbol, type, side, amount, price);
-        price += i;
-        orders.push(response);
-    }
-    console.log(orders);
-}
-await example();

package/examples/js/create-orders-example.js

@@ -1,17 +0,0 @@
-import ccxt from '../../js/ccxt.js';
-// AUTO-TRANSPILE //
-async function example() {
-    const exchange = new ccxt.binance({
-        'apiKey': 'MY_API_KEY',
-        'secret': 'MY_SECRET',
-    });
-    exchange.setSandboxMode(true);
-    await exchange.loadMarkets();
-    exchange.verbose = true; // uncomment for debugging purposes if necessary
-    const orders = await exchange.createOrders([
-        { 'symbol': 'LTC/USDT:USDT', 'type': 'limit', 'side': 'buy', 'amount': 10, 'price': 55 },
-        { 'symbol': 'ETH/USDT:USDT', 'type': 'market', 'side': 'buy', 'amount': 0.5 },
-    ]);
-    console.log(orders);
-}
-await example();

package/examples/js/create-trailing-amount-order.js

@@ -1,36 +0,0 @@
-import ccxt from '../../js/ccxt.js';
-// AUTO-TRANSPILE //
-async function example() {
-    const exchange = new ccxt.bingx({
-        'apiKey': 'MY_API_KEY',
-        'secret': 'MY_SECRET',
-    });
-    // exchange.setSandboxMode (true);
-    // exchange.verbose = true; // uncomment for debugging purposes if necessary
-    await exchange.loadMarkets();
-    const symbol = 'BTC/USDT:USDT';
-    const order_type = 'market';
-    const side = 'sell';
-    const amount = 0.0001;
-    const price = undefined;
-    const reduceOnly = true;
-    const trailingAmount = 100;
-    // const trailingTriggerPrice = undefined; // not supported on all exchanges
-    const params = {
-        'reduceOnly': reduceOnly,
-        'trailingAmount': trailingAmount,
-        // 'trailingTriggerPrice': trailingTriggerPrice,
-    };
-    try {
-        const create_order = await exchange.createOrder(symbol, order_type, side, amount, price, params);
-        // Alternatively use the createTrailingAmountOrder method:
-        // const create_order = await exchange.createTrailingAmountOrder (symbol, order_type, side, amount, price, trailingAmount, trailingTriggerPrice, {
-        //     'reduceOnly': reduceOnly,
-        // });
-        console.log(create_order);
-    }
-    catch (e) {
-        console.log(e.toString());
-    }
-}
-await example();

package/examples/js/create-trailing-percent-order.js

@@ -1,36 +0,0 @@
-import ccxt from '../../js/ccxt.js';
-// AUTO-TRANSPILE //
-async function example() {
-    const exchange = new ccxt.bingx({
-        'apiKey': 'MY_API_KEY',
-        'secret': 'MY_SECRET',
-    });
-    // exchange.setSandboxMode (true);
-    // exchange.verbose = true; // uncomment for debugging purposes if necessary
-    await exchange.loadMarkets();
-    const symbol = 'BTC/USDT:USDT';
-    const order_type = 'market';
-    const side = 'sell';
-    const amount = 0.0001;
-    const price = undefined;
-    const reduceOnly = true;
-    const trailingPercent = 10;
-    // const trailingTriggerPrice = undefined; // not supported on all exchanges
-    const params = {
-        'reduceOnly': reduceOnly,
-        'trailingPercent': trailingPercent,
-        // 'trailingTriggerPrice': trailingTriggerPrice,
-    };
-    try {
-        const create_order = await exchange.createOrder(symbol, order_type, side, amount, price, params);
-        // Alternatively use the createTrailingAmountOrder method:
-        // const create_order = await exchange.createTrailingPercentOrder (symbol, order_type, side, amount, price, trailingPercent, trailingTriggerPrice, {
-        //     'reduceOnly': reduceOnly,
-        // });
-        console.log(create_order);
-    }
-    catch (e) {
-        console.log(e.toString());
-    }
-}
-await example();

package/examples/js/credentials.json

@@ -1,5 +0,0 @@
-{
-    "hitbtc":        { "apiKey": "b6aad581670b30fb25d1c91cdbe8ca5c", "secret": "fa394ced37a488f9b5826a2d9ce39ae3" },
-    "bitso":         { "apiKey": "xZnHRmdlgJ", "secret": "e156bb7f7ab3a831afbc7a80f7866b9e" },
-    "coincheck":     { "apiKey": "dCyzY2T6w0DFhaco", "secret": "JpI0eMmxfa0tEpk3X-dNwyclSASJkl-S" }
-}

package/examples/js/custom-proxy-agent-for-js.js

@@ -1,10 +0,0 @@
-// @ts-nocheck
-// to set custom "proxy-agent" for ccxt
-import ccxt from 'ccxt';
-import HttpProxyAgent from 'http-proxy-agent';
-const proxy = 'http://1.2.3.4:5678';
-const agent = new HttpProxyAgent(proxy); // or HttpsProxyAgent if you need http
-// then pass it through constructor:
-const kraken = new ccxt.kraken({ agent });
-// or set it later:
-kraken.agent = agent;

package/examples/js/custom-proxy-url.js

@@ -1,23 +0,0 @@
-
-
-import ccxt from '../../js/ccxt.js';
-
-(async function main () {
-
-    const kraken1 = new ccxt.kraken ({
-        proxy: function (url) {
-            return 'https://example.com/?url=' + encodeURIComponent (url)
-        },
-    })
-
-    console.log (await kraken1.loadMarkets ())
-
-    const kraken2 = new ccxt.kraken ({
-        proxy: function (url) {
-            return 'https://cors-anywhere.herokuapp.com/' + url
-        },
-    })
-
-    console.log (await kraken2.loadMarkets ())
-
-}) ()

package/examples/js/delta-maintenance-margin-rate-max-leverage.js

@@ -1,60 +0,0 @@
-import ccxt from '../../js/ccxt.js';
-
-console.log ('CCXT Version:', ccxt.version);
-
-function getMaxLeverage (market, positionSize) {
-    /**
-     * @description Equation taken from https://www.delta.exchange/contracts/
-     * @param {object} market CCXT market
-     * @param {float} positionSize The value of the position in quote currency
-     * @returns The maximum leverage available for the market for the given position size
-     */
-    const info = market['info'];
-    const maxLeverageNotional = Number (info['max_leverage_notional']);
-    const initialMarginScalingFactor = Number (info['initial_margin_scaling_factor']);
-    let initialMargin = Number (info['initial_margin']);
-
-    if (positionSize <= maxLeverageNotional) {
-        const initialMarginRatio = initialMargin / 100;
-        return 1 / initialMarginRatio;
-    } else {
-        initialMargin = initialMargin + (initialMarginScalingFactor * (positionSize - maxLeverageNotional));
-        const initialMarginRatio = initialMargin / 100;
-        return 1 / initialMarginRatio;
-    }
-}
-
-function getMaintenanceMarginRate (market, positionSize) {
-    /**
-     * @description Equation taken from https://www.delta.exchange/contracts/
-     * @param {object} market CCXT market
-     * @param {float} positionSize The value of the position in quote currency
-     * @returns The maintenance margin rate as a percentage for the market with the given position size
-     */
-    const info = market['info'];
-    const maxLeverageNotional = Number (info['max_leverage_notional']);
-    const maintenanceMarginScalingFactor = Number (info['maintenance_margin_scaling_factor']);
-    const maintenanceMargin = Number (info['maintenance_margin']);
-
-    if (positionSize <= maxLeverageNotional) {
-        return maintenanceMargin;
-    } else {
-        return maintenanceMargin + (maintenanceMarginScalingFactor * (positionSize - maxLeverageNotional));
-    }
-}
-
-async function main () {
-
-    const exchange = new ccxt.delta();
-    await exchange.loadMarkets ();
-    
-    const symbol = 'ADA/USDT:USDT';
-    const market = exchange.market (symbol);
-
-    // Gets the maximum leverage and maintenance margin rate for a position worth 100,000 USDT on the ADA/USDT:USDT market
-    const maxLeverage = getMaxLeverage(market, 100000);
-    const maintenanceMarginRate = getMaintenanceMarginRate(market, 100000);
-    console.log(maxLeverage, maintenanceMarginRate);
-}
-
-main ()

package/examples/js/env-variables.js

@@ -1,26 +0,0 @@
-
-
-// ----------------------------------------------------------------------------
-
-import ccxt from '../../js/ccxt.js';
-import ololog from 'ololog'
-
-// ----------------------------------------------------------------------------
-
-const log = ololog.configure.handleNodeErrors (), asTable = require("as-table").configure({ delimiter: " | " });
-
-// ----------------------------------------------------------------------------
-
-(async () => {
-
-    const exchange = new ccxt.coinbase ({
-        verbose: process.argv.includes ('--verbose'),
-        timeout: 60000,
-        apiKey: process.env.KEY,
-        secret: process.env.SECRET
-    });
-
-    const balance = await exchange.fetchBalance ()
-    log.green (balance)
-
-})()

package/examples/js/error-handling.js

@@ -1,89 +0,0 @@
-
-
-import ccxt from '../../js/ccxt.js';
-
-const verbose   = process.argv.includes ('--verbose');
-
-//-----------------------------------------------------------------------------
-
-const printSupportedExchanges = () => console.log ('Supported exchanges:', ccxt.exchanges.join (', '))
-
-const printUsage = () => {
-    console.log ('Usage: node', process.argv[1], 'id'.green)
-    printSupportedExchanges ()
-}
-
-const run = async (id) => {
-
-    // check if the exchange is supported by ccxt
-    const exchangeFound = ccxt.exchanges.indexOf (id) > -1
-
-    if (exchangeFound) {
-
-        console.log ('Instantiating', id, 'exchange')
-
-        // instantiate the exchange by id
-        const exchange = new ccxt[id] ({ verbose })
-
-        // try to load markets and catch the errors if any
-        try {
-
-            await exchange.loadMarkets ()
-
-        } catch (e) {
-
-            if (e instanceof ccxt.NetworkError) {
-                console.log (exchange.id, 'loadMarkets failed due to a network error:', e.message)
-            } else if (e instanceof ccxt.ExchangeError) {
-                console.log (exchange.id, 'loadMarkets failed due to exchange error:', e.message)
-            } else {
-                console.log (exchange.id, 'loadMarkets failed with:', e.message)
-            }
-
-            // rethrow the error "higher up" the call chain
-            throw e
-        }
-
-        // try to fetch a ticker and catch the errors if any
-        try {
-
-            const symbol = 'ETH/BTC'
-            const response = await exchange.fetchTicker (symbol)
-            console.log (response)
-
-        } catch (e) {
-
-            if (e instanceof ccxt.NetworkError) {
-                console.log (exchange.id, 'fetchTicker failed due to a network error:', e.message)
-            } else if (e instanceof ccxt.ExchangeError) {
-                console.log (exchange.id, 'fetchTicker failed due to exchange error:', e.message)
-            } else {
-                console.log (exchange.id, 'fetchTicker failed with:', e.message)
-            }
-
-            // rethrow the error "higher up" the call chain
-            throw e
-        }
-
-    } else {
-
-        console.log ('Exchange', id, 'not found')
-        printSupportedExchanges ()
-    }
-}
-
-;(async function main () {
-
-    if (process.argv.length > 2) {
-
-        let id = process.argv[2]
-        await run (id)
-
-    } else {
-
-        printUsage ()
-    }
-
-    process.exit ()
-
-}) ()

package/examples/js/exchange-capabilities.js

@@ -1,135 +0,0 @@
-
-
-import ccxt from '../../js/ccxt.js';
-import ololog from 'ololog';
-import ansicolor from 'ansicolor';
-import asTable from 'as-table';
-
-const { noLocate } = ololog;
-const log = noLocate;
-
-ansicolor.nice
-
-
-
-const csv = process.argv.includes ('--csv'), delimiter = csv ? ',' : '|', asTableConfig = { delimiter: ' ' + delimiter + ' ', /* print: require ('string.ify').noPretty  */ }
-
-asTable.configure (asTableConfig);
-
-const sortCertified = process.argv.includes ('--sort-certified') || process.argv.includes ('--certified')
-const exchangesArgument = process.argv.find (arg => arg.startsWith ('--exchanges='))
-const exchangesArgumentParts = exchangesArgument ? exchangesArgument.split ('=') : []
-const selectedExchanges = (exchangesArgumentParts.length > 1) ? exchangesArgumentParts[1].split (',') : []
-
-console.log (ccxt.iso8601 (ccxt.milliseconds ()))
-console.log ('CCXT v' + ccxt.version)
-
-async function main () {
-
-    let total = 0
-    let notImplemented = 0
-    let inexistentApi = 0
-    let implemented = 0
-    let emulated = 0
-
-    const exchangeNames = ccxt.exchanges
-    let exchanges = exchangeNames.map (id => new ccxt[id] ())
-    exchanges = exchanges.map (exchange => exchange.pro ? new ccxt.pro[exchange.id] () : exchange)
-    if (sortCertified) {
-        exchanges.sort((a, b) => {
-            if (a.certified && !b.certified) {
-                return -1;
-            } else if (!a.certified && b.certified) {
-                return 1;
-            } else {
-                return 0;
-            }
-        });
-    }
-    const metainfo = ccxt.flatten (exchanges.map (exchange => Object.keys (exchange.has)))
-    const reduced = metainfo.reduce ((previous, current) => {
-        previous[current] = (previous[current] || 0) + 1
-        return previous
-    }, {})
-    const unified = Object.entries (reduced).filter (([ _, count ]) => count > 1)
-    const methods = unified.map (([ method, _ ]) => method).sort ()
-    if (selectedExchanges.length > 0) {
-        exchanges = exchanges.filter ((exchange) => selectedExchanges.includes(exchange.id))
-    }
-    const table = asTable (exchanges.map (exchange => {
-        let result = {};
-        const basics = [
-            'CORS',
-            'spot',
-            'margin',
-            'swap',
-            'future',
-            'option',
-        ];
-
-        ccxt.unique (basics.concat (methods)).forEach (key => {
-
-            total += 1
-
-            let coloredString = '';
-
-            const feature = exchange.has[key]
-            const isFunction = (typeof exchange[key] === 'function')
-            const isBasic = basics.includes (key)
-
-            if (feature === false) {
-                // if explicitly set to 'false' in exchange.has (to exclude mistake, we check if it's undefined too)
-                coloredString = exchange.id.red.dim
-                inexistentApi += 1
-            } else if (feature === 'emulated') {
-                // if explicitly set to 'emulated' in exchange.has
-                coloredString = exchange.id.yellow
-                emulated += 1
-            } else if (feature) {
-                if (isBasic) {
-                    // if neither 'false' nor 'emulated', and if  method exists
-                    coloredString = exchange.id.green
-                    implemented += 1
-                } else {
-                    if (isFunction) {
-                        coloredString = exchange.id.green
-                        implemented += 1
-                    } else {
-                        // the feature is available in exchange.has and not implemented
-                        // this is an error
-                        coloredString = exchange.id.lightMagenta
-                    }
-                }
-            } else {
-                coloredString = exchange.id.lightRed
-                notImplemented += 1
-            }
-
-            result[key] = coloredString
-        })
-
-        return result
-    }))
-
-    if (csv) {
-        let lines = table.split ("\n")
-        lines = lines.slice (0, 1).concat (lines.slice (2))
-        log (lines.join ("\n"))
-    } else {
-        log (table)
-    }
-
-    log ('Summary: ',
-        ccxt.exchanges.length.toString (), 'exchanges; ',
-        'Methods [' + total.toString () + ' total]: ',
-        implemented.toString ().green, 'implemented,',
-        emulated.toString ().yellow, 'emulated,',
-        (inexistentApi.toString ().red.dim), 'inexistentApi,',
-        (notImplemented.toString ().lightRed), 'notImplemented',
-    )
-
-    log("\nMessy? Try piping to less (e.g. node script.js | less -S -R)\n".red)
-
-}
-
-main ()

package/examples/js/exchanges-by-volume.js

@@ -1,60 +0,0 @@
-
-
-import ccxt from '../../js/ccxt.js';
-
-(async () => {
-
-    //     const exchanges = [
-    //         'bittrex',
-    //         'poloniex',
-    //         'bitfinex'
-    //     ]
-
-    const exchanges = ccxt.exchanges
-
-    const symbol = 'BTC/USDT'
-    const tickers = {}
-    const volumeField = 'baseVolume'
-
-    console.log ('-----------------------------------------------------------')
-
-    await Promise.all (exchanges.map (exchangeId =>
-
-        new Promise (async (resolve, reject) => {
-
-            try {
-
-                const exchange = new ccxt[exchangeId] ()
-
-                const ticker = await exchange.fetchTicker (symbol)
-
-                if (ticker[volumeField] !== undefined) {
-                    tickers[exchangeId] = ticker
-                }
-
-            } catch (e) {
-
-                console.log (exchangeId, e.message.slice (0, 100))
-            }
-
-            resolve ()
-
-        })
-
-    ))
-
-    console.log ('-----------------------------------------------------------')
-
-    console.log (Object
-        .keys (tickers)
-        .sort ((a, b) =>
-            ((tickers[a][volumeField] > tickers[b][volumeField]) ? 1 : ((tickers[a][volumeField] < tickers[b][volumeField]) ? -1 : 0)))
-        .reverse ()
-        .map (id => ({
-            id,
-            symbol,
-            'volume': tickers[id][volumeField],
-        }))
-    )
-
-}) ()

package/examples/js/exchanges.js

@@ -1,40 +0,0 @@
-
-
-import ccxt from '../../js/ccxt.js';
-import countries from '../../build/countries.js';
-import asTable from 'as-table';
-import ololog from 'ololog'
-import ansicolor from 'ansicolor';
-const log = ololog.configure ({ locate: false })
-
-ansicolor.nice
-
-process.on ('uncaughtException',  e => { log.bright.red.error (e); process.exit (1) })
-process.on ('unhandledRejection', e => { log.bright.red.error (e); process.exit (1) })
-
-let exchanges = {}
-
-ccxt.exchanges.forEach (id => { exchanges[id] = new (ccxt)[id] () })
-
-log ('The ccxt library supports', (ccxt.exchanges.length.toString ()).green, 'exchanges:')
-
-var countryName = function (code) {
-    return ((countries[code] !== undefined) ? countries[code] : code)
-}
-
-log (asTable.configure ({ delimiter: ' | ' }) (Object.values (exchanges).map (exchange => {
-
-    let countries = Array.isArray (exchange.countries) ?
-        exchange.countries.map (countryName).join (', ') :
-        countryName (exchange.countries)
-
-    let website = Array.isArray (exchange.urls.www) ? exchange.urls.www[0] : exchange.urls.www
-
-    return {
-        id: exchange.id,
-        name: exchange.name,
-        url: website,
-        countries: countries,
-    }
-
-})))