madeddie / python-bunq

Thin wrapper around the bunq API

DEPRECATED

This module hasn’t been maintained nor used by me for some time. Security warnings have started popping up.

Use only as inspiration or starting point for your own projects.

bunq

Python wrapper for the bunq API.

Installation

This package has been tested with Python 3.6.0, but probably works fine with 3.3 and later. Python 2.6 and later should also work, but no guarantees.

To install, use setuptools, run:

python ./setup.py install

or for installing locally for the user:

python ./setup.py install --user

There is no PyPI package as of yet.

Usage

The module is a thin wrapper around the bunq API and takes care of the following:

• setting the required HTTP headers
• signing of the outgoing message
• verification of the response (still very limited)

The code is blissfully unaware of the API endpoints and the data they need and return. You will need the bunq API documentation to figure out all the endpoints and required parameters and possible responses.

After installation this module is called simply bunq. You will probably want to import it like:

from bunq import API

and instantiate and API object like so:

my_api_instance = API(private_key, token)

There are several examples in the examples directory to give you an idea how this module can be used.

Documentation

The code itself is documented with docstrings.

External documentation will be coming ASAP.

TODO

• tests
• better verification of response
• automated session creation
• use a more lightweight crypto library, like https://github.com/sybrenstuvel/python-rsa
• active session awareness
• testing validity of token
• deal with rsa key encryption
• automagically retrieve server public key when not given

Attribution

All code is licensed under the MIT License. See LICENSE.

python3-krakenex was a big inspiration.