[ library, mit, program, web ] [ Propose Tags ]

Api client for popular Ukrainian bank - Monobank

[Skip to Readme]
Versions [RSS] [faq],,,,
Dependencies aeson, api-monobank, base (>=4.7 && <5), bytestring, http-conduit, stm, text, time [details]
License MIT
Copyright Copyright: (c) 2019 Sergey Bushnyak
Author Sergey Bushnyak
Maintainer sergey.bushnyak@sigrlami.eu
Category Web
Home page https://github.com/sigrlami/api-monobank#readme
Source repo head: git clone https://github.com/sigrlami/api-monobank
Uploaded by sigrlami at 2019-06-25T14:43:14Z
Distributions NixOS:
Executables mnb-app
Downloads 1869 total (13 in the last 30 days)
Rating 2.0 (votes: 1) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Hackage Matrix CI
Docs available [build log]
Last success reported on 2019-06-26 [all 1 reports]


[Index] [Quick Jump]


Maintainer's Corner

For package maintainers and hackage trustees


Readme for api-monobank-

[back to package description]

Monobank Api Client

Haskell client for MonoBank API services (https://api.monobank.ua/docs/)

Monobank Api

  1. Introduction
  2. Public API
  3. Private API
  4. Building library


API for extracting information and personal account status. To grant access, you must pass the authorization in your personal office at https://api.monobank.ua/ and get a token for personal use.

If you have questions about the operation of the API, we invite to the community in the Telegram channel.

If you have a service or application and you want to centrally join the API for customer service, you need to connect to a corporate API that has more features.

This will allow monobank clients to log in to your service (for example, in a financial manager) to provide information about the status of an account or statements.

In the event of the exploitation of this API as corporate, the bank reserves the right to impose sanctions on the company.


General information provided without authorization.

# Path Type Params Description Response Notes
1 /bank/currency GET Get a basic list of monobank currency rates. Information is cached and updated no more than once every 5 minutes. JSON Response will be a json array with objects of 2 types
    "currencyCodeA": 978,
    "currencyCodeB": 840,
    "date": 1561426807,
    "rateBuy": 1.1249,
    "rateSell": 1.1368
    "currencyCodeA": 826,
    "currencyCodeB": 980,
    "date": 1561461569,
    "rateCross": 33.2857

note the absence of rateBuy, rateSell in a second example.Inside client system automatically convert int base date into normalized UTCTime format.


Information provided with authorization.

# Path Type Params Description Response Notes
1 /personal/client-info GET Obtaining information about the client and the list of his accounts. Limit on the use of the function no more than 1 time in 60 seconds. JSON
X-Token string; in header Token for personal access to the API
2 /personal/statement GET /{account}/{from}/{to} Receive an extract for the time from {to} to {to} time in seconds Unix time format. The maximum time for which it is possible to extract an extract is 31 days (2678400 seconds) Limit on the use of the function no more than 1 time in 60 seconds. JSON
X-Token string; in header Token for personal access to the API
account string; in path Account ID from the Statement list list or 0 is a default account.
from string; in path Start of the excerpt time
to string; in path End time of the excerpt (if not, the current time will be used)


  • src - contains actual API that can be used in 3rd part apps
  • app - executable for CLI app that can be used to view current value or run continuosly

Just build repository with stack build and use following

$ stack exec -- mnb-app

or simply mnb-app if you used stack install command

$ mnb-app

that will bring following output if runned without keys, currency info

Monobank | Not tokenized API access available for currencies only
Monobank | Getting last currency prices

 - Buy:  25.961 ₴
 - Sell: 26.2357₴

 - Buy:  29.161 ₴
 - Sell: 29.9294₴

 - Buy:  0.378 ₴
 - Sell: 0.418₴

 - Buy:  1.1249 $
 - Sell: 1.1368$

 - Cross: 33.32₴

 - Cross: 26.9263₴

 - Cross: 12.8902₴

 - Cross: 19.8825₴

 - Cross: 1.1669₴

 - Cross: 4.0001₴

 - Cross: 9.22e-2₴

 - Cross: 7.012₴

 - Cross: 4.5473₴