Vantage Signals 3xmom Momentum bot

~ 0 min
2020-11-07 02:54

Vantage Signals 3x Momentum Bot

This bot leverages Price, Volume and Total combined orderbooks to signal. See more details about these indicators here:

API Subscription requirements: Price, volume, (100dom and/or 10dom and/or 5dom and/or 2.5dom, and/or 1%) depth of orderbooks, 7d or longer duration subscription.  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 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
  • Different Scripts require different subscriptions to support, make sure you have the API data you need for the script
  • See our API reference for further details > VantageCrypto Modular API Services API Reference
  • A script must run for each asset/market you want to monitor
  • Opensource code for transparency and community using GPL. Our API is a liberal license to use our data but you should state that you use VantageCrypto data somewhere on your server/channel description per VantageAPI user agreement.

Other than the indicators, all of our bots have the same construction, some of their common features and configurations are below.

  • All bots can report to Discord, Telegram or Twitter
  • All of our bots also include price as an indicator.
  • All bots can send post flag performance reports into channels as they occur or on scheduled reports
  • All bots have a back testing feature
  • All bots can set order book market depth
  • All bots can set real-time or moving average values for each indicator
  • All indicators are absolute values unless you specify a trend-length | If trend-length (or master trend length) is set, all indicator values are percentages | We will compare current value to the value from the length of time you specified | Trend-Length can be set globally or per bull and/or bear indicator
  • All bots have a cooldown timer to have the signal snooze x amount of time after the first flag

Command reference:

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 --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. 

[-twats TWITTER_ACCESS_TOKEN_SECRET] [-r REDIS] [--prefix PREFIX] [--clear] [--pr] [--acc] [-ti1 TRACKER_INTERVAL_1] [-ti2 TRACKER_INTERVAL_2] [-ti3 TRACKER_INTERVAL_3] [-d DURATION] [--silent]
[-bullptl PRICE_BULL_TREND_LENGTH] [--bear-cooldown BEAR_COOLDOWN] [--bull-cooldown BULL_COOLDOWN] [-md MARKET_DEPTH] [-obav ORDERBOOK_AVERAGE] [-tbear BEAR_THRESHOLD] [-tbull BULL_THRESHOLD] [-b2b BULL_2_BEAR]
[-bullo ORDERBOOK_BULL] [-bearv VOLUME_BEAR] [-bullv VOLUME_BULL] [--json JSON] [--btoe]

Signals for crypto currency changes via Vantage Crypto.

positional arguments:
api_key api key for Vantage Crypto

optional arguments:
-h, --help show this help message and exit

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

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

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

--debug enable debug logging (default: False)

discord webhook url (default: None)

telegram bot token (default: None)

telegram channel username with prepended '@' symbol (default: None)

Twitter consumer key (default: None)

Twitter consumer secret (default: None)

Twitter access token (default: None)

Twitter access token secret (default: None)

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

--prefix PREFIX Redis prefix for keys (default: None)

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

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

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

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

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

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

-d DURATION, --duration DURATION
Specifies the duration of API subscription being used (rt, 7d, 30d, 90d, 1y) (default: 7d)

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

-bts BACKTEST_START, --backtest-start BACKTEST_START
Number of days ago to start the test | max based on duration specified (currently 90 day max) (default: None)

-btsd BACKTEST_START_DATE, --backtest-start-date BACKTEST_START_DATE
Date when to start tests (default: None)

We allow up to 30 days of back testing at a time but max is limited by duration specified (default: 1)

Append all post reports to specified file for backtesting, file should be in .md format (default: None)

How many API calls to make per minute (default: 120)

--backtest-cache Use cache for backtesting. Every vc query will be cached for 24 hours (default: True)

-tl TREND_LENGTH, --trend-length TREND_LENGTH
Compare current values to values TL hours ago (default: None)

-bearptl PRICE_BEAR_TREND_LENGTH, --price-bear-trend-length PRICE_BEAR_TREND_LENGTH
Compare price values to values TL hours ago for bear flag (default: None)

-bullptl PRICE_BULL_TREND_LENGTH, --price-bull-trend-length PRICE_BULL_TREND_LENGTH
Compare price values to values TL hours ago for bull flag (default: None)

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

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

-md MARKET_DEPTH, --market-depth MARKET_DEPTH
What depth of market should we watch? (1,2.5,5,10,100) (default: 100)

What Order Book average should we use: real-time, 1 hour, 3 hour or 24 hour (rt,1,3,24) (default: rt)

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

-tbull BULL_THRESHOLD, --bull-threshold BULL_THRESHOLD
How many times we need to see all 3 conditions match before flagging bull (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: None)

Compare orderbook values to values TL hours ago for bear flag (default: None)

Compare orderbook values to values TL hours ago for bull flag (default: None)

-bearvtl VOLUME_BEAR_TREND_LENGTH, --volume-bear-trend-length VOLUME_BEAR_TREND_LENGTH
Compare volume values to values TL hours ago for bear flag (default: None)

-bullvtl VOLUME_BULL_TREND_LENGTH, --volume-bull-trend-length VOLUME_BULL_TREND_LENGTH
Compare volume values to values TL hours ago for bull flag (default: None)

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

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

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

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

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

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

--json JSON

--btoe Expects BTOE arguments (default: False)


Average rating 0 (0 Votes)

You cannot comment on this entry