Skip to main content

Beta Open Bank Project Python Utilities

Project description

Open Bank Project CLI

A command line utility (CLI) to work with the Open Bank Project sandbox called obp.

With the obp cli you can:

  • Initiate an api connection to the sandbox
    • note you still need to sign-up from the sandbox homepage first to create your username & password
  • Get your DirectLogin token
  • Get your user information
  • Get your user id
  • Get banks
  • Get (your) accounts held at the bank

Also, depending on your account access you may:

  • Create a bank account
  • Add roles to a user
  • Import/Delete branches
  • Import dummy bank data


pip install --user obp-python # Requires at least python 3

Warning: If your operating system defaults to python 2, your pip command might be:

pip3 install --user obp-python
pip3.6 install --user obp-python


Usage: obp [OPTIONS] COMMAND [ARGS]...

  --help  Show this message and exit.

  addaccount          ๐Ÿ“ Add a bank account
  addrole             ๐Ÿšง Add a role for current user
  adduser             ๐Ÿ“ Add a user
  deletebranches      โš ๏ธ ๐Ÿฆ Delete all branches
  getaccountbyid      ๐Ÿ“ Get account by id (includes balance)
  getaccountsheld     ๐Ÿ“ Get list of accounts held
  getauth             ๐Ÿ”‘ Get your DirectLogin token
  getbanks            ๐Ÿฆ Get list of banks
  getuser             ๐Ÿ˜ƒ Get your user info
  getuserid           ๐Ÿ“‹ Get your user id
  importaccounts      ๐Ÿšœ Import accounts from spreadsheet template
  importbranches      ๐Ÿšœ Import branches from spreadsheet template
  importcustomers     ๐Ÿšœ Import customers from spreadsheet template
  importtransactions  ๐Ÿšœ Import transactions from spreadsheet template
  importusers         ๐Ÿšœ Import users from spreadsheet template
  init                ๐Ÿ’ก Initalize connection to your Open Bank Project...
  sandboximport       ๐Ÿšœ Bulk import sandbox data from json input


You must initalize the obp cli once, by doing:

obp init

Generate Direct Login Token

obp init 
Please enter your API_HOST:
Please enter your username:
Please enter your password: : 
Repeat for confirmation: 
... generating direct login token
Please enter your OBP_CONSUMER_KEY: # Go to, then "Get API Key" to generate consumer key.
obp getauth # Displays your DirectLogin token


Note You can ignore this is your just using the utlity. This is just for developing the utlity.

To work on this utility as a developer:

# Setup python3 environment
virtualenv -p python3 venv
. venv/bin/activate
git clone <this-repo>
# Building wheels etc
python sdist bdist_wheel
# Installing your edits locally:
pip install -e <path-to-this-repo> # -e means Install  a  project  in editable mode (i.e.  setuptools "developmode")
# Work on utility..submit pull request 

Update history
  • 0.19 Added sandboximport utility obp sandboximport --example
  • 0.0.9 Switch to use OBP_API_HOST instead of OBP_ENDPOINT

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
obp_python-0.198-py3-none-any.whl (46.7 kB) Copy SHA256 hash SHA256 Wheel py3
obp_python-0.198.tar.gz (23.5 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page