BBVA

Ruby gem with command line tool for retrieving BBVA bank accounts balance and transactions.

It uses the same API that the offical BBVA mobile app uses. Requieres the same user and password that are used for accessing http://bbva.es

Important note

The code in this gem is being ported to bank_scrap, a new more ambitious gem that will support multiple banks, including BBVA. The port in bank_scrap uses the new API from the latest version of BBVA's mobile app. This gem won't be mantained any longer.

Motivation

I wrote this gem to cover my own needs. The BBVA web app is painful to use and there is no public API. However their Android mobile app is quite great. I thought the mobile app should be using some kind of API, so after some research I figured out how to use that exact same API from a Ruby client.

Installation

$ git clone https://github.com/javiercr/bbva.git
$ cd bbva
$ bundle
$ rake install

Usage from terminal

Retrieve balance account

$ bbva balance --user YOUR_BBVA_USER --password YOUR_BBVA_PASSWORD

Retrieve transactions for the last 24 months (maximum allowed by the API) and export them to CSV and YAML (in the working directory)

$ bbva transactions --user YOUR_BBVA_USER --password YOUR_BBVA_PASSWORD

Retrieve transactions for the last 5 days (including today) and export them to CSV and YAML (in the working directory)

$ bbva transactions --user YOUR_BBVA_USER --password YOUR_BBVA_PASSWORD --days 5

If you don't want to pass your user and password everytime you can define them in your .bash_profile

export BBVA_USER=YOUR_BBVA_USER
export BBVA_PASSWORD=YOUR_BBVA_USER

Usage from Ruby

You can also use this gem from your own app as library. To do so first you must initialize a BBVA::API object

require 'bbva'
@api = BBVA::API.new(YOUR_BBVA_USER, YOUR_BBVA_PASSWORD)

Now you can fetch your balance:

@api.get_balance

Or your transactions (you must pass the range of dates)

@api.get_transactions(start_date: (Date.today - 24.months), end_date: Date.today)

Debugging

If you are finding troubles you can enable the debug mode to get some detailed output.

If you are using the command line tool:

$ bbva transactions --user YOUR_BBVA_USER --password YOUR_BBVA_PASSWORD --debug

If you are using the Ruby API:

@api = BBVA::API.new(YOUR_BBVA_USER, YOUR_BBVA_PASSWORD, debug: true)

Contributing

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request