This repo has been updated with improved API client generation. Key updates include:
- New API Client Generation Process: Replaced the outdated client generation with a more reliable method
- Fixed OpenAPI YAML Files: Added scripts to fix issues in the Thorchain OpenAPI specifications
- Better Documentation: Updated instructions for client generation and installation
The repo can still be used for arbitrage between exchanges and Thorchain MCCN using various assets as a base. This arbitrage solution is not ready for public use without understanding the code first. It can serve as a basis for those developing arbitrage bots.
Donation: if this repo ended up helping you, feel free to donate:
- THOR.RUNE: thor1uk7gnypj43z83m4uu94qn7vcwmj2estse0j2wk
Use the fetch_openapi.py script to download the latest OpenAPI YAML files from GitLab:
# Download Thornode OpenAPI spec
python script/fetch_openapi.py thornode
# Download Midgard OpenAPI spec
python script/fetch_openapi.py midgard
# Or download both at once
python script/fetch_openapi.py bothThe Thornode OpenAPI spec requires fixes before it can be used to generate a client:
# Fix HTTP response codes in the YAML file
python script/fix_thornode_yaml_response.py script/thornode.yaml
# Fix schema references in the YAML file
python script/fix_thornode_yaml_schema_refs.py script/thornode.yamlInstall the OpenAPI Python Client generator:
pip install openapi-python-clientGenerate client code:
# Generate Thornode client
openapi-python-client generate --path script/thornode.yaml
# Generate Midgard client
openapi-python-client generate --path script/midgard.yamlInstall the generated clients:
pip install -e thornode-api-client/
pip install -e midgard-public-api-client/Once the clients are installed, you can test them using the pool viewer script:
python script/pool_viewer.pyThis script demonstrates how to retrieve pool information from THORChain using the API clients.
pip install mnemonicmkdir secret/python utils/thorchain_mnemonic.pyls secret/ returns real_mnemonic
xchainpy_binance module has problem with 12 words mnemonic, using 24 words for now.
python words = Mnemonic(language).generate(strength=256)
pip install xchainpy_ethereum xchainpy_bitcoin xchainpy_bitcoincash xchainpy_binance xchainpy_litecoin xchainpy_thorchain xchainpy_utilmake sure you have some bnb to broadcast msg
pacman -S libsecp256k1you need to compile libsecp256k1 from source, then
CFLAGS="-Wno-error=implicit-function-declaration" pip install secp256k1to install numpy:
pip install Cython
git clone https://github.com/numpy/numpy.git
cd numpy
pip install . --no-binary :all: --no-use-pep517pip install pyotp
pip install ccxtI am using MongoDb as a backend for storing transactions happened on thorchain that needs to be handled by cex module, you can use your personal favourite database or just execute the orders inmediately.
pip install pymongo dnspythonin account.py you can specify the location of your phrase:
MNEMONICFILE = "secret/real_mnemonic"python tests/test_account.py2021-05-11 15:20:03,571 - DEBUG - thornode : Initial seeds: ['54.217.4.198', '34.214.69.203'] (oracle.py:107)
2021-05-11 15:20:04,196 - INFO - thornode : probing 52.32.91.52 (oracle.py:128)
2021-05-11 15:20:04,575 - INFO - thornode : probing 54.158.161.189 (oracle.py:128)
2021-05-11 15:20:04,831 - INFO - thornode : probing 13.58.177.135 (oracle.py:128)
2021-05-11 15:20:05,116 - INFO - thornode : probing 134.209.137.123 (oracle.py:128)
2021-05-11 15:20:05,209 - INFO - thornode : probing 18.188.225.254 (oracle.py:128)
2021-05-11 15:20:05,493 - INFO - thornode : probing 54.217.4.198 (oracle.py:128)
2021-05-11 15:20:05,586 - INFO - thornode : probing 34.214.69.203 (oracle.py:128)
2021-05-11 15:20:05,985 - INFO - thornode : probing 157.90.34.75 (oracle.py:128)
2021-05-11 15:20:06,073 - DEBUG - thornode : Network: https://seed.thorchain.info/ Seeds collected: ['52.32.91.52', '54.158.161.189', '13.58.177.135', '134.209.137.123', '18.188.225.254', '54.217.4.198', '34.214.69.203', '157.90.34.75'] (oracle.py:72)
2021-05-11 15:20:06,974 - INFO - thornode : Oracle Module On (oracle.py:77)
2021-05-11 15:20:08,683 - INFO - account : BTC asset: BTC.BTC amount:0.0 address: bc1q55mqk9z7gtj7u6hfptqmp7qrscrljest7pqjq5 (account.py:55)
2021-05-11 15:20:08,818 - INFO - account : ETH balance :0 address: 0xceC1Fec03F320531234321360302456105b6d9E3 (account.py:63)
2021-05-11 15:20:09,131 - INFO - account : LTC asset: LTC.LTC amount:0.0 address: ltc1qh8mhk2hpsr8n95mycqajwjw2gwmuqwwf44k8za (account.py:69)
2021-05-11 15:20:09,438 - INFO - account : BNB DEX: no balance (account.py:79)
2021-05-11 15:20:09,438 - INFO - account : address: bnb18hy3ar2gcyekdvq7r3ryk0nwuca7pxz7zlxuex (account.py:80)
you can see the api_client module probing different ip to get consensus
in main.py you can find
profile_1 = {'network': 'MCCN', 'unit_asset':'BNB.BUSD-BD1', 'trading_asset':['BCH.BCH'], 'cex_oracle': ftx, 'diff':4}
- network: MCCN to arb on multichain-chaosnet
- unit_asset: base asset of all trades, you increase in this asset
- trading_asset: what pairs are you gonna use
- cex_oracle: which cex are you using
- diff: difference in output amount to execute trade
in main.py you can find
thor = THORTrader(network=network, host=["134.209.137.123", "54.217.4.198"])
you can use https://thorchain.network/ to find a series of host that you trust, and pass them in a list. if you choose to ignore the parameter host, the default is to:
- probe num_seeding number of random nodes, ensure they return same list of active-nodes
- probe num_seeding number of random active nodes, ensure they return same pool depth for all pools
- this probing process keeps on going, you can specify the time in cache_time
all above variables can be modifed in
oracle.py
in root directory
pip install pytest pytest-asyncio
pytest midgard_client/test/
pytest thornode_client/test/