Quick Start

https://www.youtube.com/embed/TxsAONovhkk

Create Exchange Account

In order to create your first bot, you will need to create an account on an exchange that works with Scavenger Bot. In some cases you will need to create 2 separate accounts on an exchange if you plan on trading with multiple bots or additional coin pairs. For example, if you want to have a Long Bot and a Short Bot on the BitMex exchange, you will need to register a Long bot account and a Short bot account. We recommend using Gmail aliases for this so you don’t have to use multiple email addresses.

> If your email address is `[email protected]`, you could register the Long bot account as `[email protected]`. By adding the `+` symbol before the `@` symbol followed by an alias name, it will automatically create a gmail alias for that account. All emails you receive from this gmail email alias will still go directly to your inbox as expected.

Connect Exchange

In this section we will walk you through linking your Scavenger Account to your Exchange via API. We use API’s to connect your bot to our software so we can perform the following actions:

• Read open orders
• View prices on the exchange
• View your wallet balance & history
• Place & Cancel orders

> By using the API, we will never require your login information or have any wallet rights to your account. You should NEVER enable withdrawals on your API KEYS.

Bybit Setup

Coming soon.

BitMex Setup

Create Bitmex Account

https://scavengerbot.io/images/wiki/bitmex-create-account.png

Create BitMex API Key

After your account is created, you will need to navigate to the Account > API Keys page and fill in the information for your API Keys. Make sure you name the API Key something associated with the bot you’re creating and set the Key Permission dropdown to `Order`.

https://scavengerbot.io/images/wiki/bitmex-api-keys.png

Create BitMex Bot

Please refer to the Add Bot section below for the next steps in creating your bot.

Binance Setup

Follow Guide Here

https://www.binance.com/en/support/articles/360002502072

Kraken Setup

Coming Soon.

Deribit Setup

Coming Soon.

FTX Setup

Coming Soon.

Bot Management

Add Bot

In this section we will go over how you can add a new bot to your Scavenger Account using the Bot Wizard. Login to your Dashboard and navigate to the Bots page. Once there, click on the Add Bot button at the bottom right of the screen.

https://scavengerbot.io/images/wiki/scavenger-add-bot.png

This will open up the Bot Wizard where you can easily create a new bot.

https://scavengerbot.io/images/wiki/scavenger-create-bot.png

Create Bot

Bot Name

Use this field to name your bot.

Bot Avatar

Choose the hero image that appears on your bot.

Exchange

Exchange Select

Select which exchange you want the bot to run on. At this time, we support multiple futures exchanges.

Exchange Type

Select what exchange subset you are creating a key for, usually live or testnet.

Live

This will use real money to trade with.

Testnet

This will use fake money to trade with, commonly referred to as paper trading.

API Keys

Enter your keys created on the exchange here. If you need assistance in key creation click here.

Verification

This is the status screen that will test and verify your API Keys are ok to use with Scavenger Bot.

Coin Pair

Here you will choose the coin pair that you would like the bot to trade, each scrapper can trade a single trading pair, and there is no limit to the number of bots you can create on your account.

Base Pair

Choose the base pair here, each exchange has different choices, this is the currency you would generally hold in your wallet and trade from and back into.

Coin Pair

Choose your coin pair here, this the symbol or pair that you would like to trade against the Base Pair with.

Strategy

Strategy Select

Here you can select your trading strategy. We are actively developing new strategies to be used with Scavenger Bot. You can find more info on the different types of trading strategies here.

Direction

Short

For strategies that depend on the price of the cryptocurrency to decrease.

Auto

For strategies that are able to automatically determine the direction.

Long

For strategies that depend on the price of the cryptocurrency to increase.

Finish

Clicking this will finalize the Bot Wizard process and create your new bot. You will need to manually turn your bot on afterwards. Please see Bot Controls for instructions on how to do so.

Bot Controls

https://scavengerbot.io/images/wiki/scavenger-bot-controls.png

Start Bot

Clicking the “Play” button will start your bot. Bots that are running will have a blue outline.

https://scavengerbot.io/images/wiki/scavenger-start-bot.png

Stop Bot

Clicking the “Stop” button will stop your bot. Bots that are stopped will be grayed out.

https://scavengerbot.io/images/wiki/scavenger-stop-bot.png

