A unit-tested fork of the Bitvavo API
Project description
Bitvavo API (upgraded)
Hi, this is not the official API, but this one has:
- build-in documentation
- typing for all functions and classes
- unit tests (I already found
threefourfivesix bugs that I fixed, because the original code wasn't tested, at all) - a changelog, so you can track of the changes that I make
- compatible with Python 3.7 and newer (3.6 isn't supported as of 2021-12-23)
- a working version of
getRemainingLimit()
- will actually wait until the ban has been lifted (in case you get banned)
- more stable api-calls, due to calculating lag between client and server
- fancy logging via
structlog
, including external loggers like from the urllib3 and websocket libs! - a working
ACCESSWINDOW
variable that actually times the api calls out - makes failing Bitvavo API calls fail faster!
Version 1.*
is guaranteed compatible* with the original API.
*: Except for Bitvavo.candles
. I had to renamed the symbol
argument to market
, because the candles
call actually excpects a market
. So that's more of a bugfix.
**: Same goes for Bitvavo.book
; it had the same problem as candles
.
***: And I removed the rateLimitThread
class, but that should've been used internally only anyway
Customizable settings
Through the magic of the python-decouple lib, when you use this lib, you can create a settings.ini
(Windows example) or a .env
(Linux example) and add some handy settings there.
Here is an example list of the settings for this lib:
BITVAVO_API_UPGRADED_LOG_LEVEL=INFO # Set the lib's log level
BITVAVO_API_UPGRADED_LOG_EXTERNAL_LEVEL=WARNING # Set the libs that are used by *this* lib's log level
BITVAVO_API_UPGRADED_LAG=50 # the time difference between the server and your local time (you'll have to calculate this yourself - tip: use the bitvavo.time() functionality in a separate script)
BITVAVO_API_UPGRADED_RATE_LIMITING_BUFFER=25 # default 25, set to 50 if you get "you have been banned" messages (or even higher, if needed)
Links
- Official API Documentation
- Official Trading Rules (recommended read, as it explains a lot of jargon; It's OK to not understand this document if you're just starting out - I don't fully understand the document either)
- Github for this lib
Project details
Release history Release notifications | RSS feed
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
Hashes for bitvavo-api-upgraded-1.15.7.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 33770a801b640681a93065644b85e0b00259c63c3ee5ee3bd50481ebbd314286 |
|
MD5 | 235e5b575dc970935f7d31313b018cda |
|
BLAKE2b-256 | 87b69ece20d195f8eedada6716617b12d72431af17a1693c5b0be87b9cc2059b |
Hashes for bitvavo_api_upgraded-1.15.7-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 62153e9aa6e54e54678a65ebbc1862a4a08c4d5d3eca63737699c843b44d5612 |
|
MD5 | f66041e08d912999f534a75f201cf9d5 |
|
BLAKE2b-256 | ffa1f4d4f4f82b69a580be174ad3aa294b80e17b3171a86a260ae45eebf037f1 |