Overview

Introduction

A trading bot is a computer program that can automatically place orders to a market or exchange without the need for human intervention. They are working for you 24/7 and never lose their focus.

Cassandre trading bot (available as a Spring boot starteropen in new window) allows you to create and execute your trading strategy in seconds on several crypto exchanges.

Once the starter is added to your Spring Boot project, it will search for a class having the @CassandreStrategyopen in new window annotation and extending BasicCassandreStrategyopen in new window or BasicTa4jCassandreStrategyopen in new window.

We also provide a dry mode and a spring boot starter to simulate a virtual exchange so you can backtest your strategies on historical and/or real-time data.

BasicCassandreStrategy

For a BasicCassandreStrategyopen in new window, you have to implement :

• getRequestedCurrencyPairs()open in new window to indicate the list of currency pairs tickers you want to receive.
• getTradeAccount()open in new window to indicate which account on the exchange is the one you are using for trading.

BasicTa4jCassandreStrategy

For a BasicTa4jCassandreStrategyopen in new window, you have to implement :

• getRequestedCurrencyPair()open in new window to indicate the currency pair tickers you want to receive.
• getTradeAccount()open in new window to indicate which account on the exchange is the one you are using for trading.
• getMaximumBarCount()open in new window to indicate how many bars you want to keep.
• getDelayBetweenTwoBars()open in new window to indicate the delay between two bars.
• getStrategy()open in new window to implement your own strategy.
• shouldEnter()open in new window to indicate what you want to do when it's time to buy.
• shouldExit()open in new window to indicate what you want to do when it's time to sell.

Data updates

To receive data from the exchange, you can override the following methods :

• onAccountsUpdates()open in new window to receive updates about your accounts.
• onTickersUpdates()open in new window to receive new tickers.
• onOrdersUpdates()open in new window to receive updates about your orders.
• onTradesUpdates()open in new window to receive updates about your trades.
• onPositionsUpdates()open in new window to receive updates about your positions.
• onPositionsStatusUpdates()open in new window to receive updates about positions status change.

Buying/selling

Inside your strategy, you can create market orders with the methods :

• createBuyMarketOrder()open in new window
• createSellMarketOrder()open in new window

And limit orders with :

• createBuyLimitOrder()open in new window
• createSellLimitOrder()open in new window

Positions

You can also create positions with :

• createLongPosition()open in new window
• createShortPosition()open in new window

On Positions, you can get the:

• The lowest calculated gain with getLowestCalculatedGain()open in new window
• The highest calculated gain with getHighestCalculatedGain()open in new window
• The latest calculated gain with getLatestCalculatedGain()open in new window

On a closed position, you can get the gain & fees with getGain()open in new window

TIP

If you don't know what a position is, read this position system explanation.