Delete Bot

Clicking the “Trashcan” button will delete your bot. Bots that are deleted will no longer be seen in your dashboard and be removed from our database.

https://scavengerbot.io/images/wiki/scavenger-delete-bot.png

Bot Settings

Clicking the “Cog Wheel” button will open up the settings configured for the strategy you selected. You can tweak these settings at any time.

https://scavengerbot.io/images/wiki/scavenger-bot-settings.png

General Settings

Bot Name

Use this field to name your bot.

Contract Adjustment

https://www.youtube.com/embed/LQNhJGf0dj4

Contract Size

Auto

If set to auto the number of contracts per trade will be based on the following formula (Contract Size % * Balance * Ticker). This number will automatically be adjusted to the exchange minimum.

Manual

If set to manual the bot will buy the number of contracts that you set here.

Enable Max Position Size

Specify the maximum position size that the bot will purchase before it stops adding to the position.

Max Position Size

Setting this value to a percent will use your specified percent and balance to calculate your maximum position size.

Stop Loss

https://www.youtube.com/embed/aJmhoHkOfFg

Enable Stop Loss

Toggle this to Enable/Disable the bot from using a stop loss. Stop Loss will close your position if price moves against your average entry more than this setting in percent.

Enable Trailing Stop Loss

A trailing stop is a stop order that is set at a defined dollar amount away from current market price. If the price moves favorable to your direction a trailing stop will trail the market price in order to maintain your stop order. This amount should be entered as a positive dollar amount and the bot will position according to the type of bot. (Disabled = 0)

Take Profit

https://www.youtube.com/embed/cAHjaL6uSNI

Enable Take Profit

Toggle this to enable Take Profit in %

Enable Trailing Take Profit

This is a Take Profit order that is placed when the bot is in profit. The order will be placed a percentage away from the last traded price.

Dollar Cost Average

Dollar-cost averaging (DCA) is an investment strategy in which an investor divides up the total amount to be invested across periodic purchases of a target asset in an effort to reduce the impact of volatility on the overall purchase. The purchases occur regardless of the asset's price and at regular intervals; in effect, this strategy removes much of the detailed work of attempting to time the market in order to make purchases of equities at the best prices. Dollar-cost averaging is also known as the constant dollar plan.

Enable DCA

Toggle this to Enable/Disable Dollar Cost Averaging (DCA).

DCA Protection

DCA Protection prevents the bot from dollar cost averaging against a position that is already in profit. This should be enabled unless you are wanting to build a position regardless of profit.

Entry Protection

https://www.youtube.com/embed/4nVJD1QDx9E

Enable Entry Protection

Entry Protection uses Stoch RSI in an attempt to avoid entering a position during times of extreme oversold and overbought market conditions.

Overbought

If Stoch RSI D value is higher than the OVERBOUGHT value, the bot will wait before taking a new Long position.

Oversold

If Stoch RSI D value is higher than the OVERSOLD value, the bot will wait before taking a new Short position.

Candle Interval

Choose the candle interval you would like to use to chart Stoch RSI here. Available Timeframes: [ 1M, 5M, 15M, 30M, 1H, 4H ]

Prevent Entry

This can be used to stop the bot from opening any new positions. All of the other functions of the bot will still work, but it will just never open a new position unless you do that on the exchange manually or via other API methods.

Market Change Protection

https://www.youtube.com/embed/Zaqpwi0HA9A

Enable Market Protection

Market Protection looks at the current price versus the previous close of the selected interval in an attempt to not grow a position during times of high volatility.

Max Percent Change

This is the maximum percentage of market movement allowed before temporarily halting trading.

Candle Interval

Choose the candle interval you would like to use to chart Market Change Protection. Available Timeframes: [ 1M, 5M, 15M, 30M, 1H, 4H ]

Smart Channel Protection

https://www.youtube.com/embed/3Ch7ONyUNeU

Enable Smart Channel

Smart Channel Protection is used to avoid building a position during times of low volatility by forming a channel around your entry price.

Channel Contract Limit

This is the number of contracts that you can accumulate before channel protection will become active.

Channel Boundary

When the channel is active the order price will be adjusted to the ticker plus/minus this value depending on bot type.

Candle Interval

