consequunturatque
Version:
A JavaScript / Python / PHP cryptocurrency trading library with support for 130+ exchanges
510 lines (489 loc) • 19.7 kB
JavaScript
'use strict';
// ---------------------------------------------------------------------------
const Exchange = require ('./base/Exchange');
const { ExchangeError, AuthenticationError, InvalidNonce, InsufficientFunds, InvalidOrder, OrderNotFound, DDoSProtection } = require ('./base/errors');
const Precise = require ('./base/Precise');
// ---------------------------------------------------------------------------
module.exports = class coinegg extends Exchange {
describe () {
return this.deepExtend (super.describe (), {
'id': 'coinegg',
'name': 'CoinEgg',
'countries': [ 'CN', 'UK' ],
'has': {
'cancelOrder': true,
'createOrder': true,
'fetchBalance': true,
'fetchMarkets': true,
'fetchMyTrades': false,
'fetchOpenOrders': 'emulated',
'fetchOrder': true,
'fetchOrderBook': true,
'fetchOrders': true,
'fetchTicker': true,
'fetchTickers': false,
'fetchTrades': true,
},
'urls': {
'logo': 'https://user-images.githubusercontent.com/1294454/36770310-adfa764e-1c5a-11e8-8e09-449daac3d2fb.jpg',
'api': {
'web': 'https://trade.coinegg.com/web',
'rest': 'https://api.coinegg.com/api/v1',
},
'www': 'https://www.coinegg.com',
'doc': 'https://www.coinegg.com/explain.api.html',
'fees': 'https://www.coinegg.com/fee.html',
'referral': 'https://www.coinegg.com/user/register?invite=523218',
},
'api': {
'web': {
'get': [
'symbol/ticker?right_coin={quote}',
'{quote}/trends',
'{quote}/{base}/order',
'{quote}/{base}/trades',
'{quote}/{base}/depth.js',
],
},
'public': {
'get': [
'ticker/region/{quote}',
'depth/region/{quote}',
'orders/region/{quote}',
],
},
'private': {
'post': [
'balance',
'trade_add/region/{quote}',
'trade_cancel/region/{quote}',
'trade_view/region/{quote}',
'trade_list/region/{quote}',
],
},
},
'fees': {
'trading': {
'maker': 0.1 / 100,
'taker': 0.1 / 100,
},
'funding': {
'withdraw': {
'BTC': 0.008,
'BCH': 0.002,
'LTC': 0.001,
'ETH': 0.01,
'ETC': 0.01,
'NEO': 0,
'QTUM': '1%',
'XRP': '1%',
'DOGE': '1%',
'LSK': '1%',
'XAS': '1%',
'BTS': '1%',
'GAME': '1%',
'GOOC': '1%',
'NXT': '1%',
'IFC': '1%',
'DNC': '1%',
'BLK': '1%',
'VRC': '1%',
'XPM': '1%',
'VTC': '1%',
'TFC': '1%',
'PLC': '1%',
'EAC': '1%',
'PPC': '1%',
'FZ': '1%',
'ZET': '1%',
'RSS': '1%',
'PGC': '1%',
'SKT': '1%',
'JBC': '1%',
'RIO': '1%',
'LKC': '1%',
'ZCC': '1%',
'MCC': '1%',
'QEC': '1%',
'MET': '1%',
'YTC': '1%',
'HLB': '1%',
'MRYC': '1%',
'MTC': '1%',
'KTC': 0,
},
},
},
'exceptions': {
'103': AuthenticationError,
'104': AuthenticationError,
'105': AuthenticationError,
'106': InvalidNonce,
'200': InsufficientFunds,
'201': InvalidOrder,
'202': InvalidOrder,
'203': OrderNotFound,
'402': DDoSProtection,
},
'errorMessages': {
'100': 'Required parameters can not be empty',
'101': 'Illegal parameter',
'102': 'coin does not exist',
'103': 'Key does not exist',
'104': 'Signature does not match',
'105': 'Insufficient permissions',
'106': 'Request expired(nonce error)',
'200': 'Lack of balance',
'201': 'Too small for the number of trading',
'202': 'Price must be in 0 - 1000000',
'203': 'Order does not exist',
'204': 'Pending order amount must be above 0.001 BTC',
'205': 'Restrict pending order prices',
'206': 'Decimal place error',
'401': 'System error',
'402': 'Requests are too frequent',
'403': 'Non-open API',
'404': 'IP restriction does not request the resource',
'405': 'Currency transactions are temporarily closed',
},
'options': {
'quoteIds': [ 'btc', 'eth', 'usc', 'usdt' ],
},
'commonCurrencies': {
'JBC': 'JubaoCoin',
'SBTC': 'Super Bitcoin',
},
});
}
async fetchMarkets (params = {}) {
const quoteIds = this.options['quoteIds'];
const result = [];
for (let b = 0; b < quoteIds.length; b++) {
const quoteId = quoteIds[b];
const response = await this.webGetSymbolTickerRightCoinQuote ({
'quote': quoteId,
});
const tickers = this.safeValue (response, 'data', []);
for (let i = 0; i < tickers.length; i++) {
const ticker = tickers[i];
const id = ticker['symbol'];
const baseId = id.split ('_')[0];
let base = baseId.toUpperCase ();
let quote = quoteId.toUpperCase ();
base = this.safeCurrencyCode (base);
quote = this.safeCurrencyCode (quote);
const symbol = base + '/' + quote;
const precision = {
'amount': 8,
'price': 8,
};
result.push ({
'id': id,
'symbol': symbol,
'base': base,
'quote': quote,
'baseId': baseId,
'quoteId': quoteId,
'active': true,
'precision': precision,
'limits': {
'amount': {
'min': Math.pow (10, -precision['amount']),
'max': Math.pow (10, precision['amount']),
},
'price': {
'min': Math.pow (10, -precision['price']),
'max': Math.pow (10, precision['price']),
},
'cost': {
'min': undefined,
'max': undefined,
},
},
'info': ticker,
});
}
}
return result;
}
parseTicker (ticker, market = undefined) {
const symbol = market['symbol'];
const timestamp = this.milliseconds ();
const last = this.safeNumber (ticker, 'last');
const percentage = this.safeNumber (ticker, 'change');
let open = undefined;
let change = undefined;
let average = undefined;
if (percentage !== undefined) {
const relativeChange = percentage / 100;
open = last / this.sum (1, relativeChange);
change = last - open;
average = this.sum (last, open) / 2;
}
return {
'symbol': symbol,
'timestamp': timestamp,
'datetime': this.iso8601 (timestamp),
'high': this.safeNumber (ticker, 'high'),
'low': this.safeNumber (ticker, 'low'),
'bid': this.safeNumber (ticker, 'buy'),
'bidVolume': undefined,
'ask': this.safeNumber (ticker, 'sell'),
'askVolume': undefined,
'vwap': undefined,
'open': open,
'close': last,
'last': last,
'previousClose': undefined,
'change': change,
'percentage': percentage,
'average': average,
'baseVolume': this.safeNumber (ticker, 'vol'),
'quoteVolume': this.safeNumber (ticker, 'quoteVol'),
'info': ticker,
};
}
async fetchTicker (symbol, params = {}) {
await this.loadMarkets ();
const market = this.market (symbol);
const request = {
'coin': market['baseId'],
'quote': market['quoteId'],
};
const response = await this.publicGetTickerRegionQuote (this.extend (request, params));
return this.parseTicker (response, market);
}
async fetchOrderBook (symbol, limit = undefined, params = {}) {
await this.loadMarkets ();
const market = this.market (symbol);
const request = {
'coin': market['baseId'],
'quote': market['quoteId'],
};
const response = await this.publicGetDepthRegionQuote (this.extend (request, params));
return this.parseOrderBook (response, symbol);
}
parseTrade (trade, market = undefined) {
const timestamp = this.safeTimestamp (trade, 'date');
const priceString = this.safeString (trade, 'price');
const amountString = this.safeString (trade, 'amount');
const price = this.parseNumber (priceString);
const amount = this.parseNumber (amountString);
const cost = this.parseNumber (Precise.stringMul (priceString, amountString));
const symbol = market['symbol'];
const type = 'limit';
const side = this.safeString (trade, 'type');
const id = this.safeString (trade, 'tid');
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': undefined,
};
}
async fetchTrades (symbol, since = undefined, limit = undefined, params = {}) {
await this.loadMarkets ();
const market = this.market (symbol);
const request = {
'coin': market['baseId'],
'quote': market['quoteId'],
};
const response = await this.publicGetOrdersRegionQuote (this.extend (request, params));
return this.parseTrades (response, market, since, limit);
}
async fetchBalance (params = {}) {
await this.loadMarkets ();
const response = await this.privatePostBalance (params);
const result = { 'info': response };
const data = this.safeValue (response, 'data', {});
const balances = this.omit (data, 'uid');
const keys = Object.keys (balances);
for (let i = 0; i < keys.length; i++) {
const key = keys[i];
const [ currencyId, accountType ] = key.split ('_');
const code = this.safeCurrencyCode (currencyId);
if (!(code in result)) {
result[code] = this.account ();
}
const type = (accountType === 'lock') ? 'used' : 'free';
result[code][type] = this.safeString (balances, key);
}
return this.parseBalance (result, false);
}
parseOrder (order, market = undefined) {
let symbol = undefined;
if (market !== undefined) {
symbol = market['symbol'];
}
const timestamp = this.parse8601 (this.safeString (order, 'datetime'));
const price = this.safeNumber (order, 'price');
const amount = this.safeNumber (order, 'amount_original');
const remaining = this.safeNumber (order, 'amount_outstanding');
let status = this.safeString (order, 'status');
if (status === 'cancelled') {
status = 'canceled';
} else {
status = remaining ? 'open' : 'closed';
}
const info = this.safeValue (order, 'info', order);
const type = 'limit';
const side = this.safeString (order, 'type');
const id = this.safeString (order, 'id');
return this.safeOrder ({
'id': id,
'clientOrderId': undefined,
'datetime': this.iso8601 (timestamp),
'timestamp': timestamp,
'lastTradeTimestamp': undefined,
'status': status,
'symbol': symbol,
'type': type,
'timeInForce': undefined,
'postOnly': undefined,
'side': side,
'price': price,
'stopPrice': undefined,
'cost': undefined,
'amount': amount,
'filled': undefined,
'remaining': remaining,
'trades': undefined,
'fee': undefined,
'info': info,
'average': undefined,
});
}
async createOrder (symbol, type, side, amount, price = undefined, params = {}) {
await this.loadMarkets ();
const market = this.market (symbol);
const request = {
'coin': market['baseId'],
'quote': market['quoteId'],
'type': side,
'amount': amount,
'price': price,
};
const response = await this.privatePostTradeAddRegionQuote (this.extend (request, params));
const id = this.safeString (response, 'id');
const order = this.parseOrder ({
'id': id,
'datetime': this.ymdhms (this.milliseconds ()),
'amount_original': amount,
'amount_outstanding': amount,
'price': price,
'type': side,
'info': response,
}, market);
return order;
}
async cancelOrder (id, symbol = undefined, params = {}) {
await this.loadMarkets ();
const market = this.market (symbol);
const request = {
'id': id,
'coin': market['baseId'],
'quote': market['quoteId'],
};
return await this.privatePostTradeCancelRegionQuote (this.extend (request, params));
}
async fetchOrder (id, symbol = undefined, params = {}) {
await this.loadMarkets ();
const market = this.market (symbol);
const request = {
'id': id,
'coin': market['baseId'],
'quote': market['quoteId'],
};
const response = await this.privatePostTradeViewRegionQuote (this.extend (request, params));
const data = this.safeValue (response, 'data');
return this.parseOrder (data, market);
}
async fetchOrders (symbol = undefined, since = undefined, limit = undefined, params = {}) {
await this.loadMarkets ();
const market = this.market (symbol);
const request = {
'coin': market['baseId'],
'quote': market['quoteId'],
};
if (since !== undefined) {
request['since'] = since / 1000;
}
const response = await this.privatePostTradeListRegionQuote (this.extend (request, params));
const data = this.safeValue (response, 'data', []);
return this.parseOrders (data, market, since, limit);
}
async fetchOpenOrders (symbol = undefined, since = undefined, limit = undefined, params = {}) {
const request = {
'type': 'open',
};
return await this.fetchOrders (symbol, since, limit, this.extend (request, params));
}
nonce () {
return this.milliseconds ();
}
sign (path, api = 'public', method = 'GET', params = {}, headers = undefined, body = undefined) {
let apiType = 'rest';
if (api === 'web') {
apiType = api;
}
let url = this.urls['api'][apiType] + '/' + this.implodeParams (path, params);
let query = this.omit (params, this.extractParams (path));
if (api === 'public' || api === 'web') {
if (Object.keys (query).length) {
url += '?' + this.urlencode (query);
}
} else {
this.checkRequiredCredentials ();
query = this.urlencode (this.extend ({
'key': this.apiKey,
'nonce': this.nonce (),
}, query));
const secret = this.hash (this.encode (this.secret));
const signature = this.hmac (this.encode (query), this.encode (secret));
query += '&' + 'signature=' + signature;
if (method === 'GET') {
url += '?' + query;
} else {
headers = {
'Content-type': 'application/x-www-form-urlencoded',
};
body = query;
}
}
return { 'url': url, 'method': method, 'body': body, 'headers': headers };
}
handleErrors (code, reason, url, method, headers, body, response, requestHeaders, requestBody) {
if (response === undefined) {
return;
}
// private endpoints return the following structure:
// {"result":true,"data":{...}} - success
// {"result":false,"code":"103"} - failure
// {"code":0,"msg":"Suceess","data":{"uid":"2716039","btc_balance":"0.00000000","btc_lock":"0.00000000","xrp_balance":"0.00000000","xrp_lock":"0.00000000"}}
const result = this.safeValue (response, 'result');
if (result === undefined) {
// public endpoint ← this comment left here by the contributor, in fact a missing result does not necessarily mean a public endpoint...
// we should just check the code and don't rely on the result at all here...
return;
}
if (result === true) {
// success
return;
}
const errorCode = this.safeString (response, 'code');
const errorMessages = this.errorMessages;
const message = this.safeString (errorMessages, errorCode, 'Unknown Error');
const feedback = this.id + ' ' + message;
this.throwExactlyMatchedException (this.exceptions, errorCode, feedback);
throw new ExchangeError (this.id + ' ' + message);
}
};