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.14.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 91320d241490e32a76c76d7e8328f7da9f460a918cf611bebcbc44413d824ef2 |
|
MD5 | a8a90ca2323d9defd0248def439774a6 |
|
BLAKE2b-256 | 3b80185e0bad11c6002a2d67256a6c06d8f55977175e74478da35411b8e34377 |
Hashes for bitvavo_api_upgraded-1.14.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a27e90c2deb63dfe3edae604e5062223f80042aacddc7bcf9e6a9b1696767620 |
|
MD5 | 53d511e59ce2444973d3ed6c248adcf1 |
|
BLAKE2b-256 | 3923e2fbc881feecf6692816c93f8442aa62e42a9fc0665c44b52d61953e6331 |