Harmonia is a Java console application to allow participants in the USD margin funding market to automatically submit margin funding offers at competitive rates. Harmonia also estimates and displays accrued interest throughout the bot's execution.
Harmonia requires a JDK and Apache Maven.
After cloning the repository, execute the following commands in the Harmonia base directory:
mvn compile
mvn exec:java -Dexec.mainClass="name.evdubs.harmonia.Harmonia"This process should build, download dependencies, and run Harmonia
When Harmonia starts, you are prompted to enter your API Key and Secret Key. There are perhaps other, better methods of acquiring and using these details. Please note that anyone with access to the system you execute Harmonia on can dump the heap and find your keys. Therefore, it is wise to run Harmonia in a jailed environment that only you have access to.
Harmonia is a simple margin funding offer bot. It will attempt to offer margin funds using the following logic:
Here, the market (everyone else's orders) may look like
| Bid duration | Bid amount | Bid rate | Offer rate | Offer amount | Offer duration |
|---|---|---|---|---|---|
| 2-30 days | 20,000 | 0.05% (FRR) | 0.06% | 30,000 | 30 days |
Harmonia will see this bid and hit it. As a result, you will have outstanding margin funding provided at FRR for 30 days.
Here, the market may look like
| Bid duration | Bid amount | Bid rate | Offer rate | Offer amount | Offer duration |
|---|---|---|---|---|---|
| 2-30 days | 20,000 | 0.05% | 0.06% (FRR) | 30,000 | 30 days |
Harmonia will see the FRR order and send an offer with your remaining deposit balance for 30 days FRR. This offer will sit on the book and wait for a margin lender to take it. This calculation is computed once every twenty seconds, so if the market moves, Harmonia will change the offer twenty seconds later.
Here, the market may look like
| Bid duration | Bid amount | Bid rate | Offer rate | Offer amount | Offer duration |
|---|---|---|---|---|---|
| 2-20 days | 20,000 | 0.06% | 0.055% | 30,000 | 30 days |
| 2-30 days | 40,000 | 0.05% | 0.065% | 60,000 | 30 days |
Harmonia will send an offer at 0.065% as the 0.055% offer is lower than the highest demand rate of 0.06%. This offer will sit on the book and wait for a margin lender to take it. This calculation is computed once every twenty seconds, so if the market moves, Harmonia will change the offer twenty seconds later.
Harmonia recently instituted the requirement to only pay attention to offers that are at least 10 minutes old. This is a hacky way to not automatically join offers that are outlandishly far away from the core of the competitive offers. A better mechanism would likely incorporate a moving average of recent margin funding matches, but there is not currently a way to receive this stream from XChange.
Public domain
If you like this bot and would like for development to continue, please consider sending a donation to 1JSvYwhAWMCKB4zgvMFLDzhRp8u9Hv5Fat