UNPKG

@madnai/ccxt

Version:

A JavaScript / Python / PHP cryptocurrency trading library with support for 130+ exchanges

885 lines (859 loc) 34.6 kB
'use strict'; // --------------------------------------------------------------------------- const Exchange = require ('./base/Exchange'); const { ExchangeError, ExchangeNotAvailable, AuthenticationError, BadRequest, PermissionDenied, InvalidAddress, ArgumentsRequired, InvalidOrder } = require ('./base/errors'); const { DECIMAL_PLACES, SIGNIFICANT_DIGITS, TRUNCATE } = require ('./base/functions/number'); // --------------------------------------------------------------------------- module.exports = class bithumb extends Exchange { describe () { return this.deepExtend (super.describe (), { 'id': 'bithumb', 'name': 'Bithumb', 'countries': [ 'KR' ], // South Korea 'rateLimit': 500, 'has': { 'cancelOrder': true, 'CORS': true, 'createMarketOrder': true, 'createOrder': true, 'fetchBalance': true, 'fetchMarkets': true, 'fetchOpenOrders': true, 'fetchOrder': true, 'fetchOrderBook': true, 'fetchTicker': true, 'fetchTickers': true, 'fetchTrades': true, 'withdraw': true, }, 'urls': { 'logo': 'https://user-images.githubusercontent.com/1294454/30597177-ea800172-9d5e-11e7-804c-b9d4fa9b56b0.jpg', 'api': { 'public': 'https://api.bithumb.com/public', 'private': 'https://api.bithumb.com', }, 'www': 'https://www.bithumb.com', 'doc': 'https://apidocs.bithumb.com', 'fees': 'https://en.bithumb.com/customer_support/info_fee', }, 'api': { 'public': { 'get': [ 'ticker/{currency}', 'ticker/all', 'orderbook/{currency}', 'orderbook/all', 'transaction_history/{currency}', 'transaction_history/all', ], }, 'private': { 'post': [ 'info/account', 'info/balance', 'info/wallet_address', 'info/ticker', 'info/orders', 'info/user_transactions', 'info/order_detail', 'trade/place', 'trade/cancel', 'trade/btc_withdrawal', 'trade/krw_deposit', 'trade/krw_withdrawal', 'trade/market_buy', 'trade/market_sell', ], }, }, 'fees': { 'trading': { 'maker': 0.25 / 100, 'taker': 0.25 / 100, }, }, 'precisionMode': SIGNIFICANT_DIGITS, 'exceptions': { 'Bad Request(SSL)': BadRequest, 'Bad Request(Bad Method)': BadRequest, 'Bad Request.(Auth Data)': AuthenticationError, // { "status": "5100", "message": "Bad Request.(Auth Data)" } 'Not Member': AuthenticationError, 'Invalid Apikey': AuthenticationError, // {"status":"5300","message":"Invalid Apikey"} 'Method Not Allowed.(Access IP)': PermissionDenied, 'Method Not Allowed.(BTC Adress)': InvalidAddress, 'Method Not Allowed.(Access)': PermissionDenied, 'Database Fail': ExchangeNotAvailable, 'Invalid Parameter': BadRequest, '5600': ExchangeError, 'Unknown Error': ExchangeError, 'After May 23th, recent_transactions is no longer, hence users will not be able to connect to recent_transactions': ExchangeError, // {"status":"5100","message":"After May 23th, recent_transactions is no longer, hence users will not be able to connect to recent_transactions"} }, }); } amountToPrecision (symbol, amount) { return this.decimalToPrecision (amount, TRUNCATE, this.markets[symbol]['precision']['amount'], DECIMAL_PLACES); } async fetchMarkets (params = {}) { const response = await this.publicGetTickerAll (params); const data = this.safeValue (response, 'data'); const currencyIds = Object.keys (data); const result = []; const quote = this.safeCurrencyCode ('KRW'); for (let i = 0; i < currencyIds.length; i++) { const currencyId = currencyIds[i]; if (currencyId === 'date') { continue; } const market = data[currencyId]; const base = this.safeCurrencyCode (currencyId); const symbol = currencyId + '/' + quote; let active = true; if (Array.isArray (market)) { const numElements = market.length; if (numElements === 0) { active = false; } } result.push ({ 'id': currencyId, 'symbol': symbol, 'base': base, 'quote': quote, 'info': market, 'active': active, 'precision': { 'amount': 4, 'price': 4, }, 'limits': { 'amount': { 'min': undefined, 'max': undefined, }, 'price': { 'min': undefined, 'max': undefined, }, 'cost': { 'min': 500, 'max': 5000000000, }, }, 'baseId': undefined, 'quoteId': undefined, }); } return result; } async fetchBalance (params = {}) { await this.loadMarkets (); const request = { 'currency': 'ALL', }; const response = await this.privatePostInfoBalance (this.extend (request, params)); const result = { 'info': response }; const balances = this.safeValue (response, 'data'); const codes = Object.keys (this.currencies); for (let i = 0; i < codes.length; i++) { const code = codes[i]; const account = this.account (); const currency = this.currency (code); const lowerCurrencyId = this.safeStringLower (currency, 'id'); account['total'] = this.safeFloat (balances, 'total_' + lowerCurrencyId); account['used'] = this.safeFloat (balances, 'in_use_' + lowerCurrencyId); account['free'] = this.safeFloat (balances, 'available_' + lowerCurrencyId); result[code] = account; } return this.parseBalance (result); } async fetchOrderBook (symbol, limit = undefined, params = {}) { await this.loadMarkets (); const market = this.market (symbol); const request = { 'currency': market['base'], }; if (limit !== undefined) { request['count'] = limit; // default 30, max 30 } const response = await this.publicGetOrderbookCurrency (this.extend (request, params)); // // { // "status":"0000", // "data":{ // "timestamp":"1587621553942", // "payment_currency":"KRW", // "order_currency":"BTC", // "bids":[ // {"price":"8652000","quantity":"0.0043"}, // {"price":"8651000","quantity":"0.0049"}, // {"price":"8650000","quantity":"8.4791"}, // ], // "asks":[ // {"price":"8654000","quantity":"0.119"}, // {"price":"8655000","quantity":"0.254"}, // {"price":"8658000","quantity":"0.119"}, // ] // } // } // const data = this.safeValue (response, 'data', {}); const timestamp = this.safeInteger (data, 'timestamp'); return this.parseOrderBook (data, timestamp, 'bids', 'asks', 'price', 'quantity'); } parseTicker (ticker, market = undefined) { // // fetchTicker, fetchTickers // // { // "opening_price":"227100", // "closing_price":"228400", // "min_price":"222300", // "max_price":"230000", // "units_traded":"82618.56075337", // "acc_trade_value":"18767376138.6031", // "prev_closing_price":"227100", // "units_traded_24H":"151871.13484676", // "acc_trade_value_24H":"34247610416.8974", // "fluctate_24H":"8700", // "fluctate_rate_24H":"3.96", // "date":"1587710327264", // fetchTickers inject this // } // const timestamp = this.safeInteger (ticker, 'date'); let symbol = undefined; if (market !== undefined) { symbol = market['symbol']; } const open = this.safeFloat (ticker, 'opening_price'); const close = this.safeFloat (ticker, 'closing_price'); let change = undefined; let percentage = undefined; let average = undefined; if ((close !== undefined) && (open !== undefined)) { change = close - open; if (open > 0) { percentage = change / open * 100; } average = this.sum (open, close) / 2; } const baseVolume = this.safeFloat (ticker, 'units_traded_24H'); const quoteVolume = this.safeFloat (ticker, 'acc_trade_value_24H'); const vwap = this.vwap (baseVolume, quoteVolume); return { 'symbol': symbol, 'timestamp': timestamp, 'datetime': this.iso8601 (timestamp), 'high': this.safeFloat (ticker, 'max_price'), 'low': this.safeFloat (ticker, 'min_price'), 'bid': this.safeFloat (ticker, 'buy_price'), 'bidVolume': undefined, 'ask': this.safeFloat (ticker, 'sell_price'), 'askVolume': undefined, 'vwap': vwap, 'open': open, 'close': close, 'last': close, 'previousClose': undefined, 'change': change, 'percentage': percentage, 'average': average, 'baseVolume': baseVolume, 'quoteVolume': quoteVolume, 'info': ticker, }; } async fetchTickers (symbols = undefined, params = {}) { await this.loadMarkets (); const response = await this.publicGetTickerAll (params); // // { // "status":"0000", // "data":{ // "BTC":{ // "opening_price":"9045000", // "closing_price":"9132000", // "min_price":"8938000", // "max_price":"9168000", // "units_traded":"4619.79967497", // "acc_trade_value":"42021363832.5187", // "prev_closing_price":"9041000", // "units_traded_24H":"8793.5045804", // "acc_trade_value_24H":"78933458515.4962", // "fluctate_24H":"530000", // "fluctate_rate_24H":"6.16" // }, // "date":"1587710878669" // } // } // const result = {}; const data = this.safeValue (response, 'data', {}); const timestamp = this.safeInteger (data, 'date'); const tickers = this.omit (data, 'date'); const ids = Object.keys (tickers); for (let i = 0; i < ids.length; i++) { const id = ids[i]; let symbol = id; let market = undefined; if (id in this.markets_by_id) { market = this.markets_by_id[id]; symbol = market['symbol']; } const ticker = tickers[id]; const isArray = Array.isArray (ticker); if (!isArray) { ticker['date'] = timestamp; result[symbol] = this.parseTicker (ticker, market); } } return this.filterByArray (result, 'symbol', symbols); } async fetchTicker (symbol, params = {}) { await this.loadMarkets (); const market = this.market (symbol); const request = { 'currency': market['base'], }; const response = await this.publicGetTickerCurrency (this.extend (request, params)); // // { // "status":"0000", // "data":{ // "opening_price":"227100", // "closing_price":"228400", // "min_price":"222300", // "max_price":"230000", // "units_traded":"82618.56075337", // "acc_trade_value":"18767376138.6031", // "prev_closing_price":"227100", // "units_traded_24H":"151871.13484676", // "acc_trade_value_24H":"34247610416.8974", // "fluctate_24H":"8700", // "fluctate_rate_24H":"3.96", // "date":"1587710327264" // } // } // const data = this.safeValue (response, 'data', {}); return this.parseTicker (data, market); } parseTrade (trade, market = undefined) { // // fetchTrades (public) // // { // "transaction_date":"2020-04-23 22:21:46", // "type":"ask", // "units_traded":"0.0125", // "price":"8667000", // "total":"108337" // } // // fetchOrder (private) // // { // "transaction_date": "1572497603902030", // "price": "8601000", // "units": "0.005", // "fee_currency": "KRW", // "fee": "107.51", // "total": "43005" // } // // a workaround for their bug in date format, hours are not 0-padded let timestamp = undefined; const transactionDatetime = this.safeString (trade, 'transaction_date'); if (transactionDatetime !== undefined) { const parts = transactionDatetime.split (' '); const numParts = parts.length; if (numParts > 1) { const transactionDate = parts[0]; let transactionTime = parts[1]; if (transactionTime.length < 8) { transactionTime = '0' + transactionTime; } timestamp = this.parse8601 (transactionDate + ' ' + transactionTime); } else { timestamp = this.safeIntegerProduct (trade, 'transaction_date', 0.001); } } if (timestamp !== undefined) { timestamp -= 9 * 3600000; // they report UTC + 9 hours, server in Korean timezone } const type = undefined; let side = this.safeString (trade, 'type'); side = (side === 'ask') ? 'sell' : 'buy'; const id = this.safeString (trade, 'cont_no'); let symbol = undefined; if (market !== undefined) { symbol = market['symbol']; } const price = this.safeFloat (trade, 'price'); const amount = this.safeFloat2 (trade, 'units_traded', 'units'); let cost = this.safeFloat (trade, 'total'); if (cost === undefined) { if (amount !== undefined) { if (price !== undefined) { cost = price * amount; } } } let fee = undefined; const feeCost = this.safeFloat (trade, 'fee'); if (feeCost !== undefined) { const feeCurrencyId = this.safeString (trade, 'fee_currency'); const feeCurrencyCode = this.commonCurrencyCode (feeCurrencyId); fee = { 'cost': feeCost, 'currency': feeCurrencyCode, }; } return { 'id': id, 'info': trade, 'timestamp': timestamp, 'datetime': this.iso8601 (timestamp), 'symbol': symbol, 'order': undefined, 'type': type, 'side': side, 'takerOrMaker': undefined, 'price': price, 'amount': amount, 'cost': cost, 'fee': fee, }; } async fetchTrades (symbol, since = undefined, limit = undefined, params = {}) { await this.loadMarkets (); const market = this.market (symbol); const request = { 'currency': market['base'], }; if (limit === undefined) { request['count'] = limit; // default 20, max 100 } const response = await this.publicGetTransactionHistoryCurrency (this.extend (request, params)); // // { // "status":"0000", // "data":[ // { // "transaction_date":"2020-04-23 22:21:46", // "type":"ask", // "units_traded":"0.0125", // "price":"8667000", // "total":"108337" // }, // ] // } // const data = this.safeValue (response, 'data', []); return this.parseTrades (data, market, since, limit); } async createOrder (symbol, type, side, amount, price = undefined, params = {}) { await this.loadMarkets (); const market = this.market (symbol); const request = { 'order_currency': market['id'], 'Payment_currency': market['quote'], 'units': amount, }; let method = 'privatePostTradePlace'; if (type === 'limit') { request['price'] = price; request['type'] = (side === 'buy') ? 'bid' : 'ask'; } else { method = 'privatePostTradeMarket' + this.capitalize (side); } const response = await this[method] (this.extend (request, params)); const id = this.safeString (response, 'order_id'); if (id === undefined) { throw new InvalidOrder (this.id + ' createOrder did not return an order id'); } return { 'info': response, 'symbol': symbol, 'type': type, 'side': side, 'id': id, }; } async fetchOrder (id, symbol = undefined, params = {}) { if (symbol === undefined) { throw new ArgumentsRequired (this.id + ' fetchOrder requires a symbol argument'); } await this.loadMarkets (); const market = this.market (symbol); const request = { 'order_id': id, 'count': 1, 'order_currency': market['base'], 'payment_currency': market['quote'], }; const response = await this.privatePostInfoOrderDetail (this.extend (request, params)); // // { // "status": "0000", // "data": { // order_date: '1603161798539254', // type: 'ask', // order_status: 'Cancel', // order_currency: 'BTC', // payment_currency: 'KRW', // watch_price: '0', // order_price: '13344000', // order_qty: '0.0125', // cancel_date: '1603161803809993', // cancel_type: '사용자취소', // contract: [ // { // transaction_date: '1603161799976383', // price: '13344000', // units: '0.0015', // fee_currency: 'KRW', // fee: '0', // total: '20016' // } // ], // } // } // const data = this.safeValue (response, 'data'); return this.parseOrder (this.extend (data, { 'order_id': id }), market); } parseOrderStatus (status) { const statuses = { 'Pending': 'open', 'Completed': 'closed', 'Cancel': 'canceled', }; return this.safeString (statuses, status, status); } parseOrder (order, market = undefined) { // // // fetchOrder // // { // "transaction_date": "1572497603668315", // "type": "bid", // "order_status": "Completed", // "order_currency": "BTC", // "payment_currency": "KRW", // "order_price": "8601000", // "order_qty": "0.007", // "cancel_date": "", // "cancel_type": "", // "contract": [ // { // "transaction_date": "1572497603902030", // "price": "8601000", // "units": "0.005", // "fee_currency": "KRW", // "fee": "107.51", // "total": "43005" // }, // ] // } // // { // order_date: '1603161798539254', // type: 'ask', // order_status: 'Cancel', // order_currency: 'BTC', // payment_currency: 'KRW', // watch_price: '0', // order_price: '13344000', // order_qty: '0.0125', // cancel_date: '1603161803809993', // cancel_type: '사용자취소', // contract: [ // { // transaction_date: '1603161799976383', // price: '13344000', // units: '0.0015', // fee_currency: 'KRW', // fee: '0', // total: '20016' // } // ], // } // // fetchOpenOrders // // { // "order_currency": "BTC", // "payment_currency": "KRW", // "order_id": "C0101000007408440032", // "order_date": "1571728739360570", // "type": "bid", // "units": "5.0", // "units_remaining": "5.0", // "price": "501000", // } // const timestamp = this.safeIntegerProduct (order, 'order_date', 0.001); const sideProperty = this.safeValue2 (order, 'type', 'side'); const side = (sideProperty === 'bid') ? 'buy' : 'sell'; const status = this.parseOrderStatus (this.safeString (order, 'order_status')); let price = this.safeFloat2 (order, 'order_price', 'price'); let type = 'limit'; if (price === 0) { price = undefined; type = 'market'; } const amount = this.safeFloat2 (order, 'order_qty', 'units'); let remaining = this.safeFloat (order, 'units_remaining'); if (remaining === undefined) { if (status === 'closed') { remaining = 0; } else if (status !== 'canceled') { remaining = amount; } } let symbol = undefined; const baseId = this.safeString (order, 'order_currency'); const quoteId = this.safeString (order, 'payment_currency'); const base = this.safeCurrencyCode (baseId); const quote = this.safeCurrencyCode (quoteId); if ((base !== undefined) && (quote !== undefined)) { symbol = base + '/' + quote; } if ((symbol === undefined) && (market !== undefined)) { symbol = market['symbol']; } let filled = undefined; let cost = undefined; let average = undefined; const id = this.safeString (order, 'order_id'); const rawTrades = this.safeValue (order, 'contract'); let trades = undefined; let fee = undefined; let fees = undefined; let feesByCurrency = undefined; if (rawTrades !== undefined) { trades = this.parseTrades (rawTrades, market, undefined, undefined, { 'side': side, 'symbol': symbol, 'order': id, }); filled = 0; feesByCurrency = {}; for (let i = 0; i < trades.length; i++) { const trade = trades[i]; filled = this.sum (filled, trade['amount']); cost = this.sum (cost, trade['cost']); const tradeFee = trade['fee']; const feeCurrency = tradeFee['currency']; if (feeCurrency in feesByCurrency) { feesByCurrency[feeCurrency] = { 'currency': feeCurrency, 'cost': this.sum (feesByCurrency[feeCurrency]['cost'], tradeFee['cost']), }; } else { feesByCurrency[feeCurrency] = { 'currency': feeCurrency, 'cost': tradeFee['cost'], }; } } const feeCurrencies = Object.keys (feesByCurrency); const feeCurrenciesLength = feeCurrencies.length; if (feeCurrenciesLength > 1) { fees = []; for (let i = 0; i < feeCurrencies.length; i++) { const feeCurrency = feeCurrencies[i]; fees.push (feesByCurrency[feeCurrency]); } } else { fee = this.safeValue (feesByCurrency, feeCurrencies[0]); } if (filled !== 0) { average = cost / filled; } } if (amount !== undefined) { if ((filled === undefined) && (remaining !== undefined)) { filled = Math.max (0, amount - remaining); } if ((remaining === undefined) && (filled !== undefined)) { remaining = Math.max (0, amount - filled); } } const result = { 'info': order, 'id': id, 'clientOrderId': undefined, 'timestamp': timestamp, 'datetime': this.iso8601 (timestamp), 'lastTradeTimestamp': undefined, 'symbol': symbol, 'type': type, 'side': side, 'price': price, 'amount': amount, 'cost': cost, 'average': average, 'filled': filled, 'remaining': remaining, 'status': status, 'fee': undefined, 'trades': trades, }; if (fee !== undefined) { result['fee'] = fee; } else if (fees !== undefined) { result['fees'] = fees; } return result; } async fetchOpenOrders (symbol = undefined, since = undefined, limit = undefined, params = {}) { if (symbol === undefined) { throw new ArgumentsRequired (this.id + ' fetchOpenOrders requires a symbol argument'); } await this.loadMarkets (); const market = this.market (symbol); if (limit === undefined) { limit = 100; } const request = { 'count': limit, 'order_currency': market['base'], 'payment_currency': market['quote'], }; if (since !== undefined) { request['after'] = since; } const response = await this.privatePostInfoOrders (this.extend (request, params)); // // { // "status": "0000", // "data": [ // { // "order_currency": "BTC", // "payment_currency": "KRW", // "order_id": "C0101000007408440032", // "order_date": "1571728739360570", // "type": "bid", // "units": "5.0", // "units_remaining": "5.0", // "price": "501000", // } // ] // } // const data = this.safeValue (response, 'data', []); return this.parseOrders (data, market, since, limit); } async cancelOrder (id, symbol = undefined, params = {}) { const side_in_params = ('side' in params); if (!side_in_params) { throw new ArgumentsRequired (this.id + ' cancelOrder requires a `symbol` argument and a `side` parameter (sell or buy)'); } if (symbol === undefined) { throw new ArgumentsRequired (this.id + ' cancelOrder requires a `symbol` argument and a `side` parameter (sell or buy)'); } const market = this.market (symbol); const side = (params['side'] === 'buy') ? 'bid' : 'ask'; params = this.omit (params, [ 'side', 'currency' ]); // https://github.com/ccxt/ccxt/issues/6771 const request = { 'order_id': id, 'type': side, 'order_currency': market['base'], 'payment_currency': market['quote'], }; return await this.privatePostTradeCancel (this.extend (request, params)); } cancelUnifiedOrder (order, params = {}) { const request = { 'side': order['side'], }; return this.cancelOrder (order['id'], order['symbol'], this.extend (request, params)); } async withdraw (code, amount, address, tag = undefined, params = {}) { this.checkAddress (address); await this.loadMarkets (); const currency = this.currency (code); const request = { 'units': amount, 'address': address, 'currency': currency['id'], }; if (currency === 'XRP' || currency === 'XMR') { const destination = this.safeString (params, 'destination'); if ((tag === undefined) && (destination === undefined)) { throw new ArgumentsRequired (this.id + ' ' + code + ' withdraw() requires a tag argument or an extra destination param'); } else if (tag !== undefined) { request['destination'] = tag; } } const response = await this.privatePostTradeBtcWithdrawal (this.extend (request, params)); return { 'info': response, 'id': undefined, }; } nonce () { return this.milliseconds (); } sign (path, api = 'public', method = 'GET', params = {}, headers = undefined, body = undefined) { const endpoint = '/' + this.implodeParams (path, params); let url = this.urls['api'][api] + endpoint; const query = this.omit (params, this.extractParams (path)); if (api === 'public') { if (Object.keys (query).length) { url += '?' + this.urlencode (query); } } else { this.checkRequiredCredentials (); body = this.urlencode (this.extend ({ 'endpoint': endpoint, }, query)); const nonce = this.nonce ().toString (); const auth = endpoint + "\0" + body + "\0" + nonce; // eslint-disable-line quotes const signature = this.hmac (this.encode (auth), this.encode (this.secret), 'sha512'); const signature64 = this.decode (this.stringToBase64 (signature)); headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded', 'Api-Key': this.apiKey, 'Api-Sign': signature64, 'Api-Nonce': nonce, }; } return { 'url': url, 'method': method, 'body': body, 'headers': headers }; } handleErrors (httpCode, reason, url, method, headers, body, response, requestHeaders, requestBody) { if (response === undefined) { return; // fallback to default error handler } if ('status' in response) { // // {"status":"5100","message":"After May 23th, recent_transactions is no longer, hence users will not be able to connect to recent_transactions"} // const status = this.safeString (response, 'status'); const message = this.safeString (response, 'message'); if (status !== undefined) { if (status === '0000') { return; // no error } const feedback = this.id + ' ' + body; this.throwExactlyMatchedException (this.exceptions, status, feedback); this.throwExactlyMatchedException (this.exceptions, message, feedback); throw new ExchangeError (feedback); } } } async request (path, api = 'public', method = 'GET', params = {}, headers = undefined, body = undefined) { const response = await this.fetch2 (path, api, method, params, headers, body); if ('status' in response) { if (response['status'] === '0000') { return response; } throw new ExchangeError (this.id + ' ' + this.json (response)); } return response; } };