Repository files navigation

Command Line Interface (CLI) / library centralizing several crypto currencies exchanges REST API into a single, ergonomic all in one tool with a unified interface.

Main features:

• Currencies
• Markets
• Currency conversions
• Ticker
• Orderbook
• Traded volume
• Last price
• Last trades
• Withdraw fees

• Balance
• Trade (buy & sell in several flavors)
• Deposit information (address & tag)
• Recent Deposits
• Recent Withdraws
• Closed orders
• Opened orders
• Cancel opened orders
• Withdraw (with check at destination that funds are well received)
• Dust sweeper

coincenter is able to store the following market data in serializedbinary protobuf format for offline trading algorithm replay:

• Market order book
• Public trades

Refer to the dedicateddocumentation page for more information.

Exchange	Link
Binance
Bithumb
Huobi
Kraken
Kucoin
Upbit

coincenter is not just another random implementation of some exchanges' REST API, it also provides ahigher abstraction of each platform specificities by providing workarounds for the ones not implementing some queries (for instance,withdrawal fees is rarely accessible with the public endpoint, butcoincenter can handle their query for all exchanges, by using screen scraping techniques of external resources when needed).

Also, ittakes the user by the hand for more complex queries, liketrades andwithdraws, working by default insynchronized mode until the operation is finished (withdraw will not finish until the funds arereceived andavailable at destination,trade will not finish until the opened order is eithermatched / canceled).

Technically speaking, this project is forC++ enthusiasts providing an alternative to other crypto exchanges clients often written in higher level languages. It is an illustration of the elegance and possibilities of modernC++ in an area where it is (sadly) barely chosen.

Of course, all suggestions to improve the project are welcome (should it be bug fixing, support of a new crypto exchange, feature addition / improvements or even technical aspects about the source code and best development practices).

SeeINSTALL.md

SeeCONFIG.md

coincenter is a command line tool with ergonomic and easy to remember option schema. You will usually provide this kind of input:

• Command name, without hyphen (check what are the available ones withhelp)
• Followed by either:
  • Nothing, meaning that command will be applied globally, when applicable
  • Amount with currency or any currency, separated by dash to specify pairs, or source - destination
  • Comma separated list of exchanges (all are considered if not provided)

Example:

                  Ori curr.   exchange1||coincenter trade 0.05BTC-USDT,kraken,huobi|||             from amt.  to curr.    exchange2

By default, result of command is printed in a formatted table on standard output.You can also choose ajson output format with option-o json.

It is possible to give multiple commands that are to be executed sequentially. A new command name indicates the beginning of a new command.

For instance:

         1stcommand                      2ndcommand options|                               /       \coincenter balance orderbook XRP-USDT,binance --cur EUR\                       /                           2ndcommand

Some commands' input can be deduced from previous commands' output, a bit like piping commands in Linux works.Input commands accepting previous commands' output are:

• Withdraw
• Trade
• Sell

For example:

               1stcommand                        3rdcommand           /\                      /  \coincenter buy 1500XLM,binance withdraw-apply kraken sell\                 /                                    2ndcommand

The 1500XLM will be considered for withdraw from Binance if the buy is completed, and the XLM arrived on Kraken considered for selling when the withdraw completes.

coincenter commands are normally executed only once, and program is terminated after it.To continuously query the same option use-r <[n]> or--repeat <[n]> (then integer is optional) to repeatn times the given command(s) (or undefinably if non given).

Warning: for trades and withdraw commands, use with care.

Between each repeat you can set a waiting time with--repeat-time option which expects a time duration.

It can be useful to store logs for an extended period of time and formonitoring data export purposes.

coincenter can exit gracefully withSIGINT andSIGTERM signals. When it receives such a signal,coincenter will stop processing commands after current one (ignoring therepeat as well).

This allows to flush correctly the latest data (caches, logs, etc) to files at termination.

coincenter usesspdlog for logging.

spdlog is set up asynchronously, and it's possible to log in rotating files in addition of the console, with different levels for each.

By default, it logs in the console with the 'info' level, and in 'debug' in rotating files.

For this, you can configure statically the default level for each in theconfig file.It can be overridden on the command line, with options--log <log-level> and--log-file <log-level>.

It is also possible to store relevant commands results (indata/log/activity_history_YYYY-MM.txt files) to keep track of the most important commands ofcoincenter.Each time a command of type present in the user defined list inlog.activityTracking.commandTypes fromgeneralconfig.json file is finished, its result is appended in json format to the corresponding activity history file of the current year and month.

This is useful for instance to keep track of all trades performed and can be later used for analytics of past performance gains / losses.

By default, it stores all types of trades and withdraws results, but the list is configurable to follow your needs.

