diff --git a/.dockerignore b/.dockerignore deleted file mode 100644 index d07c51f7..00000000 --- a/.dockerignore +++ /dev/null @@ -1,14 +0,0 @@ -*.cmake -.cache -.vscode -.git -.clangformat -LICENSE -*.md -**/build*/ -**/*secret.json -data/log -data/secret -!data/secret/secret_test.json -monitoring -resources diff --git a/.github/workflows/clang-format-check.yml b/.github/workflows/clang-format-check.yml index 248e0cbf..08ba4e86 100644 --- a/.github/workflows/clang-format-check.yml +++ b/.github/workflows/clang-format-check.yml @@ -11,7 +11,7 @@ jobs: name: Formatting Check runs-on: ubuntu-latest steps: - - uses: actions/checkout@v2 + - uses: actions/checkout@v4 - name: Run clang-format style check for C/C++ programs. uses: jidicula/clang-format-action@v4.11.0 with: diff --git a/.github/workflows/codeql-analysis.yml b/.github/workflows/codeql-analysis.yml index 3a776379..00ed1702 100644 --- a/.github/workflows/codeql-analysis.yml +++ b/.github/workflows/codeql-analysis.yml @@ -39,11 +39,11 @@ jobs: steps: - name: Checkout repository - uses: actions/checkout@v2 + uses: actions/checkout@v4 # Initializes the CodeQL tools for scanning. - name: Initialize CodeQL - uses: github/codeql-action/init@v1 + uses: github/codeql-action/init@v3 with: languages: ${{ matrix.language }} # If you wish to specify custom queries, you can do so here or in a config file. @@ -53,7 +53,8 @@ jobs: - name: Install dependencies run: | - sudo apt update && sudo apt install libcurl4-gnutls-dev ninja-build ${{matrix.compiler}} + sudo apt update + sudo apt install libcurl4-gnutls-dev ninja-build ${{matrix.compiler}} --no-install-recommends - name: Create Build Environment run: cmake -E make_directory ${{github.workspace}}/build diff --git a/.github/workflows/docker-publish.yml b/.github/workflows/docker-publish.yml index ef24d229..0033eda8 100644 --- a/.github/workflows/docker-publish.yml +++ b/.github/workflows/docker-publish.yml @@ -12,7 +12,7 @@ jobs: steps: - name: Checkout - uses: actions/checkout@v2 + uses: actions/checkout@v4 - name: Set up Docker Buildx uses: docker/setup-buildx-action@v2 diff --git a/.github/workflows/docker.yml b/.github/workflows/docker.yml index 00d5a02a..8c446b2d 100644 --- a/.github/workflows/docker.yml +++ b/.github/workflows/docker.yml @@ -17,7 +17,7 @@ jobs: steps: - name: Checkout repository code - uses: actions/checkout@v2 + uses: actions/checkout@v4 - name: Docker build working-directory: ${{github.workspace}} diff --git a/.github/workflows/macos.yml b/.github/workflows/macos.yml index 6ffcd623..a0a56141 100644 --- a/.github/workflows/macos.yml +++ b/.github/workflows/macos.yml @@ -12,7 +12,7 @@ jobs: runs-on: macos-latest steps: - - uses: actions/checkout@v2 + - uses: actions/checkout@v4 - uses: maxim-lobanov/setup-xcode@v1 with: diff --git a/.github/workflows/ubuntu-clang-tidy.yml b/.github/workflows/ubuntu-clang-tidy.yml index 8222480d..76f52442 100644 --- a/.github/workflows/ubuntu-clang-tidy.yml +++ b/.github/workflows/ubuntu-clang-tidy.yml @@ -17,11 +17,12 @@ jobs: steps: - name: Checkout repository code - uses: actions/checkout@v2 + uses: actions/checkout@v4 - name: Install dependencies run: | - sudo apt update && sudo apt install libcurl4-gnutls-dev ninja-build + sudo apt update + sudo apt install libcurl4-gnutls-dev ninja-build - name: Install clang (with clang-tidy) run: | diff --git a/.github/workflows/ubuntu-monitoring.yml b/.github/workflows/ubuntu-monitoring.yml index a0dc9091..143578cd 100644 --- a/.github/workflows/ubuntu-monitoring.yml +++ b/.github/workflows/ubuntu-monitoring.yml @@ -18,7 +18,7 @@ jobs: steps: - name: Checkout repository code - uses: actions/checkout@v2 + uses: actions/checkout@v4 - name: Prerequisites run: | diff --git a/.github/workflows/ubuntu.yml b/.github/workflows/ubuntu.yml index d35c6534..bb945370 100644 --- a/.github/workflows/ubuntu.yml +++ b/.github/workflows/ubuntu.yml @@ -17,7 +17,7 @@ jobs: steps: - name: Checkout repository code - uses: actions/checkout@v2 + uses: actions/checkout@v4 - name: Install dependencies run: | diff --git a/.github/workflows/windows.yml b/.github/workflows/windows.yml index 17e3f653..38645c98 100644 --- a/.github/workflows/windows.yml +++ b/.github/workflows/windows.yml @@ -7,32 +7,27 @@ on: pull_request: jobs: - windows-build: + windows: name: Build on Windows runs-on: windows-latest strategy: matrix: - buildmode: [Debug, Release] + buildmode: [Debug] steps: - name: Checkout - uses: actions/checkout@v2 + uses: actions/checkout@v4 - name: Install dependencies - uses: crazy-max/ghaction-chocolatey@v1 - with: - args: install curl openssl - - - name: Add cURL directory in the path run: | - $curlPath = Get-ChildItem -Path C:\ProgramData\chocolatey\lib\curl\tools\curl* -Name - echo "C:\ProgramData\chocolatey\lib\curl\tools\${curlPath}\bin" | Out-File -FilePath $env:GITHUB_PATH -Encoding utf8 -Append - echo "C:\ProgramData\chocolatey\lib\curl\tools\${curlPath}\lib" | Out-File -FilePath $env:GITHUB_PATH -Encoding utf8 -Append + vcpkg install openssl curl - - name: Create Build Environment - run: cmake -E make_directory ${{github.workspace}}/build + - name: End vcpkg install + run: | + vcpkg integrate install - name: Configure CMake - run: cmake -S . -B build -DCMAKE_BUILD_TYPE=${{matrix.buildmode}} + run: | + cmake -DCMAKE_TOOLCHAIN_FILE="C:/vcpkg/scripts/buildsystems/vcpkg.cmake" -DCMAKE_BUILD_TYPE=${{matrix.buildmode}} -S . -B build - name: Build working-directory: ${{github.workspace}}/build diff --git a/.gitignore b/.gitignore index 8c01a78d..176b2be7 100644 --- a/.gitignore +++ b/.gitignore @@ -31,7 +31,6 @@ *.creator* *.files *.includes -*.cmake *.code-workspace *.orig *.tmp @@ -59,13 +58,12 @@ #==============================================================================# !.vscode/*.default -.ycm_extra_conf.py* -*-ut cscope* **/*secret.json data/cache data/log data/secret +!data/secret/secret_test.json data/static/exchangeconfig.json data/static/generalconfig.json monitoring/data/grafana/* diff --git a/CMakeLists.txt b/CMakeLists.txt index dc63a7a1..9560c218 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -48,11 +48,16 @@ endif() set(CMAKE_CXX_STANDARD 20) +# openssl for requests +find_package(OpenSSL REQUIRED) + +# curl - request library +find_package(CURL REQUIRED) + # External dependencies (linked with FetchContent) include(FetchContent) find_package(amc CONFIG) - if(amc_FOUND) set(LINK_AMC FALSE) else() @@ -83,7 +88,7 @@ if(CCT_ENABLE_TESTS) enable_testing() endif() -# nlohmann_json - coincenter json library +# nlohmann_json - json library find_package(nlohmann_json CONFIG) if(NOT nlohmann_json_FOUND) FetchContent_Declare( @@ -95,18 +100,7 @@ if(NOT nlohmann_json_FOUND) FetchContent_MakeAvailable(nlohmann_json) endif() -# spdlog - coincenter logging library -find_package(spdlog CONFIG) -if(NOT spdlog_FOUND) - FetchContent_Declare( - spdlog - GIT_REPOSITORY https://github.com/gabime/spdlog.git - GIT_TAG v1.13.0 - ) - - FetchContent_MakeAvailable(spdlog) -endif() - +# prometheus for monitoring support if(CCT_BUILD_PROMETHEUS_FROM_SRC) # Disable Prometheus testing set(ENABLE_TESTING OFF) @@ -135,92 +129,27 @@ else() endif() endif() -# Unit Tests - -#[[ Create an executable -Syntax: -add_exe( src1 [src2 ...] [LIBRARIES lib1 lib2 ...] [DEFINITIONS def1 def2]) -will compile an executable named from source files src1 src2... -with pre-processor definitions def1 def2 (-Ddef1 -Ddef2 ... will be added to compile command) -and link against lib1 lib2 ...and libm - -Examples: -add_exe(myexe src1.cpp) -add_exe(myexe src1.cpp - LIBRARIES ${CMAKE_SOURCE_DIR}/myLib - DEFINITIONS UNIT_TEST) -#]] -function(add_exe name) - set(cur_var "sources") - set(exe_sources "") - set(exe_libraries "") - set(exe_definitions "") - set(exe_include_dirs "") - - foreach(arg IN LISTS ARGN) - if(arg STREQUAL "LIBRARIES") - set(cur_var "libraries") - elseif(arg STREQUAL "DEFINITIONS") - set(cur_var "definitions") - else() - list(APPEND exe_${cur_var} ${arg}) - - if(cur_var STREQUAL "sources") - get_filename_component(src_dir ${arg} DIRECTORY) - list(APPEND exe_include_dirs ${src_dir}) - endif() - endif() - endforeach() - - add_executable(${name} ${exe_sources}) - set_target_properties(${name} PROPERTIES - COMPILE_DEFINITIONS "${exe_definitions}" - BUILD_RPATH "${runtime_path}") - target_link_libraries(${name} PRIVATE ${exe_libraries}) - list(REMOVE_DUPLICATES exe_include_dirs) - target_include_directories(${name} PRIVATE ${exe_include_dirs} ${all_includes}) -endfunction() - -#[[ Create a unit test -Syntax: -add_unit_test( src1 [src2 ...] [LIBRARIES lib1 lib2 ...] [DEFINITIONS def1 def2]) -will compile an unit test named from source files src1 src2... -with pre-processor definitions def1 def2 (-Ddef1 -Ddef2 ... will be added to compile command) -and link against lib1 lib2 ... and libm - -Examples: -add_unit_test(myexe src1.cpp) -add_unit_test(myexe src1.cpp DEFINITIONS UNIT_TEST) -#]] -function(add_unit_test name) - set(oneValueArgs) - set(multiValueArgs) - cmake_parse_arguments(PARSE_ARGV 1 MY "${options}" "${oneValueArgs}" "${multiValueArgs}") - - if(CCT_ENABLE_TESTS) - add_exe(${name} ${MY_UNPARSED_ARGUMENTS}) - target_link_libraries(${name} PRIVATE GTest::gtest GTest::gmock GTest::gmock_main) - - if(LINK_AMC) - target_link_libraries(${name} PRIVATE amc::amc) - endif() +# spdlog - logging library +find_package(spdlog CONFIG) +if(NOT spdlog_FOUND) + FetchContent_Declare( + spdlog + GIT_REPOSITORY https://github.com/gabime/spdlog.git + GIT_TAG v1.13.0 + ) - target_include_directories(${name} PRIVATE include) - target_include_directories(${name} PRIVATE ${CMAKE_SOURCE_DIR}/src/http-request/include) + FetchContent_MakeAvailable(spdlog) +endif() - add_test(NAME ${name} COMMAND ${name}) - set_tests_properties(${name} PROPERTIES - ENVIRONMENT "UBSAN_OPTIONS=halt_on_error=1 abort_on_error=1 print_stacktrace=1;\ - LSAN_OPTIONS=detect_leaks=1 malloc_context_size=2 print_suppressions=0" - WORKING_DIRECTORY ${CMAKE_HOME_DIRECTORY}) - endif() -endfunction() +# Unit Tests +include(cmake/AddUnitTest.cmake) if(MSVC) - add_compile_options(/W4) + add_compile_options(/W3) # https://stackoverflow.com/questions/5004858/why-is-stdmin-failing-when-windows-h-is-included add_compile_definitions(NOMINMAX) + add_compile_definitions(_SILENCE_STDEXT_ARR_ITERS_DEPRECATION_WARNING) else() add_compile_options(-Wall -Wextra -pedantic) diff --git a/Dockerfile b/Dockerfile index 73202ad0..b0959dd8 100644 --- a/Dockerfile +++ b/Dockerfile @@ -4,16 +4,25 @@ FROM ubuntu:22.04 AS build # Install base & build dependencies, needed certificates for curl to work with https RUN apt update && \ apt upgrade -y && \ - apt install build-essential curl libcurl4-gnutls-dev libssl-dev cmake git ca-certificates gzip -y && \ - curl -L -o /usr/local/bin/ninja.gz https://github.com/ninja-build/ninja/releases/latest/download/ninja-linux.zip && \ - gunzip /usr/local/bin/ninja.gz && \ - chmod a+x /usr/local/bin/ninja + apt install build-essential ninja-build libcurl4-gnutls-dev libssl-dev cmake git ca-certificates gzip -y --no-install-recommends + +# Copy source files +WORKDIR /app/src +COPY src . -# Set default directory for application WORKDIR /app +COPY CMakeLists.txt *.md ./ + +WORKDIR /app/cmake +COPY cmake . + +# Copy only the test secrets +WORKDIR /app/data/secret +COPY data/secret/secret_test.json . -# Copy all files, excluding the ones in '.dockerignore' -COPY . . +# Copy mandatory static configuration files +WORKDIR /app/data/static +COPY data/static/currency_prefix_translator.json data/static/currencyacronymtranslator.json data/static/stablecoins.json data/static/withdrawfees.json ./ # Create and go to 'bin' directory WORKDIR /app/bin diff --git a/INSTALL.md b/INSTALL.md index 6da9d94a..5fdcb563 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -17,8 +17,8 @@ - [As a static library](#as-a-static-library) - [Build with monitoring support](#build-with-monitoring-support) - [With Docker](#with-docker) - - [Build](#build-1) - - [Run](#run) + - [Docker Build](#docker-build) + - [Docker Run](#docker-run) - [Tests](#tests)

@@ -28,7 +28,7 @@ If you don't want to build `coincenter` locally, you can just download the public docker image, corresponding to the latest version of branch `main`. -``` +```bash docker run -t sjanel/coincenter -h ``` @@ -36,7 +36,7 @@ Docker image does not contain additional `data` directory needed by `coincenter` To bind your 'data' directory from host to the docker container, you can use `--mount` option: -``` +```bash docker run --mount type=bind,source=,target=/app/data sjanel/coincenter ``` @@ -52,7 +52,7 @@ The following compilers are known to compile `coincenter` (and are tested in the - **GCC** version >= 11 - **Clang** version >= 17 -- **MSVC** version >= 19.30 +- **MSVC** version >= 19.39 Other compilers have not been tested. @@ -70,8 +70,8 @@ In addition, the basic minimum requirements are: Provided that your distribution is sufficiently recent, meta package `build-essential` should provide `gcc` with the correct version. Otherwise you can still force it: -``` -sudo apt update && sudo apt install libcurl4-gnutls-dev libssl-dev cmake g++-11 +```bash +sudo apt update && sudo apt install build-essential ninja-build libcurl4-gnutls-dev libssl-dev cmake git ca-certificates gzip ``` You can refer to the provided [Dockerfile](Dockerfile) for more information. @@ -80,21 +80,28 @@ You can refer to the provided [Dockerfile](Dockerfile) for more information. With `ninja` generator for instance: -``` -sudo apk update && sudo apk upgrade && sudo apk add g++ libc-dev curl-dev cmake ninja git linux-headers +```bash +sudo apk add --update --upgrade g++ libc-dev openssl-dev curl-dev cmake ninja git ca-certificates ``` You can refer to the provided [Dockerfile](alpine.Dockerfile) for more information. ### Windows -On Windows, the easiest method is to use [chocolatey](https://chocolatey.org/install) to install **curl** and **OpenSSL**: +On Windows, the easiest method is to use [vcpkg](https://chocolatey.org/install) as package manager to install **curl** and **OpenSSL**: +```bash +vcpkg install openssl curl +vcpkg integrate install ``` -choco install curl openssl + +From this step, **curl** and **OpenSSL** can be found by `cmake` with `find_package` by giving the toolchain file of `vcpkg` at configure time: + +```bash +cmake -DCMAKE_TOOLCHAIN_FILE="/scripts/buildsystems/vcpkg.cmake" ... ``` -Then, locate where curl is installed (by default, should be in `C:\ProgramData\chocolatey\lib\curl\tools\curl-xxx`, let's note this `CURL_DIR`) and add both `CURL_DIR/lib` and `CURL_DIR/bin` in your `PATH`. From this step, **curl** and **OpenSSL** can be found by `cmake` and will be linked statically to the executables. +You can refer to the [Windows workflow](.github/workflows/windows.yml) and the [vcpkg install page](https://vcpkg.io/en/getting-started?platform=windows) for more information. ## Build @@ -117,7 +124,7 @@ If you are building frequently `coincenter` you can install them to speed up its This project can be easily built with [cmake](https://cmake.org/). -The minimum tested version is cmake `3.15`. +The minimum tested version is cmake `3.15`, but it's recommended that you use the latest available one. #### cmake build options @@ -130,7 +137,7 @@ The minimum tested version is cmake `3.15`. Example on Linux: to compile it in `Release` mode and `ninja` generator -``` +```bash mkdir -p build && cd build && cmake -GNinja -DCMAKE_BUILD_TYPE=Release .. && ninja ``` @@ -142,7 +149,7 @@ On Windows, you can use your preferred IDE to build `coincenter` (**Visual Studi To build your `cmake` project with **coincenter** library, you can do it with `FetchContent`: -``` +```cmake include(FetchContent) FetchContent_Declare( @@ -156,7 +163,7 @@ FetchContent_MakeAvailable(coincenter) Then, a static library named `coincenter` is defined and you can link it as usual: -``` +```cmake target_link_libraries( PRIVATE coincenter) ``` @@ -189,15 +196,15 @@ Activate Address Sanitizer Compile with [prometheus-cpp](https://github.com/jupp0r/prometheus-cpp) to support metric export to Prometheus `BUILD_WITH_PROMETHEUS` (default: 1) -#### Build +#### Docker Build -``` +```bash docker build --build-arg BUILD_MODE=Release -t local-coincenter . ``` -#### Run +#### Docker Run -``` +```bash docker run -ti -e "TERM=xterm-256color" local-coincenter --help ``` diff --git a/README.md b/README.md index 64cda8ad..7cfea41b 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,4 @@ -coincenter -========== +# coincenter [![docker](https://github.com/sjanel/coincenter/actions/workflows/docker.yml/badge.svg?branch=main)](https://github.com/sjanel/coincenter/actions/workflows/docker.yml) [![macos](https://github.com/sjanel/coincenter/actions/workflows/macos.yml/badge.svg?branch=main)](https://github.com/sjanel/coincenter/actions/workflows/macos.yml) @@ -15,7 +14,7 @@ Command Line Interface (CLI) / library centralizing several crypto currencies ex Main features: -**Market Data** +## Market Data - Currencies - Markets @@ -26,7 +25,7 @@ Main features: - Last trades - Withdraw fees -**Private requests** +## Private requests - Balance - Trade (buy & sell in several flavors) @@ -38,7 +37,8 @@ Main features: - Withdraw (with check at destination that funds are well received) - Dust sweeper -**Supported exchanges** +## Supported exchanges + | Exchange | Link | | -------- | :-----------------------------------------------------------------------------: | | Binance | [](https://www.binance.com/) | @@ -52,89 +52,90 @@ Main features:

- [coincenter](#coincenter) -- [About](#about) -- [Installation](#installation) -- [Configuration](#configuration) -- [Usage](#usage) - - [Input / output](#input--output) - - [Format](#format) - - [Simple usage](#simple-usage) - - [Multiple commands](#multiple-commands) - - [Piping commands](#piping-commands) - - [Logging](#logging) - - [Activity history](#activity-history) - - [Parallel requests](#parallel-requests) - - [Public requests](#public-requests) - - [Health check](#health-check) - - [Currencies](#currencies) - - [Examples](#examples) - - [Markets](#markets) - - [Examples](#examples-1) - - [Ticker information](#ticker-information) - - [Order books](#order-books) - - [Last 24h traded volume](#last-24h-traded-volume) - - [Last price](#last-price) - - [Last trades](#last-trades) - - [Conversion path](#conversion-path) - - [Withdraw fees](#withdraw-fees) - - [Example 1: query all withdraw fees](#example-1-query-all-withdraw-fees) - - [Example 2: query ETH withdraw fees on Kraken and Kucoin](#example-2-query-eth-withdraw-fees-on-kraken-and-kucoin) + - [Market Data](#market-data) - [Private requests](#private-requests) - - [Selecting private keys on exchanges](#selecting-private-keys-on-exchanges) - - [Balance](#balance) - - [Trade](#trade) - - [Syntax](#syntax) - - [Standard - full information](#standard---full-information) - - [With information from previous 'piped' command](#with-information-from-previous-piped-command) - - [Options](#options) - - [Trade timeout](#trade-timeout) - - [Trade asynchronous mode](#trade-asynchronous-mode) - - [Trade Price Strategy](#trade-price-strategy) - - [Trade Price Picker](#trade-price-picker) - - [Absolute price](#absolute-price) - - [Relative price](#relative-price) - - [Trade all](#trade-all) - - [Examples with explanation](#examples-with-explanation) - - [Multi Trade](#multi-trade) - - [Trade simulation](#trade-simulation) - - [Buy / Sell](#buy--sell) - - [Syntax](#syntax-1) - - [Standard - full information](#standard---full-information-1) - - [Sell - with information from previous 'piped' command](#sell---with-information-from-previous-piped-command) - - [Behavior](#behavior) - - [Examples with explanation](#examples-with-explanation-1) - - [Deposit information](#deposit-information) - - [Recent deposits](#recent-deposits) - - [Examples](#examples-2) - - [Recent withdraws](#recent-withdraws) - - [Examples](#examples-3) - - [Opened orders](#opened-orders) - - [Cancel opened orders](#cancel-opened-orders) - - [Withdraw coin](#withdraw-coin) - - [Withdraw options](#withdraw-options) - - [Withdraw refresh time](#withdraw-refresh-time) - - [Withdraw asynchronous mode](#withdraw-asynchronous-mode) - - [Dust sweeper](#dust-sweeper) - - [Syntax](#syntax-2) - - [Standard - full information](#standard---full-information-2) - - [Sell - with information from previous 'piped' command](#sell---with-information-from-previous-piped-command-1) - - [Monitoring options](#monitoring-options) - - [Repeat](#repeat) - - [Limitations](#limitations) - - [Examples of use cases](#examples-of-use-cases) - - [Get an overview of your portfolio in Korean Won](#get-an-overview-of-your-portfolio-in-korean-won) - - [Trade 1000 euros to XRP on kraken with a maker strategy](#trade-1000-euros-to-xrp-on-kraken-with-a-maker-strategy) - - [Trade 1000 euros to XRP on kraken with a maker strategy in simulation mode](#trade-1000-euros-to-xrp-on-kraken-with-a-maker-strategy-in-simulation-mode) - - [Prints conversion paths](#prints-conversion-paths) - - [Prints all markets trading Stellar (XLM)](#prints-all-markets-trading-stellar-xlm) - - [Prints bithumb and upbit orderbook of depth 5 of Ethereum and adds a column conversion in euros](#prints-bithumb-and-upbit-orderbook-of-depth-5-of-ethereum-and-adds-a-column-conversion-in-euros) - - [Prints last 24h traded volume for all exchanges supporting ETH-USDT market](#prints-last-24h-traded-volume-for-all-exchanges-supporting-eth-usdt-market) - - [Prints last price of Cardano in Bitcoin for all exchanges supporting it](#prints-last-price-of-cardano-in-bitcoin-for-all-exchanges-supporting-it) + - [Supported exchanges](#supported-exchanges) + - [About](#about) + - [Installation](#installation) + - [Configuration](#configuration) + - [Usage](#usage) + - [Input / output](#input--output) + - [Format](#format) + - [Simple usage](#simple-usage) + - [Multiple commands](#multiple-commands) + - [Piping commands](#piping-commands) + - [Logging](#logging) + - [Activity history](#activity-history) + - [Parallel requests](#parallel-requests) + - [Public requests](#public-requests) + - [Health check](#health-check) + - [Currencies](#currencies) + - [Examples](#examples) + - [Markets](#markets) + - [Examples](#examples-1) + - [Ticker information](#ticker-information) + - [Order books](#order-books) + - [Last 24h traded volume](#last-24h-traded-volume) + - [Last price](#last-price) + - [Last trades](#last-trades) + - [Conversion path](#conversion-path) + - [Withdraw fees](#withdraw-fees) + - [Example 1: query all withdraw fees](#example-1-query-all-withdraw-fees) + - [Example 2: query ETH withdraw fees on Kraken and Kucoin](#example-2-query-eth-withdraw-fees-on-kraken-and-kucoin) + - [Private requests](#private-requests-1) + - [Selecting private keys on exchanges](#selecting-private-keys-on-exchanges) + - [Balance](#balance) + - [Trade](#trade) + - [Syntax](#syntax) + - [Standard - full information](#standard---full-information) + - [With information from previous 'piped' command](#with-information-from-previous-piped-command) + - [Options](#options) + - [Trade timeout](#trade-timeout) + - [Trade asynchronous mode](#trade-asynchronous-mode) + - [Trade Price Strategy](#trade-price-strategy) + - [Trade Price Picker](#trade-price-picker) + - [Trade all](#trade-all) + - [Examples with explanation](#examples-with-explanation) + - [Multi Trade](#multi-trade) + - [Trade simulation](#trade-simulation) + - [Buy / Sell](#buy--sell) + - [Syntax](#syntax-1) + - [Standard - full information](#standard---full-information-1) + - [Sell - with information from previous 'piped' command](#sell---with-information-from-previous-piped-command) + - [Behavior](#behavior) + - [Examples with explanation](#examples-with-explanation-1) + - [Deposit information](#deposit-information) + - [Recent deposits](#recent-deposits) + - [Examples](#examples-2) + - [Recent withdraws](#recent-withdraws) + - [Examples](#examples-3) + - [Opened orders](#opened-orders) + - [Cancel opened orders](#cancel-opened-orders) + - [Withdraw coin](#withdraw-coin) + - [Withdraw options](#withdraw-options) + - [Withdraw refresh time](#withdraw-refresh-time) + - [Withdraw asynchronous mode](#withdraw-asynchronous-mode) + - [Dust sweeper](#dust-sweeper) + - [Syntax](#syntax-2) + - [Standard - full information](#standard---full-information-2) + - [Sell - with information from previous 'piped' command](#sell---with-information-from-previous-piped-command-1) + - [Monitoring options](#monitoring-options) + - [Repeat](#repeat) + - [Limitations](#limitations) + - [Examples of use cases](#examples-of-use-cases) + - [Get an overview of your portfolio in Korean Won](#get-an-overview-of-your-portfolio-in-korean-won) + - [Trade 1000 euros to XRP on kraken with a maker strategy](#trade-1000-euros-to-xrp-on-kraken-with-a-maker-strategy) + - [Trade 1000 euros to XRP on kraken with a maker strategy in simulation mode](#trade-1000-euros-to-xrp-on-kraken-with-a-maker-strategy-in-simulation-mode) + - [Prints conversion paths](#prints-conversion-paths) + - [Prints all markets trading Stellar (XLM)](#prints-all-markets-trading-stellar-xlm) + - [Prints bithumb and upbit orderbook of depth 5 of Ethereum and adds a column conversion in euros](#prints-bithumb-and-upbit-orderbook-of-depth-5-of-ethereum-and-adds-a-column-conversion-in-euros) + - [Prints last 24h traded volume for all exchanges supporting ETH-USDT market](#prints-last-24h-traded-volume-for-all-exchanges-supporting-eth-usdt-market) + - [Prints last price of Cardano in Bitcoin for all exchanges supporting it](#prints-last-price-of-cardano-in-bitcoin-for-all-exchanges-supporting-it)

-# About +## About `coincenter` is not just another random implementation of some exchanges' REST API, it also provides a **higher 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, but `coincenter` can handle their query for all exchanges, by using screen scraping techniques of external resources when needed). @@ -144,21 +145,21 @@ Technically speaking, this project is for **C++ enthusiasts** providing an alter 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). -# Installation +## Installation See [INSTALL.md](INSTALL.md) -# Configuration +## Configuration See [CONFIG.md](CONFIG.md) -# Usage +## Usage -## Input / output +### Input / output -### Format +#### Format -#### Simple usage +##### Simple usage `coincenter` is a command line tool with ergonomic and easy to remember option schema. You will usually provide this kind of input: @@ -170,7 +171,7 @@ See [CONFIG.md](CONFIG.md) Example: -``` +```bash Ori curr. exchange1 | | coincenter trade 0.05BTC-USDT,kraken,huobi @@ -181,13 +182,13 @@ coincenter trade 0.05BTC-USDT,kraken,huobi By default, result of command is printed in a formatted table on standard output. You can also choose a *json* output format with option `-o json`. -#### Multiple commands +##### Multiple commands 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: -``` +```bash 1st command 2nd command options | / \ coincenter balance orderbook XRP-USDT,binance --cur EUR @@ -195,7 +196,7 @@ coincenter balance orderbook XRP-USDT,binance --cur EUR 2nd command ``` -#### Piping commands +##### Piping commands 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: @@ -216,7 +217,7 @@ coincenter buy 1500XLM,binance withdraw kraken sell 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. -### Logging +#### Logging `coincenter` uses [spdlog](https://github.com/gabime/spdlog) for logging. @@ -227,7 +228,7 @@ By default, it logs in the console with the 'info' level, and in 'debug' in rota For this, you can configure statically the default level for each in the [config file](CONFIG.md#options-description). It can be overridden on the command line, with options `--log ` and `--log-file `. -#### Activity history +##### Activity history It is also possible to store relevant commands results (in `data/log/activity_history_YYYY-MM.txt` files) to keep track of the most important commands of `coincenter`. Each time a command of type present in the user defined list in `log.activityTracking.commandTypes` from `generalconfig.json` file is finished, its result is appended in json format to the corresponding activity history file of the current year and month. @@ -238,25 +239,25 @@ By default, it stores all types of trades and withdraws results, but the list is **Important**: those files contain important information so `coincenter` does not clean them automatically. You can move the old activity history files if they take to much space after a while. -## Parallel requests +### Parallel requests You may want to query several exchanges for a command at the same time. In this case, it's possible to ask `coincenter` to launch requests in parallel when it's possible. By default, the number of requests in parallel is `1`. To increase it, change the value of the field `nbMaxParallelRequests` in `generalconfig.json` file (more information [here](CONFIG.md#options-description)). 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. -## Public requests +### Public requests -### Health check +#### Health check `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 +#### Currencies `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. -#### Examples +##### Examples List all currencies for all supported exchanges @@ -270,7 +271,7 @@ List all currencies for kucoin and upbit coincenter currencies kucoin,upbit ``` -### Markets +#### Markets Use the `markets` 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: @@ -283,7 +284,7 @@ Also, result can be narrowed to list of exchanges given after the optional curre **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 for `trade` option of `coincenter`) -#### Examples +##### Examples Lists all markets for all exchanges @@ -303,7 +304,7 @@ List exchanges where the pair AVAX-USDT is supported coincenter markets avax-usdt ``` -### Ticker information +#### Ticker information Retrieve ticker information for all markets of one, several or all exchanges with `ticker [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. @@ -314,7 +315,7 @@ Example: Print ticker information for kraken and huobi exchanges coincenter ticker kraken,huobi ``` -### Order books +#### Order books Check market order books of a currency pair with `orderbook` option. By default, chosen `depth` is `10`, can be configured with `--depth`. Similarly to `ticker` 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. @@ -327,7 +328,7 @@ Example: Print ADA (Cardano) - USDT market order book with a depth of 20 on Krak coincenter orderbook ada-usdt,kraken,binance --depth 20 ``` -### Last 24h traded volume +#### Last 24h traded volume Fast query last 24h traded volume with `volume-day` option on one market on one, several or all exchanges (as usual, see above options). @@ -337,7 +338,7 @@ Example: Print last 24h traded volume on market XLM-BTC for all exchanges suppor coincenter volume-day xlm-btc ``` -### Last price +#### Last price Fast query last traded price with `price` option on one market on one, several or all exchanges (as usual, see above options). @@ -347,7 +348,7 @@ Example: Print last price on market SOL-BTC for all exchanges supporting it coincenter price sol-btc ``` -### Last trades +#### Last trades Get a sorted list of last trades with `last-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`. @@ -358,7 +359,7 @@ Example: Print the last 15 trades on DOT-USDT on Binance and Huobi coincenter last-trades dot-usdt,binance,huobi --n 15 ``` -### Conversion path +#### Conversion path From a starting currency 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. @@ -374,31 +375,30 @@ coincenter conversion shib-sol **Note**: when several conversion paths of same length are possible, it will favor the ones not involving fiat currencies. -### Withdraw fees +#### Withdraw fees 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. -#### Example 1: query all withdraw fees +##### Example 1: query all withdraw fees ```bash coincenter withdraw-fees ``` -#### Example 2: query ETH withdraw fees on Kraken and Kucoin +##### Example 2: query ETH withdraw fees on Kraken and Kucoin ```bash coincenter withdraw-fees eth,kraken,kucoin ``` - -## Private requests +### Private requests These requests will require that you have your secret keys in `data/secret/secret.json` file, for each exchange used. You can check easily that it works correctly with the `balance` option. -### Selecting private keys on exchanges +#### Selecting private keys on exchanges `coincenter` supports several keys per exchange. Here are both ways to target exchange(s) for `coincenter`: @@ -408,7 +408,7 @@ You can check easily that it works correctly with the `balance` option. 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 (see [Single trade](#single-trade)). +- Trade and multi trade will share the amount to be trade across the matching exchanges, depending on the amount available on each (see [trade](#trade)). Example: @@ -430,12 +430,12 @@ Let's say you have `jack` and `joe` accounts (the name of the keys in `secret.js ``` When you need to specify one key, you can suffix `jack` or `joe` after the exchange name `kraken`: `kraken_joe`. - + | Command | Explanation | | ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | | `coincenter balance kraken` | Sum of balances of 'jack' and 'joe' accounts of kraken | | `coincenter balance kraken_jack` | Only balance of 'jack' account of kraken | -| `coincenter trade 1000usdt-sol,kraken` | `coincenter` will trade a total of 1000 USDT from 'jack' and/or 'joe' (see [Single trade](#single-trade)) | +| `coincenter trade 1000usdt-sol,kraken` | `coincenter` will trade a total of 1000 USDT from 'jack' and/or 'joe' (see [trade](#trade)) | | `coincenter trade 1000usdt-sol,kraken_joe` | Perform the trade on 'joe' account only | | | | `coincenter withdraw-apply 1btc,kraken-binance` | **Error**: `coincenter` does not know if it should choose 'jack' or 'joe' for withdraw | @@ -460,11 +460,11 @@ If you have only one key per exchange, suffixing with the name is not necessary | `coincenter trade 1000usdt-sol,binance` | **OK** as no ambiguity | | `coincenter trade 1000usdt-sol,binance_averell` | **OK** as well | -### Balance +#### Balance Check your available balance across supported exchanges at one glance! -``` +```bash coincenter balance ``` @@ -475,14 +475,14 @@ You can also specify a currency to which all assets will be converted (if possib 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 of *Euro*: -``` +```bash 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. -### Trade +#### Trade 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: @@ -504,11 +504,11 @@ Given start amount can be absolute, or relative with the `%` character. In the l 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. -#### Syntax +##### Syntax A trade has two input flavors. -##### Standard - full information +###### Standard - full information This is the most common trade input. You will need to provide, in order: @@ -518,11 +518,11 @@ This is the most common trade input. You will need to provide, in order: - 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) -``` +```bash coincenter trade 35.5%ETH-USDT,kucoin ``` -##### With information from previous 'piped' command +###### With information from previous 'piped' command This second flavor can be useful for piped commands. The unique trade input argument will be the *destination currency*. The amount and considered exchanges will be deduced from the output of the previous command. @@ -530,7 +530,7 @@ Example: You withdraw a certain amount of ETH from exchange kraken to kucoin. You want to trade the received amount on kucoin to USDT: -``` +```bash coincenter withdraw-apply 1.45ETH,kraken-kucoin trade USDT ``` @@ -540,16 +540,15 @@ Note that trades themselves can be piped, as the output has an amount and list o Trade 15 % of my all available BTC to USDT (whatever the exchanges), and trade all the resulted USDT to ETH: -``` +```bash coincenter trade 15%BTC-USDT trade ETH ``` **Important note**: the piped command will be possible only if the previous command is *complete*. 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. +##### Options -#### Options - -##### Trade timeout +###### Trade timeout A trade is **synchronous** by default with the created order of `coincenter` (it follows the lifetime of the order). The trade ends when one of the following events occur: @@ -563,7 +562,7 @@ Value can contain several units, but do not support decimal values. For instance Another example: `--timeout 3min30s504ms` -##### Trade asynchronous mode +###### Trade asynchronous mode 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 only **fire and forget** an order placement, you can use `--async` flag. @@ -574,7 +573,7 @@ Note that it's not equivalent of choosing a **zero** trade timeout (above option - 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 -##### Trade Price Strategy +###### Trade Price Strategy Possible order price strategies, configurable with `--price-strategy`: @@ -584,7 +583,7 @@ Possible order price strategies, configurable with `--price-strategy`: Use command line option `trade` to make a trade from a departure amount. -##### Trade Price Picker +###### Trade Price Picker 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 above **trade price strategy** option. `--price` expects either an integer (!= 0) representing a **relative** price compared to the limit price, or a monetary amount representing an **absolute** fixed price (decimal amount with the price currency). @@ -597,16 +596,16 @@ In fact, parser will recognize a relative price if the amount is without any dec | `34.6` | *absolute* price (engine will take the currency from the market of the trade) | | `25 XXX` | *absolute* price (engine will override the currency from the market of the trade and not consider `XXX`, no error will be raised) | -###### Absolute price +####### Absolute price 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 with [multi trade](#multi-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, and `coincenter` will simply launch a single trade. +- Such an order will not be compatible with [multi trade](#multi-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, and `coincenter` will simply launch a single trade. - Order price will not be continuously updated over time -###### Relative price +####### Relative price The **relative price** makes it possible to easily settle a price anywhere in the orderbook. The chosen price is **relative** 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. @@ -636,25 +635,25 @@ Here is a visual example, considering an order book of market A-B: Say you want to place a buy order of *A* with n *B* at relative price **3** for instance: -``` +```bash coincenter trade nB-A --price 3 ``` The chosen price will be `0.42`. -#### Trade all +##### Trade all Instead of providing a start amount to trade, specify a currency. So `trade-all XXX...` is equivalent to `trade 100%XXX`. Example: Trade all available EUR on all exchanges to BTC -``` +```bash coincenter trade-all EUR-BTC ``` -#### Examples with explanation +##### Examples with explanation -``` +```bash coincenter trade 1btc-usdt ``` @@ -667,7 +666,7 @@ Trade 1 BTC to USDT on all exchanges supporting BTC-USDT market and having some | exchange3_user1 | 0.6 BTC | **0.6 BTC** | | exchange4_user1 | 0 BTC | 0 BTC | -``` +```bash coincenter trade 66.6%xlm-btc,kraken,huobi ``` @@ -683,13 +682,13 @@ Among all available XLM amount on all accounts on Kraken and Huobi, launch trade There is a total of `600` 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. -``` +```bash 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 -``` +```bash coincenter trade-all doge-usdt,binance_user1,huobi --strategy taker ``` @@ -697,7 +696,7 @@ Trade all DOGE to USDT on Binance account with key name 'user1' and all Huobi ac 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). -### Multi Trade +#### Multi Trade If you want to trade coin *AAA* into *CCC* but exchange does not have a *AAA-CCC* market and have *AAA-BBB* and *BBB-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 reach *CCC* from *AAA* and then applies the single trades in the correct order to its final goal. @@ -708,11 +707,11 @@ In order to activate multi trades, there are two ways: In the case it's activated in the config file, `--no-multi-trade` can force deactivation of the multi trade. -#### Trade simulation +##### Trade simulation Some exchanges (**Kraken** and **Binance** 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. -### Buy / Sell +#### Buy / Sell Trade family of commands require that you specify the *start amount* (with the start currency) and the *target currency*. You can use `buy` and `sell` commands when you have a start amount (for *sell*) or a target amount (for *buy*) only. It's more easy to use, but `coincenter` needs to know which are the [preferred currencies](CONFIG.md#options-description) to which it can *sell* the start amount to, or use as start amount for a *buy*. @@ -722,11 +721,11 @@ Buy a percentage is not available yet, simply because I am not sure about what s The list of preferred currencies should be filled prior to **buy / 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 a *sell*, and base currency for a *buy*. See [config](CONFIG.md#options-description) file to see how to set the preferred currencies. -#### Syntax +##### Syntax A sell has two input flavors, whereas a buy only one. -##### Standard - full information +###### Standard - full information This is the most common buy/sell input. You will need to provide, in order: @@ -735,16 +734,18 @@ This is the most common buy/sell input. You will need to provide, in order: - 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. -``` + +```bash coincenter buy 500SOL,binance,bithumb ``` Sell 25 % of all my available ETH on all accounts -``` + +```bash coincenter sell 25%ETH ``` -##### Sell - with information from previous 'piped' command +###### Sell - with information from previous 'piped' command This second flavor can be useful for piped commands, for *sell* only. You do not need to provide any information to the `sell` command. The amount and considered exchanges will be deduced from the output of the previous command. @@ -753,7 +754,7 @@ Examples: You withdraw a certain amount of XRP from exchange upbit to bithumb. You want to sell the received amount of XRP on bithumb: -``` +```bash coincenter withdraw-apply 500XRP,upbit-bithumb sell ``` @@ -763,20 +764,20 @@ Following example would be foolish, but possible by coincenter. Buy 1 ETH on any exchange then sell it: -``` +```bash coincenter buy 1ETH sell ``` **Important note**: as for [trade](#with-information-from-previous-piped-command), the piped command will be possible only if the previous command is *complete*. -#### Behavior +##### Behavior - All currencies present in the **preferred 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 a *buy*, or target for a *sell*. Thus as a recommendation, if you do add such currencies as *preferred*, prefer placing them after the fiats and stable coins. - Several trades may be performed on the same account for a **buy**. For instance: you have both `EUR` and `USDT` and they are both present in the *preferred currencies*, and the desired amount of target currency is high enough such that it would *eat* all of your `EUR` or `USDT`. - Similarly to **trade** 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 the `buy`, trade fees are taken into account to attempt to reach exactly the desired **net** amount. -#### Examples with explanation +##### Examples with explanation ```bash coincenter sell 1 BTC,exchange1,exchange3_user1 @@ -815,9 +816,9 @@ Let's consider following prices, without any trade fees (`coincenter` takes trad A total of `2 ETH` will be bought, from **600 USDT** on `exchange1_user2`, **800 EUR** and **240 USDT** from `exchange3_user1` and **500000 KRW** from `exchange4_user1`. As you can see in this example, it's possible to make several trades per account for one `buy` request. -### Deposit information +#### Deposit information -You can retrieve one deposit address and tag from your accounts on a given currency provided that the exchange can receive it with `deposit-info` option. It requires a currency code, and an optional list of exchanges (private or public names, see [Handle several accounts per exchange](#handle-several-accounts-per-exchange)). If no exchanges are given, program will query all accounts and retrieve the possible ones. +You can retrieve one deposit address and tag from your accounts on a given currency provided that the exchange can receive it with `deposit-info` option. It requires a currency code, and an optional list of exchanges (private or public names, see [Selecting private keys on exchanges](#selecting-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. @@ -825,7 +826,7 @@ Only one deposit address per currency / account is returned. **Important note**: only addresses which are validated against the `depositaddresses.json` file will be returned (unless option `validateDepositAddressesInFile` is set to `false` in `static/exchangeconfig.json` file). This file allows you to control addresses to which `coincenter` can send funds, even if you have more deposit addresses already configured. -### Recent deposits +#### Recent deposits To retrieve the most recent deposits, use the `deposits` option. Currency is optional - if not provided, deposits in all currencies will be returned. @@ -838,30 +839,31 @@ By default, it returns all deposits on given currency, or any currency. You can - `--min-age