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.3.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6757942bae128abf89e6cd0320c65b882b23267b8e453b2a2a4f9ce2992f1c72 |
|
MD5 | 297a9712c3eb539a9f4f55e19463dbfd |
|
BLAKE2b-256 | ac882b7aea979af3b045eed46479065855957d204436dd2570fc6165046e5503 |
Hashes for bitvavo_api_upgraded-1.15.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1844c721931391690681d91248855fd77901342ce7f45756dc065755c89e9950 |
|
MD5 | cd002997bd51824cb83837eb26f9548a |
|
BLAKE2b-256 | ee3394ff71f96c7691fca8c870520ed1d11a303b228bf70f03c575bc11b6effe |