A simple (CLI) tool that automatically trades cryptocurrencies based on a defined threshold
A simple (CLI) tool that automatically trades cryptocurrencies based on a defined threshold
Diversification is a common investment technique of spreading investments around to reduce the volatility of a portfolio over time. Peanuts allows building a diversified cryptocurrency portfolio by buying coins you don’t have already and selling those you have based on defined thresholds. It all happens automatically and is supposed to be configured as a cronjob that is executed once per minute/hour/day.
npm install -g peanuts
$ peanuts {OPTIONS}
Peanuts is configured using the following options via a configuration file, environment variables, and/or command-line arguments.
First of all, Peanuts looks for a JSON file called peanuts.json within the current working directory.
{
"base": "eur",
"currency": "btc",
"top": "10",
"amount": "50",
"threshold": "150",
"order": [
"binance"
],
"blacklist": [
"btc",
"eth",
"ltc"
]
}
Afterwards, Peanuts will take environment variables into account.
base=eur currency=btc top=20 amount=20 threshold=150 peanuts
Concluding, Peanuts will take command-line arguments into account.
peanuts --base=eur --currency=btc --top=20 --amount=20 --threshold=150 --blacklist=BTC --blacklist=ETH --blacklist=LTC
(All options are merged into a single configuration using the hierarchy described above.)
Due to the fact that there is no all-in-one exchange service that offers all currencies, you can add multiple exchanges to Peanuts.
Now that Peanuts is able to perform buys for you, you need to specify what kind of buys you want to be performed.
baseThe base currency used for specifying the desired amount.
Example: USD
Default: EUR
currencyThe cryptocurrency used for actually buying cryptocurrencies (as most exchanges only accept other cryptocurrencies like Bitcoin for buying altcoins).
Example: ETH
Default: BTC
topThe quantity of currencies you want to check starting at #1 of the CoinMarketCap ranking.
Example: 20 (#1—#20)
Default: 10 (#1—#10)
amountAmount of your base currency to buy currencies for.
Example: 20
Default: 10
thresholdGrowth rate to sell currencies at expressed as a percentage based on (and including) the buying price (= 100%). For instance 200 equals 200% and means that your currencies are sold as soon as they doubled in value.
Example: 150
Default: 200
storageTemporary storage (= JSON file) where your portfolio (currencies held including their buying cost) is stored.
Example: /Users/johndoe/Desktop/portfolio.json
Default: storage.json (within the current working directory)
blacklistList of currencies (= their symbols) that shall be ignored/skipped.
Example: ['BTC', 'ETH']
Default: []
whitelistList of currencies (= their symbols) that shall be traded without exception. Any other currency will be ignored/skipped.
Example: ['XRP', 'XLM']
Default: []
orderRanking of your preferred exchange services. For instance ['kraken', 'bitfinex'] would always try to buy/sell your portfolio using Kraken but fall back on Bitfinex in case Kraken does not support the respective currency.
Example: ['kraken', 'bitfinex']
Default: []
Peanuts uses ccxt for trades and currently supports the following 101 cryptocurrency exchange markets and trading APIs.
Special thanks to Robert Kowalski for handing over the peanuts package name on npm to me. Please check out robertkowalski/peanuts in case you’re looking for the code of versions <2.0.0.
You use Peanuts at your own risk. I would only recommend trying out Peanuts with small amounts you are willing to lose for educational purposes. Running a bot (and trading in general) requires careful study of the risks and parameters. Wrong settings can cause a major loss. Peanuts relies on 3rd party APIs which may fail at any time and is experimental software which also may fail at any time. Thus never leave Peanuts un-monitored for long periods of time. Be prepared to stop it if too much loss occurs. You alone are responsible for anything that happens when you’re live-trading.
Copyright (c) 2018 Thomas Rasshofer
Licensed under the MIT license.
See LICENSE for more info.
FAQs
A simple (CLI) tool that automatically trades cryptocurrencies based on a defined threshold
The npm package peanuts receives a total of 2 weekly downloads. As such, peanuts popularity was classified as not popular.
We found that peanuts demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Newly introduced telemetry in devenv 1.4 sparked a backlash over privacy concerns, leading to the removal of its AI-powered feature after strong community pushback.
Security News
TC39 met in Seattle and advanced 9 JavaScript proposals, including three to Stage 4, introducing new features and enhancements for a future ECMAScript release.
Security News
Deno 2.2 enhances Node.js compatibility, improves dependency management, adds OpenTelemetry support, and expands linting and task automation for developers.