Skip to content

Commit

Permalink
add marketcap doc
Browse files Browse the repository at this point in the history
  • Loading branch information
narumiruna committed Sep 15, 2022
1 parent 72f18c1 commit d236cde
Show file tree
Hide file tree
Showing 2 changed files with 30 additions and 0 deletions.
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -353,6 +353,8 @@ Check out the strategy directory [strategy](pkg/strategy) for all built-in strat
- `support` strategy uses K-lines with high volume as support [support](pkg/strategy/support). See
[document](./doc/strategy/support.md).
- `flashcrash` strategy implements a strategy that catches the flashcrash [flashcrash](pkg/strategy/flashcrash)
- `marketcap` strategy implements a strategy that rebalances the portfolio based on the
market capitalization [marketcap](pkg/strategy/marketcap). See [document](./doc/strategy/marketcap.md).

To run these built-in strategies, just modify the config file to make the configuration suitable for you, for example if
you want to run
Expand Down
28 changes: 28 additions & 0 deletions doc/strategy/marketcap.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
### Marketcap Strategy

This strategy will rebalance your portfolio according to the market capitalization from coinmarketcap.

### Prerequisite

Setup your `COINMARKETCAP_API_KEY` in your environment variables.

#### Parameters

- `interval`
- The interval to rebalance your portfolio, e.g., `5m`, `1h`
- `baseCurrency`
- The base currency of your portfolio, e.g., `USDT`, `TWD`.
- `baseWeight`
- The weight of the base currency in your portfolio. The rest of the weight will be distributed to other currencies by market capitalization.
- `targetCurrencies`
- A list of currencies you want to hold in your portfolio.
- `threshold`
- The threshold of the difference between the current weight and the target weight to trigger rebalancing. For example, if the threshold is `1%` and the current weight of `BTC` is `52%` and the target weight is `50%` then the strategy will sell `BTC` until it reaches `50%`.
- `dryRun`
- If `true`, then the strategy will not place orders.
- `maxAmount`
- The maximum amount of each order in base currency.

#### Examples

See [marketcap.yaml](../../config/marketcap.yaml)

0 comments on commit d236cde

Please sign in to comment.