bitvavo-api-upgraded 1.17.2__py3-none-any.whl → 2.2.0__py3-none-any.whl

bitvavo_api_upgraded-2.2.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+bitvavo_api_upgraded/__init__.py,sha256=27f1dd18199939f6f578ec9d6b1b0f9977ce219e7c8556b5a807c4e9012b507b,301
+bitvavo_api_upgraded/bitvavo.py,sha256=b2b8b1cc2c98c4f47eacdbf93cd1ee0d36291c8df68d152c1feb3712b06b49df,164775
+bitvavo_api_upgraded/dataframe_utils.py,sha256=25ffb6ce462e2b966cf6488c14994298ef8eca48d9c8522f5b669a30960f529a,5792
+bitvavo_api_upgraded/helper_funcs.py,sha256=e2805d435c41f82d979104e637eade7f323359f3be214a300d25a139215d0915,3212
+bitvavo_api_upgraded/py.typed,sha256=e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855,0
+bitvavo_api_upgraded/settings.py,sha256=6ebd68a8ddcaf0ea229a629ad4996fccc82960d1dfaf690ad9fd78b42ef6765f,5311
+bitvavo_api_upgraded/type_aliases.py,sha256=10e7772e1aeec8cd5a6589f8c7229885da12aa5f26647f3c69c374a86ccc31c9,1992
+bitvavo_api_upgraded-2.2.0.dist-info/WHEEL,sha256=76443c98c0efcfdd1191eac5fa1d8223dba1c474dbd47676674a255e7ca48770,79
+bitvavo_api_upgraded-2.2.0.dist-info/METADATA,sha256=900cbf71d10dc4813bc0e1e9d169ba7a0059e1839e05db8821a98770f691cc8c,25478
+bitvavo_api_upgraded-2.2.0.dist-info/RECORD,,

bitvavo_api_upgraded-2.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.8.12
+Root-Is-Purelib: true
+Tag: py3-none-any

bitvavo_api_upgraded-1.17.2.dist-info/METADATA

