Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tducret/revolut-python
Non-official client for the Revolut Bank
https://github.com/tducret/revolut-python
python3 revolut revolut-api
Last synced: about 2 months ago
JSON representation
Non-official client for the Revolut Bank
- Host: GitHub
- URL: https://github.com/tducret/revolut-python
- Owner: tducret
- License: mit
- Archived: true
- Created: 2018-07-06T23:02:32.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2020-12-17T08:14:11.000Z (about 4 years ago)
- Last Synced: 2024-04-29T20:48:23.066Z (8 months ago)
- Topics: python3, revolut, revolut-api
- Language: Python
- Size: 95.7 KB
- Stars: 102
- Watchers: 20
- Forks: 25
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# revolut-python
[](https://travis-ci.org/tducret/revolut-python)
[](https://coveralls.io/github/tducret/revolut-python)
[](https://pypi.org/project/revolut/)
# Description
Non-official client for the [Revolut Bank](https://www.revolut.com/)
I wrote a French blog post about it [here](https://www.tducret.com/scraping/2018/08/17/un-robot-d-achat-et-de-vente-de-bitcoins-developpe-en-python.html)
# Requirements
- Python 3
- pip3
# Installation
```bash
pip3 install -U revolut
```
## CLI tool : revolut_cli.py
```bash
Usage: revolut_cli.py [OPTIONS]
Get the account balances on Revolut
Options:
-d, --device-id TEXT your Revolut token (or set the env var
REVOLUT_DEVICE_ID)
-t, --token TEXT your Revolut token (or set the env var REVOLUT_TOKEN)
-l, --language TEXT language ("fr" or "en"), for the csv header and
separator
-a, --account TEXT account name (ex : "EUR CURRENT") to get the balance
for the account
--version Show the version and exit.
--help Show this message and exit
```
Example output :
```csv
Account name,Balance,Currency
EUR CURRENT,100.50,EUR
GBP CURRENT,20.00,GBP
USD CURRENT,0.00,USD
AUD CURRENT,0.00,AUD
BTC CURRENT,0.00123456,BTC
EUR SAVINGS (My vault),10.30,EUR
```
If you don't have a Revolut token yet, the tool will allow you to obtain one.
⚠️ **If you don't receive a SMS when trying to get a token, you need to logout from the app on your Smartphone.**
⚠️ **You may also receive an authentication email instead of a SMS. Take note of the link on the `Authenticate` button. It should look like `https://revolut.com/app/email-authenticate/?scope=login`. You can enter this code in the CLI.**
## Pulling transactions
```bash
Usage: revolut_transactions.py [OPTIONS]
Get the account balances on Revolut
Options:
-d, --device-id TEXT your Revolut token (or set the env var
REVOLUT_DEVICE_ID)
-t, --token TEXT your Revolut token (or set the env var
REVOLUT_TOKEN)
-l, --language [en|fr] language for the csv header and separator
-t, --from_date [%Y-%m-%d] transactions lookback date in YYYY-MM-DD
format (ex: "2019-10-26"). Default 30 days
back
-fmt, --output_format [csv|json]
output format
-r, --reverse reverse the order of the transactions
displayed
--help Show this message and exit.
```
Example output :
```csv
Date-time,Description,Amount,Currency
08/26/2019 21:31:00,Card Delivery Fee,-59.99,SEK
09/14/2019 12:50:07,donkey.bike **pending**,0.0,SEK
09/14/2019 13:03:15,Top-Up by *6458,200.0,SEK
09/30/2019 16:19:19,Reward user for the invite,200.0,SEK
10/12/2019 23:51:02,Tiptapp Reservation,-250.0,SEK
```
## TODO
- [ ] Document revolutbot.py
- [ ] Create a RaspberryPi Dockerfile for revolutbot (to check if rates grows very often)
- [ ] Improve coverage for revolutbot