Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Simple Market Maker in Java

An implementation of a dummy market making bot which intends to be a starting point showing a possible way of integration with Quedex Java API. Before starting to work with this code, please read the documentation of our Java API.

The implementation of the bot MUST NOT be considered complete and ready for production use. The pricing algorithms, risk management, handling of WebSocket disconnects (lack thereof), etc. are just to illustrate a simple use case.


To run the bot you need to have Java 8 installed (Oracle Java is recommended).

Standalone JAR

The following steps are for Linux (tested on Ubuntu 16.04):

  1. Execute ./gradlew shadowJar from the main project directory (java-market-maker).
  2. Jar will be created in java-market-maker/build/libs/ named java-market-maker-<version>-all.jar.
  3. Copy the jar to a convenient location, place your and (examples may be found in java-market-maker/src/main/resources) next to it.
  4. Run the jar with java -jar java-market-maker-<version>-all.jar To exit hit CTRL + C.

From an IDE

  1. Clone the repository.
  2. Import the gradle project to your favourite IDE (tested with IntelliJ).
  3. Fetch the dependencies (should happen automatically).
  4. Rename the file in java-market-maker/src/main/resources to and fill in your details.
  5. Rename the file in java-market-maker/src/main/resources to and change the configuration according to your liking.
  6. Run the Main class.


The market making bot:

  • places orders with configurable quantities on configurable number of levels,
  • has configurable spread,
  • follows a predefined Fair Price for futures (currently last price or mid - change the implementation in the MarketMaker class between LastFairPriceProvider and MidFairPriceProvider),
  • places option orders priced according to Black 76' model,
  • has configurable risk management - stops quoting one side of the order book when delta or vega limit exceeded,
  • enables risk monitoring based on greeks (delta, vega, gamma, theta), per position and in total,
  • cancels all orders when going down or on error.


This document and the code presented in this repository does not constitute any investment advice. By running it, you are not guaranteed to earn any bitcoins (rather the opposite).

Contributing Guide

Default channel for submitting questions regarding the bot is opening new issues. In cases when information disclosure is not possible, you can contact us at

Pull requests containing bugfixes are very welcome!


Copyright © 2017 Quedex Ltd. The bot is released under Apache License Version 2.0.