@@ -1,320 +0,0 @@
-Metadata-Version: 2.4
-Name: bitvavo-api-upgraded
-Version: 1.17.2
-Summary: A unit-tested fork of the Bitvavo API
-Project-URL: homepage, https://github.com/Thaumatorium/bitvavo-api-upgraded
-Project-URL: repository, https://github.com/Thaumatorium/bitvavo-api-upgraded
-Project-URL: changelog, https://github.com/Thaumatorium/bitvavo-api-upgraded/blob/master/CHANGELOG.md
-Author: Bitvavo BV (original code)
-Author-email: NostraDavid <55331731+NostraDavid@users.noreply.github.com>
-Maintainer-email: NostraDavid <55331731+NostraDavid@users.noreply.github.com>
-License: ISC License
-License-File: LICENSE.txt
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Environment :: Console
-Classifier: Framework :: Pytest
-Classifier: Framework :: tox
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: Financial and Insurance Industry
-Classifier: License :: OSI Approved :: ISC License (ISCL)
-Classifier: Operating System :: MacOS :: MacOS X
-Classifier: Operating System :: Microsoft :: Windows
-Classifier: Operating System :: POSIX
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Typing :: Typed
-Requires-Python: >=3.9
-Requires-Dist: pydantic-settings==2.*,>=2.6
-Requires-Dist: requests==2.*,>=2.26
-Requires-Dist: structlog==25.*,>=21.5
-Requires-Dist: websocket-client==1.*,>=1.2
-Description-Content-Type: text/markdown
-
-# Bitvavo API (upgraded)
-
-## Userguide
-
-`pip install bitvavo_api_upgraded`
-
-Works the same as the official API lib, but I have:
-
-- typing for _all_ functions and classes
-- unit tests (I already found three 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](https://endoflife.date/python))
-
-## Devguide
-
-```shell
-echo "install development requirements"
-uv sync
-echo "run tox, a program that creates separate environments for different python versions, for testing purposes (among other things)"
-uv run tox
-```
-
-### Semantic Versioning (SemVer)
-
-I'm using semantic versioning, which means that changes mean this:
-
-1. MAJOR version when you make incompatible API changes,
-1. MINOR version when you add functionality in a backwards compatible manner,
-   and
-1. PATCH version when you make backwards compatible bug fixes.
-
-### Versioning
-
-Copy the following block to CHANGELOG.md and add all information since last
-version bump
-
-```markdown
-## $UNRELEASED
-
-### Added
-
-...
-
-### Changed
-
-...
-
-### Removed
-
-...
-```
-
-Commit those changes.
-
-After that, run `bump-my-version bump (major|minor|patch)` to automatically
-replace `$UNRELEASED` with the new version number, and also automatically tag
-and commit (with tag) to release a new version via the Github workflow.
-
-## py.typed
-
-Perhaps a curious file, but it simply exists to let `mypy` know that the code is
-typed: [Don't forget `py.typed` for your typed Python package
-](https://blog.whtsky.me/tech/2021/dont-forget-py.typed-for-your-typed-python-package/)
-
-## Last note
-
-_below this line is the old README.md_
-
----
-
-# Bitvavo SDK for Python
-
-Crypto starts with Bitvavo. You use Bitvavo SDK for Python to buy, sell, and
-store over 200 digital assets on Bitvavo from inside your app.
-
-To trade and execute your advanced trading strategies, Bitvavo SDK for Python is
-a wrapper that enables you to easily call every endpoint in [Bitvavo
-API](https://docs.bitvavo.com/).
-
-- [Prerequisites](#prerequisites) - what you need to start developing with
-  Bitvavo SDK for Python
-- [Get started](#get-started) - rapidly create an app and start trading with
-  Bitvavo
-- [About the SDK](#about-the-sdk) - general information about Bitvavo SDK for
-  Python
-- [API reference](https://docs.bitvavo.com/) - information on the specifics of
-  every parameter
-
-This page shows you how to use Bitvavo SDK for Python with WebSockets. For REST,
-see the [REST readme](docs/rest.md).
-
-## Prerequisites
-
-To start programming with Bitvavo SDK for Python you need:
-
-- [Python3](https://www.python.org/downloads/) installed on your development
-  environment
-
-  If you are working on macOS, ensure that you have installed SSH certificates:
-
-  ```terminal
-  open /Applications/Python\ 3.12/Install\ Certificates.command
-  open /Applications/Python\ 3.12/Update\ Shell\ Profile.command
-  ```
-
-- A Python app. Use your favorite IDE, or run from the command line
-- An [API key and
-  secret](https://support.bitvavo.com/hc/en-us/articles/4405059841809)
-  associated with your Bitvavo account
-
-  You control the actions your app can do using the rights you assign to the API
-  key. Possible rights are:
-
-  - **View**: retrieve information about your balance, account, deposit and
-    withdrawals
-  - **Trade**: place, update, view and cancel orders
-  - **Withdraw**: withdraw funds
-
-    Best practice is to not grant this privilege, withdrawals using the API do
-    not require 2FA and e-mail confirmation.
-
-## Get started
-
-Want to quickly make a trading app? Here you go:
-
-1. **Install Bitvavo SDK for Python**
-
-    In your Python app, add [Bitvavo SDK for
-    Python](https://github.com/bitvavo/python-bitvavo-api) from
-    [pypi.org](https://pypi.org/project/python-bitvavo-api/):
-
-    ```shell
-    python -m pip install python_bitvavo_api
-    ```
-
-    If you installed from `test.pypi.com`, update the requests library: `pip
-    install --upgrade  requests`.
-
-1. **Create a simple Bitvavo implementation**
-
-    Add the following code to a new file in your app:
-
-    ```python
-    from python_bitvavo_api.bitvavo import Bitvavo
-    import json
-    import time
-
-    # Use this class to connect to Bitvavo and make your first calls.
-    # Add trading strategies to implement your business logic.
-    class BitvavoImplementation:
-        api_key = "<Replace with your your API key from Bitvavo Dashboard>"
-        api_secret = "<Replace with your API secret from Bitvavo Dashboard>"
-        bitvavo_engine = None
-        bitvavo_socket = None
-
-        # Connect securely to Bitvavo, create the WebSocket and error callbacks.
-        def __init__(self):
-            self.bitvavo_engine = Bitvavo({
-                'APIKEY': self.api_key,
-                'APISECRET': self.api_secret
-            })
-            self.bitvavo_socket = self.bitvavo_engine.newWebsocket()
-            self.bitvavo_socket.setErrorCallback(self.error_callback)
-
-        # Handle errors.
-        def error_callback(self, error):
-            print("Add your error message.")
-            #print("Errors:", json.dumps(error, indent=2))
-
-        # Retrieve the data you need from Bitvavo in order to implement your
-        # trading logic. Use multiple workflows to return data to your
-        # callbacks.
-        def a_trading_strategy(self):
-            self.bitvavo_socket.ticker24h({}, self.a_trading_strategy_callback)
-
-        # In your app you analyse data returned by the trading strategy, then make
-        # calls to Bitvavo to respond to market conditions.
-        def a_trading_strategy_callback(self, response):
-            # Iterate through the markets
-            for market in response:
-
-                match market["market"]:
-                   case "ZRX-EUR":
-                        print("Eureka, the latest bid for ZRX-EUR is: ", market["bid"] )
-                        # Implement calculations for your trading logic.
-                        # If they are positive, place an order: For example:
-                        # self.bitvavo_socket.placeOrder("ZRX-EUR",
-                        #                               'buy',
-                        #                               'limit',
-                        #                               { 'amount': '1', 'price': '00001' },
-                        #                               self.order_placed_callback)
-                   case "a different market":
-                        print("do something else")
-                   case _:
-                        print("Not this one: ", market["market"])
-
-
-
-        def order_placed_callback(self, response):
-            # The order return parameters explain the quote and the fees for this trade.
-            print("Order placed:", json.dumps(response, indent=2))
-            # Add your business logic.
-
-
-        # Sockets are fast, but asynchronous. Keep the socket open while you are
-        # trading.
-        def wait_and_close(self):
-            # Bitvavo uses a weight based rate limiting system. Your app is limited to 1000 weight points per IP or
-            # API key per minute. The rate weighting for each endpoint is supplied in Bitvavo API documentation.
-            # This call returns the amount of points left. If you make more requests than permitted by the weight limit,
-            # your IP or API key is banned.
-            limit = self.bitvavo_engine.getRemainingLimit()
-            try:
-                while (limit > 0):
-                    time.sleep(0.5)
-                    limit = self.bitvavo_engine.getRemainingLimit()
-            except KeyboardInterrupt:
-                self.bitvavo_socket.closeSocket()
-
-
-    # Shall I re-explain main? Naaaaaaaaaa.
-    if __name__ == '__main__':
-        bvavo = BitvavoImplementation()
-        bvavo.a_trading_strategy()
-        bvavo.wait_and_close()
-    ```
-
-1. **Add security information**
-
-   You must supply your security information to trade on Bitvavo and see your
-   account information using the authenticate methods. Replace the values of
-   `api_key` and `api_secret` with your credentials from [Bitvavo
-   Dashboard](https://account.bitvavo.com/user/api).
-
-   You can retrieve public information such as available markets, assets and
-   current market without supplying your key and secret. However,
-   unauthenticated calls have lower rate limits based on your IP address, and
-   your account is blocked for longer if you exceed your limit.
-
-1. **Run your app**
-
-    - Command line warriors: `python3 <filename>`.
-    - IDE heroes: press the big green button.
-
-Your app connects to Bitvavo and returns a list the latest trade price for each
-market. You use this data to implement your trading logic.
-
-## About the SDK
-
-This section explains global concepts about Bitvavo SDK for Python.
-
-### Rate limit
-
-Bitvavo uses a weight based rate limiting system. Your app is limited to 1000
-weight points per IP or API key per minute. When you make a call to Bitvavo API,
-your remaining weight points are returned in the header of each REST request.
-
-Websocket methods do not return your returning weight points, you track your
-remaining weight points with a call to:
-
-```python
-limit = bitvavo.getRemainingLimit()
-```
-
-If you make more requests than permitted by the weight limit, your IP or API key
-is banned.
-
-The rate weighting for each endpoint is supplied in the [Bitvavo API
-documentation](https://docs.bitvavo.com/).
-
-### Requests
-
-For all methods, required parameters are passed as separate values, optional
-parameters are passed as a dictionary. Return parameters are in dictionary
-format: `response['<key>'] = '<value>'`. However, as a limit order requires more
-information than a market order, some optional parameters are required when you
-place an order.
-
-### Security
-
-You must set your API key and secret for authenticated endpoints, public
-endpoints do not require authentication.

bitvavo_api_upgraded-1.17.2.dist-info/RECORD

@@ -1,10 +0,0 @@
-bitvavo_api_upgraded/__init__.py,sha256=CSK4JninN6nxMUqoT-S_Vl9UJc4NOqwfbbZf-Qnvpo4,222
-bitvavo_api_upgraded/bitvavo.py,sha256=s7l-cAl0FteBrm5iF-gnM_U9_-Yds9lpn5pN6f0oaZU,125981
-bitvavo_api_upgraded/helper_funcs.py,sha256=4oBdQ1xB-C2XkQTmN-refzIzWfO-IUowDSWhOSFdCRU,3212
-bitvavo_api_upgraded/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-bitvavo_api_upgraded/settings.py,sha256=ZH2sR9iUyOC_lSaqmT50wERngUuobvu8d0TLiYN5nTg,2266
-bitvavo_api_upgraded/type_aliases.py,sha256=NAnMSk5n6SaEIvHFeSMKnXOxfOwnbFuEnRKaAXlcmYw,932
-bitvavo_api_upgraded-1.17.2.dist-info/METADATA,sha256=U_5w2WGTB4xykCwIgh3KtcfsVzsYDS3NZWlHwVRz1Tk,11547
-bitvavo_api_upgraded-1.17.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-bitvavo_api_upgraded-1.17.2.dist-info/licenses/LICENSE.txt,sha256=hiFyor_njVlzVblnb-78mzx1Um3CGvuFxEH3YR735rc,744
-bitvavo_api_upgraded-1.17.2.dist-info/RECORD,,

bitvavo_api_upgraded-1.17.2.dist-info/WHEEL

@@ -1,4 +0,0 @@
-Wheel-Version: 1.0
-Generator: hatchling 1.27.0
-Root-Is-Purelib: true
-Tag: py3-none-any

bitvavo_api_upgraded-1.17.2.dist-info/licenses/LICENSE.txt

@@ -1,15 +0,0 @@
-ISC License
-
-Copyright (c) 2024, Bitvavo B.V.
-
-Permission to use, copy, modify, and/or distribute this software for any
-purpose with or without fee is hereby granted, provided that the above
-copyright notice and this permission notice appear in all copies.
-
-THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
-WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
-MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
-WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
-ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
-OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.