Crypto exchanges API/WSS wrapper with grpc powered server
Binance, Bitfinex, Huobi, OKX, Bybit,
For SPOT markets
On Binance: now API key type Ed25519 is used instead of HMAC
From 2.1.34 must be updated exch_srv_cfg.toml from exchanges_wrapper/exch_srv_cfg.toml.template
exchanges-wrapper vs binance.py
The main difference is the development of the project for trading with many exchanges.
Next is adding a new module exchanges_wrapper/exch_srv.py as a multiplexer layer, providing simultaneous async interaction for many accounts
and many trading pairs through one connection. It's powered by gRPC
Remote Procedure Call framework.
Warning. Coverage of overridden binance.py packages is significant but not complete.
Served methods describes into example/exch_client.py
Initial capabilities (inherited from binance.py)
- Covers general endpoints (test connectivity and get exchange information's)
- Covers market data endpoints
- Covers Account endpoints (create and manage orders)
- Covers user data stream (receive real time user updates)
- Covers web socket streams (receive real time market updates)
- Async support
- Auto reconnect after exchanges API or network failure
- Completely free and without limitations
Added Features
- Multi exchanges support
- Adaptive algorithm to ensure maximum performance and avoid exceeding the rates limits
- Passthrough logging
- WSS keepalive
- Reuse session for new client connections
- Utilizing Websocket API (bidirectional) for the most commonly used methods:
Extra exchanges implementation features
- Binance REST API and WSS are accepted as basic, connection of other exchanges wrapped their API to Binance compatible
- For other, some data cannot be obtained by directly calling one method, it is generated by a synthetic or calculation method
- Some exchanges have not any testing or "paper trading" features, therefore, application development and testing is possible only at real bidding. First, run applications on the Binance Spot Test Network or (Bitfinex, OKX, Bybit) test account.
Get started
Prepare exchange account
Create account on Binance and get 10% discount on all trading fee
Create account on HTX
Create account on Bitfinex and get 6% rebate fee
Create account on OKX and will be in for the chance to earn up to 100 USDT
Create account on Bybit and get exclusive referral rewards
Also, you can start strategy on Hetzner cloud VPS only for 4.75 € per month
- For test purpose log in at Binance Spot Test Network
- Create API Key
- After install and create environment specify api_key and api_secret in
/home/ubuntu/.MartinBinance/config/exch_srv_cfg.toml
Install use PIP
To install just run the following command:
pip install exchanges-wrapper
After first install create environment by run exchanges-wrapper-init in terminal window.
The structure of the working directory will be created and the necessary files will be copied:
For Ubuntu it will be here: home/user/.MartinBinance/
For upgrade to latest versions use:
pip install -U exchanges-wrapper
Start server
- Run in terminal window
exchanges-wrapper-init
and
exchanges-wrapper-srv
- Use an example to study
- Copy example/ms_cfg.toml
to
/home/ubuntu/.MartinBinance/config/and select (uncomment) desired exchange. Don't change exchange name. - Run example/exch_client.py in other terminal window
- Copy example/ms_cfg.toml
to
Use Docker image
docker pull ghcr.io/dogstailfarmer/exchanges-wrapper:latest
First run
The structure of the working directory will be created and the necessary files will be copied:
For Ubuntu it will be here: home/user/.MartinBinance/
docker run --rm --entrypoint /bin/sh exchanges-wrapper -c "cat ./exchanges_wrapper/__init__.py" > init.py && \
docker run --rm --entrypoint /bin/sh exchanges-wrapper -c "cat ./exchanges_wrapper/exch_srv_cfg.toml.template" > exch_srv_cfg.toml.template &&\
python3 init.py && rm init.py && rm exch_srv_cfg.toml.template
Start server
docker run -itP \
--mount type=bind,source=/home/ubuntu/.MartinBinance,target=/home/appuser/.MartinBinance \
--network=host \
--restart=always \
--name=exchanges-wrapper \
exchanges-wrapper
Documentations
- Served methods and examples of their use are described at
example/exch_client.py - For Protocol Buffers serializing structured data see
exchanges_wrapper/proto/martin.proto
Donate
USDT (TRC20) TN8F3Dz8BU8VwECRh3LTKi7FrsU8eWfsZz
Powered by exchanges-wrapper
Free trading system for crypto exchanges SPOT markets. Adaptive customizable reverse grid strategy based on martingale.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file exchanges_wrapper-2.1.51.tar.gz.
File metadata
- Download URL: exchanges_wrapper-2.1.51.tar.gz
- Upload date:
- Size: 59.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.9.25
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6df06aef8143412f66fa8f4c61ee16af55cdcb4763d73dcfeea1912c620126e5
|
|
| MD5 |
6cb98fc60d1bdb2f3e82de28d1974f3d
|
|
| BLAKE2b-256 |
08810f74ef0528ef1f58a2c0b1c85f508b7073d496d8cc1c78a1ac57f39a5630
|
File details
Details for the file exchanges_wrapper-2.1.51-py3-none-any.whl.
File metadata
- Download URL: exchanges_wrapper-2.1.51-py3-none-any.whl
- Upload date:
- Size: 66.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.9.25
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
af1e21dae86fa9143d08f68896017b1c3c836dae16b66774d6ec614c559728ae
|
|
| MD5 |
5c45e53ad2c968eb9c8f2d3cf5922bc3
|
|
| BLAKE2b-256 |
dd14108dcef85ceeb2421358ea9952171185b7b76e9e5025048ec0850460f382
|
