| Exchange | Implemented | Tested | Note |
|---|---|---|---|
| Bitfinex | ✓ | ||
| Bittrex | ✓ | ||
| Hitbtc | ✓ | ||
| OKCoin | |||
| Kraken | |||
| Bithumb | |||
| Gdax | |||
| Coinone | |||
| Huobi | |||
| Bitstamp | |||
| Korbit | |||
| Bitflyer |
1. Create .env
Copy .env.dist to .env and modify it's values if needed.
2. Build bot
Only for the first time or if Dockerfile was changed.
docker-compose build bot3. Apply database migrations
Will create a schema and set the current version of migration for database.
make migrate-up4. Run bot
On local stage
make runOn server:
docker-compose up -d botmake testIf you test bot manually on stage, look at cryptotrader.cli module.
It contains useful staff to prepare exchanges for tests.
We are using a migrate tool in cryptotrader/migrate
docker image, that helps us to apply migrations for database's schema.
cryptotrader/migrate has some rules:
- all migration files must be placed in the /usr/migrations container directory
- the container must have a config file with a specified
dsnvariable for work with a database
Use the make help receipt to see a migrate reference.
It contains trading terms and their definitions and our projects inside terms.
List of terms that you can find here:
String name of currency tickers pair.
EURUSD for example.
Representation of one traded currency pair.
Every exchange has pairs list.
Pair = pair + ask/bid price + ask_size/bid_size -> EURUSD 1.2/1.1 100/1000
Example:
Pair EURUSD 1.2/1.1 100/1000 means:
- we can buy 1 EUR for 1.2 USD, in other words is ask pair
- we can sell 1 EUR for 1.1 USD, in other words is bid pair
- we can buy 100 EUR with this pair
- we can sell 1000 EUR with this pair
an ask is lower sale price (seller is exchange) and a bid is higher purchase price (buyer is exchange).
Example:
EURUSD 1.2/1.1 (ask/bid) means that we can buy a EUR for 1.2 USD and sell a
EUR for 1.1 USD.
Offer to sell or to buy on certain exchange and contains ask/bid pairs.
Offer that ready to be sent to exchange. The order can be pending, canceled or completed.
The strategy can buy cheaper on one exchange and sell it more expensively on another exchange. To earn a profit an arbitrage window is used. The strategy places related orders when a window is opened and places reversed orders when the window is closed. For the detail you can look at the Arbitrage class.
the temporary exchange rate conditions in which ask price on one exchange is less than bid price on another exchange.
Example: An exchange A's aks/bid is 1.2/1.1 and an exchange B's ask/bid is 1.0/0.9, then spread between the A and the B exchanges is: A.ask - B.bid = 1.1 - 1.0 = 0.1. and it means, that now arbitrage window is opened.
It's minimal order amount, set by exchange.
Every pair has it's own limit.
Exchange set it in this way: BTCUSD: 0.001.
This example means, that bot can create order with amount greater then 0.001 BTC.
Bot must have enough BTC or USD balances in this case.
Temporary note (22.04.18): Currently we put this limits in config manually. But the right way is to get this limits from exchanges api. We'll implement it with #311 github issue.