Choose the candle interval you would like to use to create the smart channel. Available Timeframes: [ 1M, 5M, 15M, 30 M, 1H, 4H ]

Strategies

Market Maker

Description

This is our original take at a market making style strategy. This style is designed to be used along with Human TA, External Alerts, or Manual Trading. There are some special features in this strategy that has helped it be successful over the past year.

Settings Used

• Contract Adjustment
• Stop Loss
• Take Profit
• Dollar Cost Average
• Entry Protection
• Market Change Protection
• Smart Channel Protection

Trading Companion

Description

This is our webhook strategy for traders looking to use Scavenger Bot with Tradingview, Telegram Signals, Day Trading, and Other Addons. This strategy will allow you to open and close positions via webhook as well as take advantage of other automated settings that Scavenger Bot has to offer.

Settings Used

• Contract Adjustment
• Stop Loss
• Take Profit
• Dollar Cost Average
• Market Change Protection
• Smart Channel Protection

Dashboard

The Dashboard is where you can see an overview of how your bots are performing.

https://scavengerbot.io/images/wiki/scavenger-bot-dashboard.png

Widgets

Balance

Total Balance

This is the total balance of all your accounts. This merges all of the bot’s balances into a Total Balance. Bot specific data will be available in a future release.

Free Balance

This is the unused balance across all of the bots in your account.

Used Balance

This is the used balance across all of the bots in your account.

Profit

Total Profits

This is the total profit that has been gained by all of the bots in your account in USD

PNL Today

This is the total profit that has been gained by all of the bots TODAY on your account in USD/BTC

PNL Yesterday

This is the total profit that has been gained by all of the bots YESTERDAY on your account in USD/BTC.

PNL 7 Days

This is the total profit that has been gained by all of the bots THIS WEEK on your account in USD/BTC.

Ticker

BTC Trend Realtime

Real Time price feed of selected assets.

BTC Trend 1H

USD/Percent Change values over the last hour.

BTC Trend 24H

USD/Percent Change values over the last 24 hours.

BTC Trend 7D

USD/Percent Change values over the last week.

Chart

Area Chart

This is the TOP chart that you see and shows a subset of your profit/loss.

Brush Chart

This is the BOTTOM chart that you see and shows the entirety of your profit/loss. Drag this chart from left to right to see how your bots performed over time.

Table

Day

List of days since starting a bot on the account.

Date

List of dates since starting a bot on the account descending order.

Daily %

Daily Percent gain across all bots on your account.

Daily Profit

Daily Profit across all bots on your account listed in currency

Total Profit

Total Profit all time across all bots on your account listed in currency

Total Balance

Total Balance across all bots on your account listed in currency

Account

My Account

Username

Your Account Username [Permanent]

Email Address

Your Account Email Address [Permanent]

My API

Enable API

Toggle this to enable API access to your bots. This can be used to build or use third party apps to integrate into your own custom project.

