ccxt-ir 4.9.32 → 4.11.0

package/js/src/src/zaif.js

@@ -0,0 +1,821 @@
+// ----------------------------------------------------------------------------
+
+// PLEASE DO NOT EDIT THIS FILE, IT IS GENERATED AND WILL BE OVERWRITTEN:
+// https://github.com/ccxt/ccxt/blob/master/CONTRIBUTING.md#how-to-contribute-code
+// EDIT THE CORRESPONDENT .ts FILE INSTEAD
+
+//  ---------------------------------------------------------------------------
+import Exchange from './abstract/zaif.js';
+import { ExchangeError, BadRequest } from './base/errors.js';
+import { Precise } from './base/Precise.js';
+import { TICK_SIZE } from './base/functions/number.js';
+import { sha512 } from './static_dependencies/noble-hashes/sha512.js';
+//  ---------------------------------------------------------------------------
+/**
+ * @class zaif
+ * @augments Exchange
+ */
+export default class zaif extends Exchange {
+    describe() {
+        return this.deepExtend(super.describe(), {
+            'id': 'zaif',
+            'name': 'Zaif',
+            'countries': ['JP'],
+            // 10 requests per second = 1000ms / 10 = 100ms between requests (public market endpoints)
+            'rateLimit': 100,
+            'version': '1',
+            'has': {
+                'CORS': undefined,
+                'spot': true,
+                'margin': undefined,
+                'swap': false,
+                'future': false,
+                'option': false,
+                'cancelOrder': true,
+                'createMarketOrder': false,
+                'createOrder': true,
+                'fetchBalance': true,
+                'fetchClosedOrders': true,
+                'fetchFundingHistory': false,
+                'fetchFundingRate': false,
+                'fetchFundingRateHistory': false,
+                'fetchFundingRates': false,
+                'fetchIndexOHLCV': false,
+                'fetchMarkets': true,
+                'fetchMarkOHLCV': false,
+                'fetchOpenInterestHistory': false,
+                'fetchOpenOrders': true,
+                'fetchOrderBook': true,
+                'fetchPremiumIndexOHLCV': false,
+                'fetchTicker': true,
+                'fetchTrades': true,
+                'fetchTradingFee': false,
+                'fetchTradingFees': false,
+                'withdraw': true,
+            },
+            'urls': {
+                'logo': 'https://user-images.githubusercontent.com/1294454/27766927-39ca2ada-5eeb-11e7-972f-1b4199518ca6.jpg',
+                'api': {
+                    'rest': 'https://api.zaif.jp',
+                },
+                'www': 'https://zaif.jp',
+                'doc': [
+                    'https://techbureau-api-document.readthedocs.io/ja/latest/index.html',
+                    'https://corp.zaif.jp/api-docs',
+                    'https://corp.zaif.jp/api-docs/api_links',
+                    'https://www.npmjs.com/package/zaif.jp',
+                    'https://github.com/you21979/node-zaif',
+                ],
+                'fees': 'https://zaif.jp/fee?lang=en',
+            },
+            'fees': {
+                'trading': {
+                    'percentage': true,
+                    'taker': this.parseNumber('0.001'),
+                    'maker': this.parseNumber('0'),
+                },
+            },
+            'api': {
+                'public': {
+                    'get': {
+                        'depth/{pair}': 1,
+                        'currencies/{pair}': 1,
+                        'currencies/all': 1,
+                        'currency_pairs/{pair}': 1,
+                        'currency_pairs/all': 1,
+                        'last_price/{pair}': 1,
+                        'ticker/{pair}': 1,
+                        'trades/{pair}': 1,
+                    },
+                },
+                'private': {
+                    'post': {
+                        'active_orders': 5,
+                        'cancel_order': 5,
+                        'deposit_history': 5,
+                        'get_id_info': 5,
+                        'get_info': 10,
+                        'get_info2': 5,
+                        'get_personal_info': 5,
+                        'trade': 5,
+                        'trade_history': 50,
+                        'withdraw': 5,
+                        'withdraw_history': 5,
+                    },
+                },
+                'ecapi': {
+                    'post': {
+                        'createInvoice': 1,
+                        'getInvoice': 1,
+                        'getInvoiceIdsByOrderNumber': 1,
+                        'cancelInvoice': 1,
+                    },
+                },
+                'tlapi': {
+                    'post': {
+                        'get_positions': 66,
+                        'position_history': 66,
+                        'active_positions': 5,
+                        'create_position': 33,
+                        'change_position': 33,
+                        'cancel_position': 33, // 3 in 10 seconds
+                    },
+                },
+                'fapi': {
+                    'get': {
+                        'groups/{group_id}': 1,
+                        'last_price/{group_id}/{pair}': 1,
+                        'ticker/{group_id}/{pair}': 1,
+                        'trades/{group_id}/{pair}': 1,
+                        'depth/{group_id}/{pair}': 1,
+                    },
+                },
+            },
+            'options': {},
+            'features': {
+                'spot': {
+                    'sandbox': false,
+                    'createOrder': {
+                        'marginMode': true,
+                        'triggerPrice': true,
+                        'triggerDirection': false,
+                        'triggerPriceType': undefined,
+                        'stopLossPrice': false,
+                        'takeProfitPrice': false,
+                        'attachedStopLossTakeProfit': undefined,
+                        'timeInForce': {
+                            'IOC': false,
+                            'FOK': false,
+                            'PO': false,
+                            'GTD': false,
+                        },
+                        'hedged': false,
+                        'trailing': false,
+                        'leverage': true,
+                        'marketBuyByCost': false,
+                        'marketBuyRequiresPrice': false,
+                        'selfTradePrevention': false,
+                        'iceberg': false,
+                    },
+                    'createOrders': undefined,
+                    'fetchMyTrades': undefined,
+                    'fetchOrder': undefined,
+                    'fetchOpenOrders': {
+                        'marginMode': true,
+                        'limit': undefined,
+                        'trigger': false,
+                        'trailing': false,
+                        'symbolRequired': false,
+                    },
+                    'fetchOrders': undefined,
+                    'fetchClosedOrders': {
+                        'marginMode': true,
+                        'limit': 1000,
+                        'daysBack': 100000,
+                        'daysBackCanceled': 1,
+                        'untilDays': 100000,
+                        'trigger': false,
+                        'trailing': false,
+                        'symbolRequired': false,
+                    },
+                    'fetchOHLCV': undefined,
+                },
+                'swap': {
+                    'linear': undefined,
+                    'inverse': undefined,
+                },
+                'future': {
+                    'linear': undefined,
+                    'inverse': undefined,
+                },
+            },
+            'precisionMode': TICK_SIZE,
+            'exceptions': {
+                'exact': {
+                    'unsupported currency_pair': BadRequest, // {"error": "unsupported currency_pair"}
+                },
+                'broad': {},
+            },
+        });
+    }
+    /**
+     * @method
+     * @name zaif#fetchMarkets
+     * @see https://zaif-api-document.readthedocs.io/ja/latest/PublicAPI.html#id12
+     * @description retrieves data on all markets for zaif
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @returns {object[]} an array of objects representing market data
+     */
+    async fetchMarkets(params = {}) {
+        const markets = await this.publicGetCurrencyPairsAll(params);
+        //
+        //     [
+        //         {
+        //             "aux_unit_point": 0,
+        //             "item_japanese": "\u30d3\u30c3\u30c8\u30b3\u30a4\u30f3",
+        //             "aux_unit_step": 5.0,
+        //             "description": "\u30d3\u30c3\u30c8\u30b3\u30a4\u30f3\u30fb\u65e5\u672c\u5186\u306e\u53d6\u5f15\u3092\u884c\u3046\u3053\u3068\u304c\u3067\u304d\u307e\u3059",
+        //             "item_unit_min": 0.001,
+        //             "event_number": 0,
+        //             "currency_pair": "btc_jpy",
+        //             "is_token": false,
+        //             "aux_unit_min": 5.0,
+        //             "aux_japanese": "\u65e5\u672c\u5186",
+        //             "id": 1,
+        //             "item_unit_step": 0.0001,
+        //             "name": "BTC/JPY",
+        //             "seq": 0,
+        //             "title": "BTC/JPY"
+        //         }
+        //     ]
+        //
+        return this.parseMarkets(markets);
+    }
+    parseMarket(market) {
+        const id = this.safeString(market, 'currency_pair');
+        const name = this.safeString(market, 'name');
+        const [baseId, quoteId] = name.split('/');
+        const base = this.safeCurrencyCode(baseId);
+        const quote = this.safeCurrencyCode(quoteId);
+        const symbol = base + '/' + quote;
+        return {
+            'id': id,
+            'symbol': symbol,
+            'base': base,
+            'quote': quote,
+            'settle': undefined,
+            'baseId': baseId,
+            'quoteId': quoteId,
+            'settleId': undefined,
+            'type': 'spot',
+            'spot': true,
+            'margin': undefined,
+            'swap': false,
+            'future': false,
+            'option': false,
+            'active': undefined,
+            'contract': false,
+            'linear': undefined,
+            'inverse': undefined,
+            'contractSize': undefined,
+            'expiry': undefined,
+            'expiryDatetime': undefined,
+            'strike': undefined,
+            'optionType': undefined,
+            'precision': {
+                'amount': this.safeNumber(market, 'item_unit_step'),
+                'price': this.parseNumber(this.parsePrecision(this.safeString(market, 'aux_unit_point'))),
+            },
+            'limits': {
+                'leverage': {
+                    'min': undefined,
+                    'max': undefined,
+                },
+                'amount': {
+                    'min': this.safeNumber(market, 'item_unit_min'),
+                    'max': undefined,
+                },
+                'price': {
+                    'min': this.safeNumber(market, 'aux_unit_min'),
+                    'max': undefined,
+                },
+                'cost': {
+                    'min': undefined,
+                    'max': undefined,
+                },
+            },
+            'created': undefined,
+            'info': market,
+        };
+    }
+    parseBalance(response) {
+        const balances = this.safeValue(response, 'return', {});
+        const deposit = this.safeValue(balances, 'deposit');
+        const result = {
+            'info': response,
+            'timestamp': undefined,
+            'datetime': undefined,
+        };
+        const funds = this.safeValue(balances, 'funds', {});
+        const currencyIds = Object.keys(funds);
+        for (let i = 0; i < currencyIds.length; i++) {
+            const currencyId = currencyIds[i];
+            const code = this.safeCurrencyCode(currencyId);
+            const balance = this.safeString(funds, currencyId);
+            const account = this.account();
+            account['free'] = balance;
+            account['total'] = balance;
+            if (deposit !== undefined) {
+                if (currencyId in deposit) {
+                    account['total'] = this.safeString(deposit, currencyId);
+                }
+            }
+            result[code] = account;
+        }
+        return this.safeBalance(result);
+    }
+    /**
+     * @method
+     * @name zaif#fetchBalance
+     * @see https://zaif-api-document.readthedocs.io/ja/latest/TradingAPI.html#id10
+     * @description query for balance and get the amount of funds available for trading or funds locked in orders
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @returns {object} a [balance structure]{@link https://docs.ccxt.com/#/?id=balance-structure}
+     */
+    async fetchBalance(params = {}) {
+        await this.loadMarkets();
+        const response = await this.privatePostGetInfo(params);
+        return this.parseBalance(response);
+    }
+    /**
+     * @method
+     * @name zaif#fetchOrderBook
+     * @see https://zaif-api-document.readthedocs.io/ja/latest/PublicAPI.html#id34
+     * @description fetches information on open orders with bid (buy) and ask (sell) prices, volumes and other data
+     * @param {string} symbol unified symbol of the market to fetch the order book for
+     * @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
+     */
+    async fetchOrderBook(symbol, limit = undefined, params = {}) {
+        await this.loadMarkets();
+        const market = this.market(symbol);
+        const request = {
+            'pair': market['id'],
+        };
+        const response = await this.publicGetDepthPair(this.extend(request, params));
+        return this.parseOrderBook(response, market['symbol']);
+    }
+    parseTicker(ticker, market = undefined) {
+        //
+        // {
+        //     "last": 9e-08,
+        //     "high": 1e-07,
+        //     "low": 9e-08,
+        //     "vwap": 0.0,
+        //     "volume": 135250.0,
+        //     "bid": 9e-08,
+        //     "ask": 1e-07
+        // }
+        //
+        const symbol = this.safeSymbol(undefined, market);
+        const vwap = this.safeString(ticker, 'vwap');
+        const baseVolume = this.safeString(ticker, 'volume');
+        const quoteVolume = Precise.stringMul(baseVolume, vwap);
+        const last = this.safeString(ticker, 'last');
+        return this.safeTicker({
+            'symbol': symbol,
+            'timestamp': undefined,
+            'datetime': undefined,
+            'high': this.safeString(ticker, 'high'),
+            'low': this.safeString(ticker, 'low'),
+            'bid': this.safeString(ticker, 'bid'),
+            'bidVolume': undefined,
+            'ask': this.safeString(ticker, 'ask'),
+            'askVolume': undefined,
+            'vwap': vwap,
+            'open': undefined,
+            'close': last,
+            'last': last,
+            'previousClose': undefined,
+            'change': undefined,
+            'percentage': undefined,
+            'average': undefined,
+            'baseVolume': baseVolume,
+            'quoteVolume': quoteVolume,
+            'info': ticker,
+        }, market);
+    }
+    /**
+     * @method
+     * @name zaif#fetchTicker
+     * @see https://zaif-api-document.readthedocs.io/ja/latest/PublicAPI.html#id22
+     * @description fetches a price ticker, a statistical calculation with the information calculated over the past 24 hours for a specific market
+     * @param {string} symbol unified symbol of the market to fetch the ticker for
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @returns {object} a [ticker structure]{@link https://docs.ccxt.com/#/?id=ticker-structure}
+     */
+    async fetchTicker(symbol, params = {}) {
+        await this.loadMarkets();
+        const market = this.market(symbol);
+        const request = {
+            'pair': market['id'],
+        };
+        const ticker = await this.publicGetTickerPair(this.extend(request, params));
+        //
+        // {
+        //     "last": 9e-08,
+        //     "high": 1e-07,
+        //     "low": 9e-08,
+        //     "vwap": 0.0,
+        //     "volume": 135250.0,
+        //     "bid": 9e-08,
+        //     "ask": 1e-07
+        // }
+        //
+        return this.parseTicker(ticker, market);
+    }
+    parseTrade(trade, market = undefined) {
+        //
+        // fetchTrades (public)
+        //
+        //      {
+        //          "date": 1648559414,
+        //          "price": 5880375.0,
+        //          "amount": 0.017,
+        //          "tid": 176126557,
+        //          "currency_pair": "btc_jpy",
+        //          "trade_type": "ask"
+        //      }
+        //
+        let side = this.safeString(trade, 'trade_type');
+        side = (side === 'bid') ? 'buy' : 'sell';
+        const timestamp = this.safeTimestamp(trade, 'date');
+        const id = this.safeString2(trade, 'id', 'tid');
+        const priceString = this.safeString(trade, 'price');
+        const amountString = this.safeString(trade, 'amount');
+        const marketId = this.safeString(trade, 'currency_pair');
+        const symbol = this.safeSymbol(marketId, market, '_');
+        return this.safeTrade({
+            'id': id,
+            'info': trade,
+            'timestamp': timestamp,
+            'datetime': this.iso8601(timestamp),
+            'symbol': symbol,
+            'type': undefined,
+            'side': side,
+            'order': undefined,
+            'takerOrMaker': undefined,
+            'price': priceString,
+            'amount': amountString,
+            'cost': undefined,
+            'fee': undefined,
+        }, market);
+    }
+    /**
+     * @method
+     * @name zaif#fetchTrades
+     * @see https://zaif-api-document.readthedocs.io/ja/latest/PublicAPI.html#id28
+     * @description get the list of most recent trades for a particular symbol
+     * @param {string} symbol 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 {Trade[]} a list of [trade structures]{@link https://docs.ccxt.com/#/?id=public-trades}
+     */
+    async fetchTrades(symbol, since = undefined, limit = undefined, params = {}) {
+        await this.loadMarkets();
+        const market = this.market(symbol);
+        const request = {
+            'pair': market['id'],
+        };
+        let response = await this.publicGetTradesPair(this.extend(request, params));
+        //
+        //      [
+        //          {
+        //              "date": 1648559414,
+        //              "price": 5880375.0,
+        //              "amount": 0.017,
+        //              "tid": 176126557,
+        //              "currency_pair": "btc_jpy",
+        //              "trade_type": "ask"
+        //          }, ...
+        //      ]
+        //
+        const numTrades = response.length;
+        if (numTrades === 1) {
+            const firstTrade = response[0];
+            if (!Object.keys(firstTrade).length) {
+                response = [];
+            }
+        }
+        return this.parseTrades(response, market, since, limit);
+    }
+    /**
+     * @method
+     * @name zaif#createOrder
+     * @see https://zaif-api-document.readthedocs.io/ja/latest/MarginTradingAPI.html#id23
+     * @description create a trade order
+     * @param {string} symbol unified symbol of the market to create an order in
+     * @param {string} type must be 'limit'
+     * @param {string} side 'buy' or 'sell'
+     * @param {float} amount how much of currency you want to trade in units of base currency
+     * @param {float} [price] the price at which the order is to be fulfilled, in units of the quote currency, ignored in market orders
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @returns {object} an [order structure]{@link https://docs.ccxt.com/#/?id=order-structure}
+     */
+    async createOrder(symbol, type, side, amount, price = undefined, params = {}) {
+        await this.loadMarkets();
+        if (type !== 'limit') {
+            throw new ExchangeError(this.id + ' createOrder() allows limit orders only');
+        }
+        const market = this.market(symbol);
+        const request = {
+            'currency_pair': market['id'],
+            'action': (side === 'buy') ? 'bid' : 'ask',
+            'amount': amount,
+            'price': price,
+        };
+        const response = await this.privatePostTrade(this.extend(request, params));
+        return this.safeOrder({
+            'info': response,
+            'id': response['return']['order_id'].toString(),
+        }, market);
+    }
+    /**
+     * @method
+     * @name zaif#cancelOrder
+     * @see https://zaif-api-document.readthedocs.io/ja/latest/TradingAPI.html#id37
+     * @description cancels an open order
+     * @param {string} id order id
+     * @param {string} symbol not used by zaif cancelOrder ()
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @returns {object} An [order structure]{@link https://docs.ccxt.com/#/?id=order-structure}
+     */
+    async cancelOrder(id, symbol = undefined, params = {}) {
+        const request = {
+            'order_id': id,
+        };
+        const response = await this.privatePostCancelOrder(this.extend(request, params));
+        //
+        //    {
+        //        "success": 1,
+        //        "return": {
+        //            "order_id": 184,
+        //            "funds": {
+        //                "jpy": 15320,
+        //                "btc": 1.392,
+        //                "mona": 2600,
+        //                "kaori": 0.1
+        //            }
+        //        }
+        //    }
+        //
+        const data = this.safeDict(response, 'return');
+        return this.parseOrder(data);
+    }
+    parseOrder(order, market = undefined) {
+        //
+        //     {
+        //         "currency_pair": "btc_jpy",
+        //         "action": "ask",
+        //         "amount": 0.03,
+        //         "price": 56000,
+        //         "timestamp": 1402021125,
+        //         "comment" : "demo"
+        //     }
+        //
+        // cancelOrder
+        //
+        //    {
+        //        "order_id": 184,
+        //        "funds": {
+        //            "jpy": 15320,
+        //            "btc": 1.392,
+        //            "mona": 2600,
+        //            "kaori": 0.1
+        //        }
+        //    }
+        //
+        let side = this.safeString(order, 'action');
+        side = (side === 'bid') ? 'buy' : 'sell';
+        const timestamp = this.safeTimestamp(order, 'timestamp');
+        const marketId = this.safeString(order, 'currency_pair');
+        const symbol = this.safeSymbol(marketId, market, '_');
+        const price = this.safeString(order, 'price');
+        const amount = this.safeString(order, 'amount');
+        const id = this.safeString2(order, 'id', 'order_id');
+        return this.safeOrder({
+            'id': id,
+            'clientOrderId': undefined,
+            'timestamp': timestamp,
+            'datetime': this.iso8601(timestamp),
+            'lastTradeTimestamp': undefined,
+            'status': 'open',
+            'symbol': symbol,
+            'type': 'limit',
+            'timeInForce': undefined,
+            'postOnly': undefined,
+            'side': side,
+            'price': price,
+            'triggerPrice': undefined,
+            'cost': undefined,
+            'amount': amount,
+            'filled': undefined,
+            'remaining': undefined,
+            'trades': undefined,
+            'fee': undefined,
+            'info': order,
+            'average': undefined,
+        }, market);
+    }
+    /**
+     * @method
+     * @name zaif#fetchOpenOrders
+     * @see https://zaif-api-document.readthedocs.io/ja/latest/MarginTradingAPI.html#id28
+     * @description fetch all unfilled currently open orders
+     * @param {string} symbol unified market symbol
+     * @param {int} [since] the earliest time in ms to fetch open orders for
+     * @param {int} [limit] the maximum number of  open orders structures to retrieve
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @returns {Order[]} a list of [order structures]{@link https://docs.ccxt.com/#/?id=order-structure}
+     */
+    async fetchOpenOrders(symbol = undefined, since = undefined, limit = undefined, params = {}) {
+        await this.loadMarkets();
+        let market = undefined;
+        const request = {
+        // 'is_token': false,
+        // 'is_token_both': false,
+        };
+        if (symbol !== undefined) {
+            market = this.market(symbol);
+            request['currency_pair'] = market['id'];
+        }
+        const response = await this.privatePostActiveOrders(this.extend(request, params));
+        return this.parseOrders(response['return'], market, since, limit);
+    }
+    /**
+     * @method
+     * @name zaif#fetchClosedOrders
+     * @see https://zaif-api-document.readthedocs.io/ja/latest/TradingAPI.html#id24
+     * @description fetches information on multiple closed orders made by the user
+     * @param {string} symbol unified market symbol of the market orders were made in
+     * @param {int} [since] the earliest time in ms to fetch orders for
+     * @param {int} [limit] the maximum number of order structures to retrieve
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @returns {Order[]} a list of [order structures]{@link https://docs.ccxt.com/#/?id=order-structure}
+     */
+    async fetchClosedOrders(symbol = undefined, since = undefined, limit = undefined, params = {}) {
+        await this.loadMarkets();
+        let market = undefined;
+        const request = {
+        // 'from': 0,
+        // 'count': 1000,
+        // 'from_id': 0,
+        // 'end_id': 1000,
+        // 'order': 'DESC',
+        // 'since': 1503821051,
+        // 'end': 1503821051,
+        // 'is_token': false,
+        };
+        if (symbol !== undefined) {
+            market = this.market(symbol);
+            request['currency_pair'] = market['id'];
+        }
+        const response = await this.privatePostTradeHistory(this.extend(request, params));
+        return this.parseOrders(response['return'], market, since, limit);
+    }
+    /**
+     * @method
+     * @name zaif#withdraw
+     * @see https://zaif-api-document.readthedocs.io/ja/latest/TradingAPI.html#id41
+     * @description make a withdrawal
+     * @param {string} code unified currency code
+     * @param {float} amount the amount to withdraw
+     * @param {string} address the address to withdraw to
+     * @param {string} tag
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @returns {object} a [transaction structure]{@link https://docs.ccxt.com/#/?id=transaction-structure}
+     */
+    async withdraw(code, amount, address, tag = undefined, params = {}) {
+        [tag, params] = this.handleWithdrawTagAndParams(tag, params);
+        this.checkAddress(address);
+        await this.loadMarkets();
+        const currency = this.currency(code);
+        if (code === 'JPY') {
+            throw new ExchangeError(this.id + ' withdraw() does not allow ' + code + ' withdrawals');
+        }
+        const request = {
+            'currency': currency['id'],
+            'amount': amount,
+            'address': address,
+            // 'message': 'Hi!', // XEM and others
+            // 'opt_fee': 0.003, // BTC and MONA only
+        };
+        if (tag !== undefined) {
+            request['message'] = tag;
+        }
+        const result = await this.privatePostWithdraw(this.extend(request, params));
+        //
+        //     {
+        //         "success": 1,
+        //         "return": {
+        //             "id": 23634,
+        //             "fee": 0.001,
+        //             "txid":,
+        //             "funds": {
+        //                 "jpy": 15320,
+        //                 "btc": 1.392,
+        //                 "xem": 100.2,
+        //                 "mona": 2600
+        //             }
+        //         }
+        //     }
+        //
+        const returnData = this.safeDict(result, 'return');
+        return this.parseTransaction(returnData, currency);
+    }
+    parseTransaction(transaction, currency = undefined) {
+        //
+        //     {
+        //         "id": 23634,
+        //         "fee": 0.001,
+        //         "txid":,
+        //         "funds": {
+        //             "jpy": 15320,
+        //             "btc": 1.392,
+        //             "xem": 100.2,
+        //             "mona": 2600
+        //         }
+        //     }
+        //
+        currency = this.safeCurrency(undefined, currency);
+        let fee = undefined;
+        const feeCost = this.safeValue(transaction, 'fee');
+        if (feeCost !== undefined) {
+            fee = {
+                'cost': feeCost,
+                'currency': currency['code'],
+            };
+        }
+        return {
+            'id': this.safeString(transaction, 'id'),
+            'txid': this.safeString(transaction, 'txid'),
+            'timestamp': undefined,
+            'datetime': undefined,
+            'network': undefined,
+            'addressFrom': undefined,
+            'address': undefined,
+            'addressTo': undefined,
+            'amount': undefined,
+            'type': undefined,
+            'currency': currency['code'],
+            'status': undefined,
+            'updated': undefined,
+            'tagFrom': undefined,
+            'tag': undefined,
+            'tagTo': undefined,
+            'comment': undefined,
+            'internal': undefined,
+            'fee': fee,
+            'info': transaction,
+        };
+    }
+    customNonce() {
+        const num = this.numberToString(this.milliseconds() / 1000);
+        const nonce = parseFloat(num);
+        return nonce.toFixed(8);
+    }
+    sign(path, api = 'public', method = 'GET', params = {}, headers = undefined, body = undefined) {
+        let url = this.urls['api']['rest'] + '/';
+        if (api === 'public') {
+            url += 'api/' + this.version + '/' + this.implodeParams(path, params);
+        }
+        else if (api === 'fapi') {
+            url += 'fapi/' + this.version + '/' + this.implodeParams(path, params);
+        }
+        else {
+            this.checkRequiredCredentials();
+            if (api === 'ecapi') {
+                url += 'ecapi';
+            }
+            else if (api === 'tlapi') {
+                url += 'tlapi';
+            }
+            else {
+                url += 'tapi';
+            }
+            const nonce = this.customNonce();
+            body = this.urlencode(this.extend({
+                'method': path,
+                'nonce': nonce,
+            }, params));
+            headers = {
+                'Content-Type': 'application/x-www-form-urlencoded',
+                'Key': this.apiKey,
+                'Sign': this.hmac(this.encode(body), this.encode(this.secret), sha512),
+            };
+        }
+        return { 'url': url, 'method': method, 'body': body, 'headers': headers };
+    }
+    handleErrors(httpCode, reason, url, method, headers, body, response, requestHeaders, requestBody) {
+        if (response === undefined) {
+            return undefined;
+        }
+        //
+        //     {"error": "unsupported currency_pair"}
+        //
+        const feedback = this.id + ' ' + body;
+        const error = this.safeString(response, 'error');
+        if (error !== undefined) {
+            this.throwExactlyMatchedException(this.exceptions['exact'], error, feedback);
+            this.throwBroadlyMatchedException(this.exceptions['broad'], error, feedback);
+            throw new ExchangeError(feedback); // unknown message
+        }
+        const success = this.safeBool(response, 'success', true);
+        if (!success) {
+            throw new ExchangeError(feedback);
+        }
+        return undefined;
+    }
+}