Important: those files contain important information socoincenter does not clean them automatically. You can move the old activity history files if they take to much space after a while.

You may want to query several exchanges for a command at the same time. In this case, it's possible to askcoincenter to launch requests in parallel when it's possible.By default, the number of requests in parallel is1. To increase it, change the value of the fieldnbMaxParallelRequests ingeneralconfig.json file (more informationhere).

You will have a nice boost of speed when you query the same thing from multiple exchanges / or accounts. However, the logs may not be ordered anymore.

health-check pings the exchanges and checks if there are up and running.It is the first thing that is checked in exchanges unit tests, hence if the health check fails for an exchange, the tests are skipped for the exchange.

currencies command aggregates currency codes for given list of exchanges. It also tells for which exchanges it can be deposited to, withdrawn from, and if it is a fiat money.

List all currencies for all supported exchanges

coincenter currencies

List all currencies for kucoin and upbit

coincenter currencies kucoin,upbit

Use themarkets command to list markets. This is useful to check how you can trade your coins.It takes an optional combination of a maximum of two currencies:

• if none is specified, all markets are returned
• if only one is specified, all markets trading the currency will be returned
• if two currencies are specified (should be separated with-), only exchanges listing given market will be returned

Also, result can be narrowed to list of exchanges given after the optional currencies. If no exchanges are provided,coincenter will simply query all supported exchanges and list the markets involving the given currencies if they exist.

