VantageSignals 3xmom Momentum bot

~ 0 min
2020-08-17 22:29

Below is a capture of the help from the application/script. just create a shell script to run the app with the switches configured as you desire and your signal channel will be online. The script can report to Discord channel or public Telegram channel.

APi Subscription requirements: Price, Volume, 100dom orderbooks, 7d or longer.  Number of API calls depends on how often you poll and how many assets you are polling.


  • Source code (Clone or download)
  • Self installer "python3.7 setup.py install" see readme in repo
  • Redis is optional but important if you want to be able to kill and restart the process without lossing post flag performance reports (You must install Redis to use it)
  • If you have questions you can aks us in our help discord channel
  • You can see the markets, assets and values to qualify your signal settings at https://vcdepth.io
  • Different Scripts require different subscriptions to support, make sure you have the API data you need for the script
  • A script must run for each asset/market you want to monitor
  • Old app was vc-discord-3xmom, new app is vc-signals-3xmom
  • This script defaults to +price +vol +orderbook = bull | -price +vol -orderbooks = bear but you can override this by using +/- in front of bear and bull indicator values
  • Opensource and our API is a liberal license to use our data for profit but you should state that you use VantageCrypto data in your channel description per VantageAPI user agreement.

Usage Example:

vc-signals-3xmom -a LEND -m GLOBAL -i 2 -tbear 5 -tbull 4 -tl 1 -b2b 6 -ti1 1 -ti2 3 -ti3 6 --bull-cooldown 360 --bear-cooldown 360 -pbull 3 -obull 7 -vbull 10 -pbear 4 -obear 10 -vbear 12 -r redis:localhost:6379 VANTAGECRYPTO_API_KEY https://discord.com/api/webhooks/12345678abcdefg1a2b3c --debug  >> /var/log/bots/3xmombot_lend.log &

This script

  • Checks LEND values in global markets every 2 minutes (and compares them to values from 1 hour ago)
  • We have to see a bear signal 5 times before we flag the signal in channel
  • We have to see the bull flag 4 times before we signal in channel
  • If we see a bull or bear occur within 6 hours of the other, we convert the signal and start tracking gains/loss for the new signal instead.
  • Both the bull and the bear signals must wait 6 hours before signalling again.
  • To signal bull the price needs to rise by 3%, the orderbooks/100 by 7% and volume by 10% over the last hour.
  • To signal bear the price needs to drop 4%, orderbooks 10% and volume 12% over a one hour period.
  • We use redis to store performance reports
  • We pump the alert out to a discord channel webhook
  • We are debugging so we see the API calls and the logic in action and we pump all the output into a log file
  • We run it in the background.

It doesnt take much to make this script signals easier or more difficult to trigger just adjust poll interval, trend length and bear/bull % signal values. 


usage: vc-signals-3xmom [-h] [-a ASSET] [-m MARKET] [-i INTERVAL] [-r REDIS]
[-tl TREND_LENGTH] [-ti1 TRACKER_INTERVAL_1]
[-ti2 TRACKER_INTERVAL_2] [-ti3 TRACKER_INTERVAL_3]
[--bull-cooldown BULL_COOLDOWN]
[--bear-cooldown BEAR_COOLDOWN] [-pbull PRICE_BULL]
[-obull ORDERBOOK_BULL] [-vbull VOLUME_BULL]
[-pbear PRICE_BEAR] [-obear ORDERBOOK_BEAR]
[-vbear VOLUME_BEAR] [-tbull BULL_THRESHOLD]
[-tbear BEAR_THRESHOLD] [-b2b BULL_2_BEAR] [--silent]
[--pr] [--acc] [--clear] [--debug]
api_key webhook

Discord signals for crypto currency changes via Vantage Crypto.

positional arguments:
api_key api key for Vantage Crypto
webhook discord webhook url

optional arguments:

-h, --help show this help message and exit

-a ASSET, --asset ASSET
asset to check (default: BTC)

-m MARKET, --market MARKET
market for price check (default: GLOBAL)

-i INTERVAL, --interval INTERVAL
interval of checks in minutes (default: 5)

-r REDIS, --redis REDIS
redis url (default: redis://localhost:6379)

-tl TREND_LENGTH, --trend-length TREND_LENGTH
How many hours back we compare the current values to
(default: 1)

-ti1 TRACKER_INTERVAL_1, --tracker-interval-1 TRACKER_INTERVAL_1
How many hours before we perform the first post flag
performance report (default: 1)

-ti2 TRACKER_INTERVAL_2, --tracker-interval-2 TRACKER_INTERVAL_2
How many hours before we perform the second post flag
performance report (default: 3)

-ti3 TRACKER_INTERVAL_3, --tracker-interval-3 TRACKER_INTERVAL_3
How many hours before we perform the third post flag
performance report (default: 24)

--bull-cooldown BULL_COOLDOWN
How many minutes after a BULL flag triggers before the
script can trigger a flag again (default: 1440)

--bear-cooldown BEAR_COOLDOWN
How many minutes after a BEAR flag triggers before the
script can trigger a flag again (default: 1440)

-pbull PRICE_BULL, --price-bull PRICE_BULL
What % price change we need to witness for bull signal
(1-300) (default: 3)

-obull ORDERBOOK_BULL, --orderbook-bull ORDERBOOK_BULL
What % orderbook change we need to witness for bull
signal (1-300) (default: 4)

-vbull VOLUME_BULL, --volume-bull VOLUME_BULL
What % volume change we need to witness for bull
signal (1-300) (default: 5)

-pbear PRICE_BEAR, --price-bear PRICE_BEAR
What % price change we need to witness for bear signal
(1-300) (default: -3)

-obear ORDERBOOK_BEAR, --orderbook-bear ORDERBOOK_BEAR
What % orderbook change we need to witness for bear
signal (1-300) (default: -4)

-vbear VOLUME_BEAR, --volume-bear VOLUME_BEAR
What % volume change we need to witness for bear
signal (1-300) (default: 5)

-tbull BULL_THRESHOLD, --bull-threshold BULL_THRESHOLD
How many times we need to see all 3 condition match
before flagging bull (1-100) (default: 1)

-tbear BEAR_THRESHOLD, --bear-threshold BEAR_THRESHOLD
How many times we need to see all 3 condition match
before flagging bear (1-100) (default: 1)

-b2b BULL_2_BEAR, --bull-2-bear BULL_2_BEAR
If opposite signal happens with provided minutes
convert current signal to opposite type (default: 1)

--silent Do not send post flag reports (default: False)

--pr Create a performance report (default: False)

--acc Accumulate data for the performance report. Should be
used with --pr flag (default: False)

--clear clear all data for market/asset (default: False)

--debug enable debug logging (default: False)

Average rating 0 (0 Votes)

You cannot comment on this entry