```{    "apiKey": "apiKey",    "botName": "bot",    "type": "limit",    "side": "sell",    "amount": 10,    "price": 10,    "params": {        "execInst": "ParticipateDoNotInitiate",        "cancelDelay": 10,        "orderDelay": 10,        "append": true,        "closePosition": 10    } }

Scavenger API Key

This is the key used to authenticate when talking to the Scavenger API

Webhook Trading Address

This is the webhook address to communicate with the Scavenger API

IP Whitelist

Put the IP addresses you would like to white list here.

My Credits

Credit Amount

Use this field to pre apply credits to your account to cover fees. This is the same as prepaying your weekly fee and is good for users who want to save on fees or are going on vacation. Subscription fees will be deducted automatically from this balance.

Adding Credit

Enter the amount you would like to add, then click on prepay. Complete the coinpayments invoice to send money to your bot. CoinPayments is the secure service we use to create and manage invoices.

My Invoices

Invoices

This is where you can find a log of invoices that are Paid, Due, & Overdue. Invoices are sent weekly every Sunday.

https://scavengerbot.io/images/wiki/scavenger-invoice-table.png

Invoice Number

This is the number associated with your invoice for the week.

Invoice Type

This is the type of invoice you are receiving.

Billed Date

This is the date at which the invoice was sent out as a Timestamp.

Due Date

This is the date at which the invoice must be paid by as a Timestamp to avoid service interruption.

Status

This is the current status of the invoice, once paid it should read complete.

Balance Due

This is the current balance due on the invoice, values shown in USD & BTC

Action

This is a button to get an expanded view of the invoice, and opens a downloadable/printable copy for your records.

Paying Invoice

We use CoinPayments to receive payment. Click on the invoice that’s due and click the Pay Now button to complete your transaction.

https://scavengerbot.io/images/wiki/scavenger-invoice-due.png

https://scavengerbot.io/images/wiki/scavenger-invoice-paid.png

Support

Technical Support

All technical support is handled in our Discord. To open a ticket head over to #support-only channel and type the following code with your question. Someone will respond to you shortly after.

-ticket open (type your support issue in parenthesis)

Feature Request

For feature request please open an issue here:
https://github.com/ScavengerBot/ScavengerBot/issues

Bug Report

To report a bug please either open a ticket below:
https://github.com/ScavengerBot/ScavengerBot/issues

Or open a ticket in discord, more info on how to do this in the #support-ticket channel

Live Chat

Chat with us Live on our Discord server.
https://discord.gg/6Ys7gEr 

Affiliates

Become Affiliate

Coming soon.

Affiliate Payouts

Coming soon.

FAQ

Bot Questions

What is the minimum balance?

We recommend 0.2 BTC per direction when running Scavenger Bot. This allows you to use cross leverage to your benefit and minimize risk. You are able to run anything over 0.05 BTC per direction but this will increase your risk & chances of being fully liquidated immensely the less you use.

How does the bot handle exchange overloads?

Scavenger Bot amends orders to keep on the books while the algorithm is able to have timeouts for incremental time periods with the ability to recalculate

What is Cross Margin?

Cross Margin, also known as Spread Margin is a margin method that utilizes the full amount of funds in the Available Balance to avoid liquidations. Any realized PNL from other positions can aid in adding margin on a losing position.

This margin method is useful for users who are hedging existing positions and also for arbitrageurs that do not wish to be exposed on one side of the trade in the event of a liquidation.

Note that, by default all positions are initially set to Cross Margin. If you are new to leverage trading, we reccommend learning more about it here:
https://www.gnomegarden.io/bitmex-setup/

Support Questions

How to open a Support Ticket?

To open a ticket head over to the Discord server #support-only channel and type the following code with your question. Someone will respond to you shortly after.

-ticket open (type your support issue in parenthesis)

How to request a new Feature?

To request a new feature head over to our Github issues page and submit a new issue.

Payment Questions

How can I pay to use the bot?

There will be a weekly invoice with a fee of 15% on your profits made with Scavenger Bot payable in BTC. We will have other payment options in the future also with the ability to prepay for a more automated way to make payments. There is a 48-hour grace period for the weekly payment also. Invoices are sent out every Sunday

Affiliate Questions

How can I become an affiliate?

We’re updating our affiliate program. Please stand by until further notice.

Release Notes

v2.2.9 (latest)

Bug Fixes

• Wallet entries with a state of processing will now be correctly added for withdrawal and deposits. These are complete transactions according to investigations into wallet history but are never changed to complete status by Bitmex.
• Total balance has been changed to use wallet balance instead of margin balance thus correcting max position not working when percentage limit used.

v2.2.8

Bug Fixes

• Insights Data was incorrect due to Bitmex marking a transaction complete but leaving as In Processing these are now added to correct chart and table data.
• API incorrectly reading all transactions versus individual bot pairs currently XBTUSD.

v2.2.7

New Features

• Additional menus on homepage for dashboard.
• Change to account navigation menu.

Bug Fixes

• Unable to pay Invoices on mobile due to button layout in invoice table.
• Scrollbars not styled in Firefox.
• Credit and Balance Due buttons redirecting to homepage.
• Insights table not resizing correctly.
• Time changed for transaction timestamp to ISO format.

v2.2.6

New Features

• New Button Menu with access to many helpful links.
• Ability to now disable DCA protection if wanting to grow a position regardless if in profit or not.
• Fix the cancel button when adding a bot.
• Fix to double balance when using two bots on the same Bitmex account and account number has yet to be acquired.
• Fix to authentication mechanism resulting in spinning circle.
• Fix for version identifier.

v2.2.5

Bug Fixes

• Fix to the trailing stop loss calculations in order to peg price correctly.
• Adjustment to authentication to prevent duplicate access tokens.
• Cleanup of authentication mechanism.
• Fix to bot monitor when bot doesn't exist in cache.
• Fix of duplicate balance when bot is on the same account.
• Adjustment to total profit to include up to date transactions in total and not just till 12:00 AM UTC.

v2.2.4

Bug Fixes

• New settings worker.

v2.2.3

Bug Fixes

• Max Position no longer blocks take profit and stop loss orders.
• Health Monitor now moved to a host level service.
• Transaction Worker now retrieves the attributes from the API correctly.
• Change to use a local API name.
• Move Bitmex Realtime to server level.
• Change UI ticker widget to use new cache in order to prevent client stream bans.
• Change Auth to cache token until expiration reducing a need for two API calls per process.
• Update API requests to include timeout and retry.
• Fix cancel order method.

V2.2.2

New Features

• New Virtual Environment
• Upgrade of Python
• Bot Updated to Multi-Threading
• New Bot Caching Storage

Bug Fixes

• Hotfixes to the Backend Servers

v2.2.1

New Features

• Introduction of websocket API.
• All realtime UI interaction converted to websockets.
• Numerous performance tweaks and introduction of build systems.
• Ordering engine tweaked to prevent price drift.
• Market Change Protection now applies regardless of direction of move to prevent pump or dump buying.

v2.1.3

New Features

• Update README.md

v2.1.1

Bug Fixes

• Complete API with trade information and bot control.
• Bot Management now integrated into the API
• All information in realtime if bot is active otherwise an hour delay if API is available.
• Complete bot rewrite to async and now integrated into the API
• New health monitoring with auto restart.
• All settings are now customizable in the UI.
• Stop loss added.
• Max position limit added.
• Risk adjustment replaced by contract adjustment to better reflect purpose.
• New tooltips for settings.
• New detailed invoicing.
• Ability to pay or prepay in other coins besides BTC.
• Rework of Bot Insight calculation to ignore duplicate history information.
• Ability to run one testnet account.
• Rework of Bot Insight calculations
• Adjustment to chart selection on brush chart.
• New Entry Prevention so one can pause the bot but still allow it to maintain the current position or also overlay scavenger strategies with third party signals or manual entry.

v1.2.1

Bug Fixes

• When using multiple bots on the same Bitmex account data was duplicated.
• Charts included historical data before bot creation. Changed to a default value in charts of the first bot created until the date filter is added.

v1.2.0

Bug Fixes

• Multiple Bug Fixes to different bot status.
• Initial release of Bot Insights
• 5 Minute Wallet Check
• 5 Minute Profit Check
• 1 Minute BTC Info
• All Bots Profit Chart
• Removal of Overdue Invoicing
• Restructure of Backend
• New Backend API

v1.1.5

Bug Fixes

• Fix for unable to adjust risk on bots that followed a bot that is below minimum balance.
• Fix for bot settings not changed message when closing the settings menu.
• Redesign of login system to align with new UI styling.
• Adjustment to bot balance to now be updated every three hours (near real-time in next release)

v1.1.4

Bug Fixes

• Adjustment to entry protection to include new TA framework and indicators now based on hourly changes. This timeframe will be user configurable in later release.
• New risk adjustment calculation from a standard 75x multiplier to balance x price x risk percent.
• New UI styling.
• Introduction of user defined settings with first one being risk adjustment.

v1.1.3

Bug Fixes

• Added ground work for bot settings including risk adjustment.
• Added Channel Protection.
• Added Percent Protection.
• Rework of user bot UI.

v1.0.5

Bug Fixes

• Bot servers no longer rely on settings file but retrieve settings directly from the database.
• Deploy of initial UI for Bot Management
• Add bot status to UI.
• Moved bot creation and provisioning into a better more user-friendly workflow.
• Minor cosmetic tweaks.
• Added initialization randomization to API connector.

Issues

• Registration not allowing login if user password contains & or ^.
• Registration not allowing login if username contains email.

The online Word 2 HTML converter lets you transform Word documents to a clean code with just a few clicks.