- Notifications
You must be signed in to change notification settings - Fork77
Portfolio Overview Tool for Your CryptoCoin Capitalization-Weighted Portfolio.
License
NotificationsYou must be signed in to change notification settings
benmarten/CryptoETF
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
DISCLAIMER: This tool neither is, nor should be construed as an offer, solicitation, or recommendation to buy or sell any cryptoassets.
A CLI app, that pulls the cryptocoin balances from your exchanges and displayes your portoflio in comparison to the overall market. A recommendation is shown based on the ideal capitalization-weighted portfolio.npm installnpm run buildcp settings.example.json settings.json
Run the sample:node sample
Edit settings.json with your exchange api keys, then:node index
CryptoETF has API integrations with the following exchanges:
- Coinbase. Join Here:https://www.coinbase.com/join/587ab088801bae035cad02c5
- GDAX. Join Here:https://www.gdax.com/
- Poloniex. Join Here:https://www.poloniex.com
- Bittrex. Join Here:https://www.bittrex.com
- Binance. Join Here:https://www.binance.com/?ref=12278261
- HitBTC. Join Here:https://hitbtc.com/?ref_id=5a3596f643b9e
- Bitfinex. Join Here:https://www.bitfinex.com
- Kraken. Join Here:https://www.kraken.com
- Bitgrail. Join Here:https://bitgrail.com
With these exchanges, you can easily build yourself your own CryptoETF.
The tool expects your settings in settings.json. Take a look at settings.example.json for a starting point.
- accounts: Under accounts, fill in your api credentials for the exchange that you want to use. Delete the exchanges that you do not need.
- symbolMapping: Some exchanges use different symbols that coinmarketcap.com. Hence here you can map the symbols, e.g.: map MIOTA to IOTA.
- otherHoldings: A place to manually add some of your holdings. Notation is key: Symbol, value is amount of native currency.
- allocations: Here you can manually define allocations of coins. The allocations is calculated from the amount of points it gets relative to the total amount of points. Filling in
66.67
and33.33
for two currencies will yield the same result as6
and3
for example. If allocations is not mentioned in settings.json the allocations will reflect the coin's market cap relative to the other coins in the portfolio. - options: These are specific options for the tool:
- targetValueUsd: The target value for your ETF; A general rule of thumb is to keep your crypto at a certain percentage of your overall investment portfolio. This could be 5, 10, 20 or more percent, depending on your risk tolerance.
- Default [false]: Use current portfolio value as target value.
- Number [1 - 999999999999]: Use fixed number as target value.
- rebalanceDeltaTotalPct: Treshold in percent, that will show a Y in the rebalance column, once rebalancing of total portfolio is recommended.
- rebalanceDeltaPct: Treshold in percent, that will show a Y in the rebalance column, once rebalancing of individual position is recommended.
- minValueBtc: Ignore coins that only have a holdingsvalue under a certain bitcoin value.
- exchangeMinValueBtc: Don't list exchanges in the exchanges column, with less than the specified BTC value. The complete holding value will still be added in the total sum.
- hideMissingCoins: By default CryptoETF will add all missing coins up to your last coin holding by rank of the coin (global market cap). This option disables that behaviour.
- targetValueUsd: The target value for your ETF; A general rule of thumb is to keep your crypto at a certain percentage of your overall investment portfolio. This could be 5, 10, 20 or more percent, depending on your risk tolerance.
- outputFile: Path to a file to forward the output to as json.
npm test
To run all the unit tests, without the integrations, which require api keys.npm testLocal
To run all the unit tests, with the integrations, which require you to set all api keys in settings.json.
Please send PR's to the develop branch!
- Fork it!
- Create your feature branch:
git checkout -b my-new-feature
- Commit your changes:
git commit -am 'Add some feature'
- Push to the branch:
git push origin my-new-feature
- Submit a pull request to the develop branch :D
git checkout developgit flow release start "1.6.2"git rebase masternpm run testnpm --no-git-tag-version version 1.6.2git flow release finish "1.6.2"git pushgit checkout master && git push && git push --tags
See LICENSE.md
- BTC: 1jzYq6yo4MCZnjsGFahhV8ZQd7TwLeCL6
- ETH: 0xfE131Eb3dc3E0476d7eD26134A4A17Cc253C1689
- LTC: LUVz63UPLqsQG5LHD3zgnaHGts7bm4Yxm8
About
Portfolio Overview Tool for Your CryptoCoin Capitalization-Weighted Portfolio.
Topics
Resources
License
Code of conduct
Stars
Watchers
Forks
Packages0
No packages published