python-monobank
Python client for Monobank API (https://api.monobank.ua/docs/)
Installation
pip install monobank
Usage
Personal api
-
Request your token at https://api.monobank.ua/
-
Use that token to initialize client:
import monobank
token = 'xxxxxxxxxxxxxxx'
mono = monobank.Client(token)
user_info = mono.get_client_info()
print(user_info)
Methods
Get currencies
>>> mono.get_currency()
[
{'currencyCodeA': 840,
'currencyCodeB': 980,
'date': 1561686005,
'rateBuy': 25.911,
'rateSell': 26.2357},
{'currencyCodeA': 978,
'currencyCodeB': 980,
'date': 1561686005,
'rateBuy': 29.111,
'rateSell': 29.7513},
...
Get client info
>>> mono.get_client_info()
{
'name': 'Dmitriy Dubilet'
'accounts': [
{
'id': 'accidxxxxx'
'balance': 100000000,
'cashbackType': 'UAH',
'creditLimit': 100000000,
'currencyCode': 980,
}
],
}
Get statements
>>> mono.get_statements('accidxxxxx', date(2019,1,1), date(2019,1,30))
[
{
'id': 'iZDPhf8v32Qass',
'amount': -127603,
'balance': 99872397,
'cashbackAmount': 2552,
'commissionRate': 0,
'currencyCode': 978,
'description': 'Smartass club',
'hold': True,
'mcc': 5411,
'operationAmount': 4289,
'time': 1561658263
},
...
]
You can as well pass datetime objects
>>> mono.get_statements('accidxxxxx', datetime(2019,1,1,11,15), datetime(2019,1,2,11,15))
Create a Webhook
>>> mono.create_webhook('https://myserver.com/hookpath')
Corporatre API
Documentation is here - https://api.monobank.ua/docs/corporate.html
Corporate API have the same methods as Public API, but it does not have rate limitation, and it is a recomended way if you are handling data for commercial use (or just storing lot of personal data).
Getting access
1) Generate private key
openssl ecparam -genkey -name secp256k1 -rand /dev/urandom -out priv.key
This will output file priv.key
Warning: do not share it with anyone, do not store it in public git repositories
2) Generate public key
openssl ec -in priv.key -pubout -out pub.key
This will output file pub.key
3) Request API access
Send an email to api@monobank.ua - describe your project, and attach pub.key (!!! NOT priv.key !!!)
Requesting permission from monobank user
Once your app got approved by Monobank team you can start using corporate API:
1) Create monobank user access request
private_key = '/path/to/your/priv.key'
request = monobank.access_request('ps', private_key)
If all fine you should recive the following:
print(request)
{'tokenRequestId': 'abcdefg_Wg', 'acceptUrl': 'https://mbnk.app/auth/abcdefg_Wg'}
You should save tokenRequestId to database, and then give user the link acceptUrl
Note: To be notified about user acceptance you can use web callback:
monobank.access_request('ps', private_key, callback_url='https://yourserver.com/callback/')
2) Check if user accepted
You can check if user accepted access request like this:
request_token = 'abcdefg_Wg' # the token from access_request result
private_key = '/path/to/your/priv.key'
mono = monobank.CorporateClient(request_token, private_key)
mono.check() # returns True if user accepted, False if not
3) Use methods
Once user accepts your access-request, you can start using all the methods same ways as Public API
mono.get_statements(....)
Handling Errors
If you use Personal API you may encounter "Too Many Requests" error. To properly catch it and retry - use monobank.TooManyRequests exception
try:
mono.get_statements(....)
except monobank.TooManyRequests:
time.sleep(1)
# try again:
mono.get_statements(....)
You can use ratelimiter library (like https://pypi.org/project/ratelimiter/ ) to download all transactions
Metadata
Release files for monobank 0.4.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| monobank-0.4.4.tar.gz | 5.5 kB | Without provenance | Details for monobank-0.4.4.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| monobank-0.4.4-py3-none-any.whl | Python 3 | none | any | Details for monobank-0.4.4-py3-none-any.whl |
Total release size: 11.4 kB
Release files / monobank-0.4.4.tar.gz
| Download URL | monobank-0.4.4.tar.gz |
|---|---|
| Size | 5.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9be659f7b5143d7c00904290656cf6824d3ece287e21c38abc941fa397092076
|
|
BLAKE2b-256 checksum How to use checksums |
69b1f7f449433471d238337c4109ef1e3f92fddbcd362800084637ac34954c63
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/0.12.17 CPython/3.6.9 Darwin/19.2.0
|
Release files / monobank-0.4.4-py3-none-any.whl
| Download URL | monobank-0.4.4-py3-none-any.whl |
|---|---|
| Size | 5.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
75d80a002631ca276dee5c6047d9345e3e391cd62dc687186fb847af811f227c
|
|
BLAKE2b-256 checksum How to use checksums |
f90effbf26dbc4c1cf922459a5c37280c5d154808c033aace10c7a99282b1682
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/0.12.17 CPython/3.6.9 Darwin/19.2.0
|
Security for monobank 0.4.4
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.