Note: Markets are returned with the currency pair presented in original order from the exchange, as it could give additional information for services relying on this option (even though it's not needed fortrade option ofcoincenter)

Lists all markets for all exchanges

coincenter markets

List all markets involving Ethereum in Huobi

coincenter markets eth,huobi

List exchanges where the pair AVAX-USDT is supported

coincenter markets avax-usdt

Retrieve ticker information for all markets of one, several or all exchanges withticker [exchange1,exchange2,...] option.List of exchanges should be given as lower case, comma separated. But it is optional, all exchanges are considered if not provided.

Example: Print ticker information for kraken and huobi exchanges

coincenter ticker kraken,huobi

Check market order books of a currency pair withorderbook option. By default, chosendepth is10, can be configured with--depth.Similarly toticker option, exchanges list is optional. If not provided, all exchanges will be queried and only the market order books from exchange with proposes this market are returned.

In addition, for convenience, you can also specify a currency in which to convert the price if you are more familiar with it. For instance, you want to print the order book of BTC-KRW in Bithumb exchange, but as you are not familiar with Korean won, you want to convert to USD as well.--cur usd is for this purpose.

Example: Print ADA (Cardano) - USDT market order book with a depth of 20 on Kraken and Binance

coincenter orderbook ada-usdt,kraken,binance --depth 20

Fast query last 24h traded volume withvolume-day option on one market on one, several or all exchanges (as usual, see above options).

Example: Print last 24h traded volume on market XLM-BTC for all exchanges supporting it

coincenter volume-day xlm-btc

Fast query last traded price withprice option on one market on one, several or all exchanges (as usual, see above options).

Example: Print last price on market SOL-BTC for all exchanges supporting it

coincenter price sol-btc

Get a sorted list of last trades withlast-trades option on one market on one, several or all exchanges.You can specify the number of last trades to query (for exchanges supporting this option) with--n.

Example: Print the last 15 trades on DOT-USDT on Binance and Huobi

coincenter last-trades dot-usdt,binance,huobi --n 15

From a starting amount to a destination currency,conversion examines the shortest conversion path (in terms of number of conversion) possible to reach the destination currency, on optional list of exchanges, and return the converted amount on each exchange where such conversion is possible. The trade feesare taken into account for this conversion.

The conversion path chosen is the fastest (in terms of number of markets, so trades) possible.

Important note: fiat conversions (including fiat-like crypto-currencies likeUSDT) are allowed even if the corresponding market is not an exchange market only as a first or a last conversion. No trade fees are taken into account for fiat conversions.

coincenter conversion 1000shib-sol

Possible output:

+----------+------------------------------+| Exchange| 1000 SHIB converted into SOL|+----------+------------------------------+| binance| 0.00020324242724052 SOL|| bithumb| 0.00020297245011085 SOL|| huobi| 0.00020276144764053 SOL|| kraken| 0.00020323457500308 SOL|| kucoin| 0.00020338540268269 SOL|| upbit| 0.00020302426059262 SOL|+----------+------------------------------+

coincenter conversion 1000eur-eth

Possible output:

+----------+-----------------------------+| Exchange| 1000 EUR converted into ETH|+----------+-----------------------------+| binance| 0.31121398375705967 ETH|| bithumb| 0.29715335705445442 ETH|| huobi| 0.30978082796054002 ETH|| kraken| 0.3110542008206231 ETH|| kucoin| 0.31194281985067939 ETH|| upbit| 0.29672491761070147 ETH|+----------+-----------------------------+

This option is similar to previous one (conversion) but takes a starting currency code instead of an amount to convert, and only real markets from exchanges are taken into account (in particular, fiat conversions that are not proposed by the exchange as a market are not possible).

It will print the result as an ordered list of markets for each exchange.

Optionconversion-path is used internally formulti trade but is provided as a stand-alone query for information.

coincenter conversion-path shib-sol

Possible output:

+----------+--------------------------------------+| Exchange| Fastest conversion pathfor SHIB-SOL|+----------+--------------------------------------+| binance| SHIB-FDUSD,SOL-FDUSD|| bithumb| SHIB-KRW,SOL-KRW|| huobi| SHIB-USDT,SOL-USDT|| kraken| SHIB-USDT,SOL-USDT|| kucoin| SHIB-USDC,SOL-USDC|| upbit| SHIB-KRW,SOL-KRW|+----------+--------------------------------------+

Note: when several conversion paths of same length are possible, it will favor the ones not involving fiat currencies (stable coins arenot considered as fiat currencies).

Some exchanges provide a withdraw fees endpoint. Some propose it without an API Key, other require an API Key.coincenter uses other sources of data (although less reliable) for exchanges which do not propose withdraw fees.

You can query all withdraw fees at once, for all exchanges or provided ones. You can also specify a currency to filter fees only for this currency.

coincenter withdraw-fees

coincenter withdraw-fees eth,kraken,kucoin

These requests will require that you have your secret keys indata/secret/secret.json file, for each exchange used.You can check easily that it works correctly with thebalance option.

coincenter supports several keys per exchange. Here are both ways to target exchange(s) forcoincenter:

• exchange matchesall keys on exchangeexchange
• exchange_keyname matchesonlykeyname on exchangeexchange

All options use this pattern, but they will behave differently if several keys are matched for one exchange. For instance:

• Balance will sum all balance for matching accounts
• Trade and multi trade will share the amount to be trade across the matching exchanges, depending on the amount available on each (seetrade).

Example:

Let's say you havejack andjoe accounts (the name of the keys insecret.json file) forkraken:

{"kraken": {"jack": {"key":"...","private":"..."    },"joe": {"key":"...","private":"..."    }  }}

When you need to specify one key, you can suffixjack orjoe after the exchange namekraken:kraken_joe.

If you have only one key per exchange, suffixing with the name is not necessary forall commands (but supported):

{"binance": {"averell": {"key":"...","private":"..."    }  }}

Check your available balance across supported exchanges at one glance!

coincenter balance

prints a formatted table with sum of assets from all loaded private keys (for all exchanges).It is also possible to give a list of exchanges (comma separated) to print balance only on those ones.

You can also specify a currency to which all assets will be converted (if possible) to have a nice estimation of your total balance in your currency.The currency acronym should be at the first position of the comma separated values, the next ones being the accounts.For instance, to print total balance on Kraken and Bithumb exchanges, with a summary currency ofEuro:

coincenter balance eur,kraken,bithumb

By default, the balance displayed is the available one, with opened orders remaining unmatched amounts deduced.To include balance in use as well,--in-use should be added.

A trade is a request to change a certain amount in a given currency into another currency on a list of considered exchanges (or all if none specified).It can be tailored with a range of options:

• Absolute start amount or percentage of available amount
• Single / multi trade
• Automatic price chooser strategy
• Custom price
• Timeout
• Asynchronous mode
• Smart multi account behavior (see below)

Similarly to other options, list of exchanges is optional.If empty, all exchanges having some balance for given start amount may be considered.When several accounts are involved, the trade are performed on the exchanges providing the most available starting amount to trade in priority, and are selected until total available reaches the desired one. This behavior ensures the minimum number of independent trades to reach the desired goal.Check theexamples below for more precise information.

Given start amount can be absolute, or relative with the% character. In the latter case, the total start amount will be computed from the total available amounts of the matching exchanges. This implies a call tobalance on the considered exchanges before the actual trade. Percentages should not be larger than100 and may be decimal numbers.

If only one private exchange is given and start amount is absolute,coincenter will not query your funds prior to the trade to minimize response time, make sure that inputs are correct or program may throw an exception.

A trade has two input flavors.

This is the most common trade input. You will need to provide, in order:

• decimal, positive amount, absolute (default) or relative (percentage suffixed with%)
• first currency linked to this amount
• a dash- to help parser split the two currencies
• second currency destination of the wished trade
• optional list of exchanges where to perform the trade (if several accounts are matched, the amount will be split among them, with a designated strategy)

coincenter trade 35.5%ETH-USDT,kucoin

This second flavor can be useful for piped commands. The unique trade input argument will be thedestination currency. The amount and considered exchanges will be deduced from the output of the previous command.

Example:

You withdraw a certain amount of ETH from exchange kraken to kucoin. You want to trade the received amount on kucoin to USDT:

coincenter withdraw-apply 1.45ETH,kraken-kucoin trade USDT

If the previous command is a withdraw, input exchange list is a single one.

Note that trades themselves can be piped, as the output has an amount and list of exchanges.

Trade 15 % of my all available BTC to USDT (whatever the exchanges), and trade all the resulted USDT to ETH:

coincenter trade 15%BTC-USDT trade ETH

Important note: the piped command will be possible only if the previous command iscomplete. For a trade (or buy / sell), a successful command implies that all the initial amount has been traded from, that no remaining unmatched amount is left. For a withdraw, it means that it successfully arrived to the destination exchange.

A trade issynchronous by default with the created order ofcoincenter (it follows the lifetime of the order).The trade ends when one of the following events occur:

• Order is matched completely
• Order has still some unmatched amount when trade reaches thetimeout

By default, the trade timeout is set to *30 seconds. If you wish to change it, you can use--timeout option. It expects a time and supports all the common time suffixesy (years),mon (months),w (weeks),d (days),h (hours),min (minutes),s (seconds),ms (milliseconds) andus (microseconds).

Value can contain several units, but do not support decimal values. For instance, use2min30s instead of2.5min.

Another example:--timeout 3min30s504ms

Above option allows to control the full life time of a trade until it is either fully matched or cancelled (at timeout).If you want to onlyfire and forget an order placement, you can use--async flag.It will exit the place process as soon as the order is placed, before any query of order information, hence it's the fastest way to place an order.

Note that it's not equivalent of choosing azero trade timeout (above option), here are the differences:

• Order is not cancelled after the trade process in asynchronous mode, whereas it's either cancelled or matched directly in synchronous mode
• Asynchronous trade is faster as it does not even query order information

Possible order price strategies, configurable with--price-strategy:

• maker: order placed at limit price and regularly updated to limit price (default)
• taker: order placed at market price, should be matched immediately
• nibble: order price continuously set at limit price + (buy)/- (sell) 1. This is a hybrid mode between the above two methods, ensuring continuous partial matches of the order over time, but at a controlled price (market price can be dangerously low for some short periods of time with large sells)

Use command line optiontrade to make a trade from a departure amount.

In order to control more precisely the price of the order,coincenter supports custom price as well thanks to--price option. Note that this is not compatible with abovetrade price strategy option.--price expects either an integer (!= 0) representing arelative price compared to the limit price, or a monetary amount representing anabsolute fixed price (decimal amount with the price currency).In fact, parser will recognize a relative price if the amount is without any decimals and without any currency. The price currency will be overridden by the engine, but you can add it for readability and to remove ambiguity of an integer price for the parser.

When requesting an absolute price, the order will be placed exactly at this price. Depending on the order book and the limit prices, order may or may not be matched instantly. Double check the price before launching your trade command!

Notes:

• Such an order will not be compatible withmulti trade because an absolute price makes sense only for a specific market. However, if you ask a multi trade with a fixed price, no error will be raised, andcoincenter will simply launch a single trade.
• Order price will not be continuously updated over time

Therelative price makes it possible to easily settle a price anywhere in the orderbook. The chosen price isrelative to the order book limit price - it represents how far away the price is related to the 'center' prices. The higher (or lower) the value, the more difficult it will be for the order to be bought - or sold.

A positive value indicates a higher price for a sell, and a lower price for a buy, resulting in a safe position that should not be matched immediately. A negative value is the opposite - which will most probably be matched immediately, depending on the amount of the order.

So, choosing a relative price of1:--price 1 is equivalent as themaker trade price strategy, and choosing a relative price of-1 is equivalent to thenibble strategy.

The relative price is, contrary to theabsolute (fixed) price above, compatible with multi-trade. Also, it is continuously updated over time depending on the--update-price option.

Here is a visual example, considering an order book of market A-B:

Say you want to place a buy order ofA with nB at relative price3 for instance:

coincenter trade nB-A --price 3

The chosen price will be0.42.

Instead of providing a start amount to trade, specify a currency. Sotrade-all XXX... is equivalent totrade 100%XXX.

Example: Trade all available EUR on all exchanges to BTC

coincenter trade-all EUR-BTC

coincenter trade 1btc-usdt

Trade 1 BTC to USDT on all exchanges supporting BTC-USDT market and having some available BTC.

coincenter trade 66.6%xlm-btc,kraken,huobi

Among all available XLM amount on all accounts on Kraken and Huobi, launch trades with a total of 66.6 % of starting XLM.

There is a total of600 XLM available on all accounts of Kraken and Huobi, trading a total of 66.6 % of them:399.6 XLM.Prioritize the accounts with the largest amount of XLM first.

coincenter trade 0.5btc-eur,kraken --sim --strategy nibble --timeout 1min

Trade 0.5 BTC to euros on all Kraken accounts, in simulated mode (no real order will be placed, useful for tests), with the 'nibble' strategy, an emergency mode triggered before 2 seconds of the timeout of 1 minute

coincenter trade-all doge-usdt,binance_user1,huobi --strategy taker

Trade all DOGE to USDT on Binance account with key name 'user1' and all Huobi accounts, with the 'taker' strategy, keeping default time out and cancel remaining untouched amount when trade expires

You can also choose the behavior of the trade when timeout is reached, thanks to--timeout-match option. By default, when the trade expires, the last unmatched order is cancelled. With above option, instead it places a last order at market price (should be matched immediately).

If you want to trade coinAAA intoCCC but exchange does not have aAAA-CCC market and haveAAA-BBB andBBB-CCC, then it's possible with a multi trade, which will perform a series of trades in order until the destination currency is reached. Other trade options are the same than for a simple trade.coincenter starts by evaluating the shortest conversion path to reachCCC fromAAA and then applies the single trades in the correct order to its final goal.

In order to activate multi trades, there are two ways:

• Default behavior is controlled bymultiTradeAllowedByDefault option in theexchangeconfig.json file. Iftrue, multi trade is allowed for the given exchange (or all exchanges if underdefault level).
• It can be forced by adding command line flag--multi-trade.

In the case it's activated in the config file,--no-multi-trade can force deactivation of the multi trade.

Some exchanges (Kraken andBinance for instance) allow to actually query their REST API in simulation mode to validate the query and not perform the trade. It is possible to do this with--sim option. For exchanges which do not support this validation mode,coincenter will simply directly finish the trade entirely (taking fees into account) ignoring the trade strategy.

Trade family of commands require that you specify thestart amount (with the start currency) and thetarget currency. You can usebuy andsell commands when you have a start amount (forsell) or a target amount (forbuy) only. It's more easy to use, butcoincenter needs to know which are thepreferred currencies to which it cansell the start amount to, or use as start amount for abuy.

Sell option also supports percentage as start amount. In this case, the desired percentage of total available amount of given currency on matching exchanges (the ones specified after the, or all if none given as usual) will be sold. To complement this,sell-all option with a start currency instead of an amount is supported as well, which is syntactic sugar of a sell of100% of available amount.

Buy a percentage is not available yet, simply because I am not sure about what should be the behavior of this option. If you have ideas about it, do not hesitate to propose them.

The list of preferred currencies should be filled prior tobuy / sell command and is statically loaded at start of coincenter. It is an array of currencies ordered by decreasing priority, and they represent the currencies that can be used as target currency for asell, and base currency for abuy. Seeconfig file to see how to set the preferred currencies.

A sell has two input flavors, whereas a buy only one.

This is the most common buy/sell input. You will need to provide, in order:

• decimal, positive amount, absolute (for buy and sell, default) or relative for a sell (percentage suffixed with%, incompatible with buy)
• currency linked to this amount
• optional list of exchanges where to perform the trade (if several accounts are matched, the amount will be split among them, with a designated strategy)

Buy 500 SOL, considering all my accounts on Binance and Bithumb.

coincenter buy 500SOL,binance,bithumb

Sell 25 % of all my available ETH on all accounts

coincenter sell 25%ETH

This second flavor can be useful for piped commands, forsell only.You do not need to provide any information to thesell command. The amount and considered exchanges will be deduced from the output of the previous command.

Examples:

You withdraw a certain amount of XRP from exchange upbit to bithumb. You want to sell the received amount of XRP on bithumb:

coincenter withdraw-apply 500XRP,upbit-bithumb sell

Note that trades themselves can be piped, as the output has an amount and list of exchanges.

Following example would be foolish, but possible by coincenter.

Buy 1 ETH on any exchange then sell it:

coincenter buy 1ETH sell

Important note: as fortrade, the piped command will be possible only if the previous command iscomplete.

• All currencies present in thepreferred currencies of a given exchange may be used to validate and perform trades. For instance, if you decide to include non stable cryptos (for instance,BTC as it is often involves in many pairs), it can be used as a base for abuy, or target for asell. Thus as a recommendation, if you do add such currencies aspreferred, prefer placing them after the fiats and stable coins.
• Several trades may be performed on the same account for abuy. For instance: you have bothEUR andUSDT and they are both present in thepreferred currencies, and the desired amount of target currency is high enough such that it wouldeat all of yourEUR orUSDT.
• Similarly totrade options,coincenter tries to minimize the number of actual trades to achieve the desired goal. So it will favor exchanges and currencies with the largest available amount.
• For thebuy, trade fees are taken into account to attempt to reach exactly the desirednet amount.

coincenter sell 1 BTC,exchange1,exchange3_user1

Sell1 BTC on all accounts onexchange1 andexchange3_user1 to any preferred currencies

A total of0.9 BTC will be sold, toUSDT onexchange1 and toKRW onexchange3.

coincenter buy 2.5ETH

Buy2 ETH on all accounts which has some available amount in preferred currencies.Let's consider following prices, without any trade fees (coincenter takes trade fees into account forbuy):

• 1 ETH = 1000 EUR
• 1 ETH = 1200 USDT
• 1 ETH = 1000000 KRW

A total of2 ETH will be bought, from600 USDT onexchange1_user2,800 EUR and240 USDT fromexchange3_user1 and500000 KRW fromexchange4_user1. As you can see in this example, it's possible to make several trades per account for onebuy request.

You can retrieve one deposit address and tag from your accounts on a given currency provided that the exchange can receive it withdeposit-info option. It requires a currency code, and an optional list of exchanges (private or public names, seeSelecting private keys on exchanges). If no exchanges are given, program will query all accounts and retrieve the possible ones.

If for a given exchange account a deposit address is not created yet,coincenter will create one automatically.

Only one deposit address per currency / account is returned.

Important note: only addresses which are validated against thedepositaddresses.json file will be returned (unless optionvalidateDepositAddressesInFile is set tofalse instatic/exchangeconfig.json file). This file allows you to control addresses to whichcoincenter can send funds, even if you have more deposit addresses already configured.

To retrieve the most recent deposits, use thedeposits option. Currency is optional - if not provided, deposits in all currencies will be returned.

Some exchanges do not provide a method to retrieve recent deposits for more than one currency (Kraken and Bithumb for instance).If you request all currencies on these exchanges,coincenter will not query deposits for all existing currencies, but only for the currencies present in your balance to decrease the number of queries. Still, it's an heuristic so it may of course miss other deposits.

By default, it returns all deposits on given currency, or any currency. You can filter the deposits with options:

• --max-age <time> to set a maximum age for the deposits to retrieve
• --min-age <time> to set a minimum age for the deposits to retrieve
• --id <id1,id2,...> to retrieve only deposits with given IDs

coincenter deposits kraken --max-age 2w: retrieves all deposits of the last two weeks

coincenter deposits eth --id myid1,myid2: retrieves all deposits of Ethereum, if they have either idmyid1 ormyid2

Similarly to deposits, you can query the recentwithdraws with commandwithdraws. It works the same ways as deposits - you just need to replacedeposits withwithdraws in the option name (for instance,--max-age specifies the maximum age for the withdraws to retrieve).

Retrieve all recent withdraws from all accounts:

coincenter withdraws

Retrieve the withdraw of XRP on Upbit with idmyid3

coincenter withdraws upbit,xrp --id myid3

Use optionorders-closed to retrieve and print closed orders on your accounts. A closed order is an old order that has no remaining unmatched amount. You can provide only one currency code, two currency codes separated with a-, and / or a list of exchanges on which to filter the orders. It is possible to not specify anything as well, in this case, all closed orders will be returned, if the exchange provides a way to retrieve them all. In particular, a specific process is made for the following exchanges:

• OnBinance, market is mandatory and iforders-closed query is made without the market,coincenter will log an error and return an empty result.
• OnBithumb, at least one currency code is needed. If only one currency code is given,coincenter will perform a closed orders query for all currencies that have a non-zero balance on the account.

Orders can be filtered according to placed time with options--min-age and--max-age specifying respectively the minimum and maximum age of the orders.

Finally, they can also be filtered by their ID, thanks to--id option. Give a list of comma separated string Ids.

Examples:

coincenter orders-closed --min-age 10min# Retrieve all closed orders placed within the last 10 minutescoincenter orders-closed kraken# Retrieve all closed orders on Kraken onlycoincenter orders-closed eth --max-age 1w# Retrieve all closed orders of at most 1 week old, on markets involving Ethereum on all exchangescoincenter orders-closed xlm-usdt# Retrieve all closed orders matching markets USDT-XLM or XLM-USDTcoincenter orders-closed btc-krw,upbit,bithumb# Retrieve all closed orders on BTC-KRW / KRW-BTC on Bithumb and Upbitcoincenter orders-closed binance_joe --id OID1,OID2# Check if 'OID1' and 'OID2' are still closed on 'joe' account on Binance

Use optionorders-opened to retrieve and print currently opened orders on your accounts. An opened order is an order that has some remaining unmatched amount.The option syntax is the same as aboveclosed orders.

Opened orders can be cancelled withorders-cancel option, with the same filter arguments as opened orders option above.Beware, no filtering options matches all opened orders, so this command:

coincenter orders-cancel

will cancel all opened orders on all available exchanges. You can first check the current open orders and order cancellations by ID:

coincenter orders-cancel --id OID1

cancels order Id OID1 only, on the exchange where it is found on (no error is raised if no such opened order has this ID).

It is possible to withdraw crypto currency withcoincenter as well, in either asynchronized mode (withdraw will check that funds are well received at destination) orasynchronous mode, with commandwithdraw-apply.Either an absolute amount can be specified, or a percentage (10xrp or25%xrp for instance).withdraw-apply-all is a convenient command wrapper ofwithdraw-apply 100%.

Some exchanges require that external addresses are validated prior to their usage in the API (Kraken andHuobi for instance).

To ensure maximum safety, there are two checks performed bycoincenter prior to all withdraw launches:

• External address is not taken as an input parameter, but instead dynamically retrieved from the REST APIgetDepositAddress of the destination exchange (seeDeposit information)
• By default (can be configured instatic/exchangeconfig.json with boolean valuevalidateDepositAddressesInFile) deposit address is validated in<DataDir>/secret/depositaddresses.json which serves as aportfolio of trusted addresses

Example: Withdraw 10000 XLM (Stellar) from Bithumb to Huobi:

coincenter withdraw-apply 10000xlm,bithumb-huobi

You can customize the withdraw refresh time of the periodic checks during the continuous checking of withdraw status and receive at destination insynchronous mode.For that, specify a different time period with--refresh-time that expects a string representation of a time.

Defaults to 5 seconds.

By defaultcoincenter will exit withdraw process only once destination has received the funds.You can change the behavior to anasynchronous mode thanks to--async option, which is like a fire and forget mode. Once the withdraw is initiated, withdraw process is finished and the withdraw is not followed anymore.

Like trade, it is possible to launch a simulated withdrawal with--sim option (to test deposit information retrieval and withdrawal status of currency at source exchange for instance).

Example: Simulated withdrawal of 50 % of available BTC from accountuser1 of Kraken to Upbit:

coincenter withdraw-apply 50%btc,kraken_user1-upbit --sim

If you are annoyed with this kind of balance:

| BTG| 0.0000442|| DASH| 0.00002264|| DOT| 0.00009634|

and you would like to "clean" these small amounts to zero, thendust sweeper is the option to use!

When user defines a threshold amount on a given currency,dust-sweeper can be used to attempt to sell all amount (if below this threshold) trying to reach exactly 0 amount on this currency for a clean balance.The algorithm used bycoincenter is a simple heuristic:

• it finds the best markets involving currency to be sold
• it tries to sell all immediately.
• if full selling is not possible, it buys a small amount of this currency
• retry until either maximum number of steps (configurable) is reached or balance is exactly 0 on given currency

Example: Attempts to clean amount of BTG on bithumb and upbit

coincenter dust-sweeper btg,bithumb,upbit

Withdrawal input parameters can be provided in two flavors.

This is the most common withdraw. You will need to provide, in order:

• decimal, positive amount, absolute (default) or relative (percentage suffixed with%)
• currency linked to this amount
• Exactly two exchange accounts separated by a dash '-'

This second flavor can be useful for piped commands.If the previous command output implies only one exchange, then it will be considered the origin exchange for the withdraw.The amount to be withdrawn is also taken from the output of previous command.You will need to specify exactly one exchange which will be the destination of the withdrawal.

Examples:

You trade an amount of KRW on upbit into ADA, and the obtained ADA amount will be withdrawn to kraken:

coincenter trade 80%KRW-ADA,upbit withdraw-apply kraken

Important note: as fortrade, the piped withdraw will be possible only if the previous trade iscomplete.

coincenter can export metrics to an external instance ofPrometheus thanks to its implementation ofprometheus-cpp client. Refer toBuild with monitoring support section to know how to buildcoincenter with it.

Currently, its support is experimental and in development for all major options ofcoincenter (private and market data requests).The metrics are exported inpush mode to the gateway at each new query. You can configure the IP address, port, username and password (if any) thanks to command line options (refer to the help to see their names).

Be aware of the following limitations ofcoincenter:

• When several networks exist for a given currency, only themain one is considered.This is to ensure safety between withdrawals performed between exchanges.
• Only absolute withdraw fees are currently supported.In some cases (seen in Huobi), withdraw fee can be a percentage. They will be considered as 0.
• Not really a limitation ofcoincenter itself, but somesensitive actions are not possible by the exchanges API.For instance, withdrawal for Kraken is only possible for a stored destination made from the website first.

And probably more that I did not thought of, or never encountered. Feel free to open an issue and I will check it out if it's feasible!

coincenter balance krw

coincenter trade"1000eur-xrp,kraken" --strategy maker --timeout 60s

coincenter trade"1000eur-xrp,kraken" --strategy maker --timeout 1min --sim

Possible output

+----------+-----------+----------+---------------------------+-------------------------+-----------+| Exchange| Account| From| Traded from amount (real)| Traded to amount (real)| Status|+----------+-----------+----------+---------------------------+-------------------------+-----------+| kraken| testuser1| 1000 EUR| 999.99999999954052 EUR| 1221.7681748109101 XRP| Partial|+----------+-----------+----------+---------------------------+-------------------------+-----------+

How to change Yearn Finance to Bitcoin on all exchanges

coincenter conversion yfi-btc

Possible output

--------------------------------------------------| Exchange| Fastest conversion pathfor YFI-BTC|--------------------------------------------------| binance| YFI-BTC|| bithumb| YFI-KRW,BTC-KRW|| huobi| YFI-BTC|| kraken| YFI-BTC|| kucoin| YFI-USDT,BTC-USDT|--------------------------------------------------

coincenter markets xlm

Possible output

-------------------------------| Exchange| Markets with XLM|-------------------------------| binance| XLM-BNB|| binance| XLM-BTC|| binance| XLM-BUSD|| binance| XLM-ETH|| binance| XLM-EUR|| binance| XLM-TRY|| binance| XLM-USDT|| bithumb| XLM-KRW|| huobi| XLM-BTC|| huobi| XLM-ETH|| huobi| XLM-HUSD|| huobi| XLM-USDT|| kraken| XLM-BTC|| kraken| XLM-EUR|| upbit| XLM-BTC|| upbit| XLM-KRW|-------------------------------

coincenter orderbook eth-krw,bithumb,upbit --cur eur --depth 5

Possible output

--------------------------------------------------------------------------------------| Sellers of ETH (asks)| ETH pricein KRW| ETH pricein EUR| Buyers of ETH (bids)|--------------------------------------------------------------------------------------| 0.2673| 3196000| 2323.492||| 9.7201| 3195000| 2322.765||| 0.067| 3194000| 2322.038||| 12.3853| 3193000| 2321.311||| 7.36| 3191000| 2319.857|||| 3189000| 2318.403| 0.015||| 3188000| 2317.676| 2.0048||| 3187000| 2316.949| 0.0628||| 3186000| 2316.222| 9.9882||| 3185000| 2315.495| 0.17|--------------------------------------------------------------------------------------[2021-05-25 17:57:35.939] [info] Order book of ETH-KRW on upbit requested with conversion rate 0.000727 EUR--------------------------------------------------------------------------------------| Sellers of ETH (asks)| ETH pricein KRW| ETH pricein EUR| Buyers of ETH (bids)|--------------------------------------------------------------------------------------| 3.35718064| 3195000| 2322.765||| 10.07306967| 3194000| 2322.038||| 4.1710622| 3193000| 2321.311||| 22.5008735900000012| 3192000| 2320.584||| 17.31016963| 3191000| 2319.857|||| 3189000| 2318.403| 0.97522874||| 3188000| 2317.676| 6.58649442||| 3187000| 2316.949| 28.90471404||| 3186000| 2316.222| 5.72230368||| 3185000| 2315.495| 7.89530817|--------------------------------------------------------------------------------------

coincenter volume-day eth-usdt

Possible output:

----------------------------------------------| Exchange| Last 24h ETH-USDT traded volume|----------------------------------------------| binance| 647760.56051 ETH|| huobi| 375347.704456004546 ETH|| kraken| 1626.32378405 ETH|| upbit| 37.72550547 ETH|----------------------------------------------

coincenter price ada-btc

Possible output:

---------------------------------| Exchange| ADA-BTC last price|---------------------------------| binance| 0.00003951 BTC|| huobi| 0.00003952 BTC|| kraken| 0.00003955 BTC|| upbit| 0.00003984 BTC|---------------------------------

coincenter conversion 1000xlm-shib

Possible output:

+----------+------------------------------+| Exchange| 1000 XLM converted into SHIB|+----------+------------------------------+| binance| 6097126.83826878288 SHIB|| bithumb| 6113110.2941176275 SHIB|| huobi| 6083108.03661202044 SHIB|| kraken| 6088227.73071931392 SHIB|| kucoin| 6090943.32410022531 SHIB|| upbit| 6084383.631243834 SHIB|+----------+------------------------------+