Simple Node.js application based on Express or Fastify that demonstrates, how to connect with AHOI Open Banking API and how to retrieve account transactions
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Build Status

AHOI Node.js demo app with Express or Fastify

Sparkassen Innovation Hub

This simple demo app shows how to easily get data e.g. transactions from different banking accounts using the AHOI Open Banking API.

Installation and Start

  1. If not already done, install Node.js on your computer. Installation instruction can be found here: Node.js download. You must use at least version 10.0.0 or higher.

    We recommended (it is optional) to install the Node Version Manager (NVM) as it allows to use different versions of Node.js for different applications.

  2. Install GIT command line client if not already installed (currently all modules are available only on GitHub and not on NPM)

  3. Clone this project or download and unpack it on your computer (see the green button 'Clone or Download' above)

  4. Configure the application with the AHOI credentials. You have to register a demo account at (AHOI Demo-Account) first to do this.

  5. After registration at AHOI open the application configuration file in a text editor: <PROJECT_DIR>/config/env.development. Add the AHOI secrets which you find within your AHOI sandbox account. AHOI credentials Add the configuration for the following items:


    Additionally you should set an encryption key for an additonial security layer. You can use any password for that:


    Note: you should make the configuration file hidden by renaming it into .env.development as it contains passwords. The hidden configuration file is excluded from GIT commits.

  6. Open the console and change to the directory where you have cloned or unpacked the project, e.g. /user/development/ahoi-nodejs-demo-app

  7. Install the application dependencies. This may take some time.

    npm i
  8. Start the server

    # development
    npm run watch
    # production
    npm run build
    npm start
  9. Test if the application works. Open in your browser:

    You should get an AHOI JWT token and an installationid

  10. If everything works fine, it's time to launch the simple app.

    Open the following URL in your browser and follow the explanations:

Next Steps / Tipps



This application uses winston logger in the background. But to make it as simple as possible console log messages (console.log,, ...) are redirected to winston logger and saved in log files. You can find the log files in the folder /logs.

If you want to change the log level, it can be set in the configuration file (/config/env.development).

Create a new controller e.g. using the AHOI forecast API

Create a new controller class or copy an existing one e.g. /helloworld.controller.ts or accounts.controller.ts.

Create methods with endpoints, e.g.:

public async getBalanceForecast(@USER() user: any,
                                @QUERYPARAM('accessid', Validator_UUIDRequired) accessid: string,
                                @QUERYPARAM('accountid', Validator_UUIDRequired) accountid: string): Promise<Forecast> {
    const installationId: string = await this.userService.getInstallationId(;
    const api: ForecastAPI = await this.ahoiApi.getForecastApi(installationId);
    return api.getForecast(accountid, accessid);

Disable authentication to make development easier

In production environment user authentication and user management is mandatory to store and protect user data e.g. the AHOI installationid. But during development it can be annoying if we get not JSON data but a message 'Unauthorized'.

To disable authentication simple open the configuration file e.g. /config/env.development and set ENABLE_AUTHENTICATION to false. If you now want to fetch data from AHOI API, a new user at AHOI will be registered and the returned installationid saved on disk. From now on for any request to the AHOI API the stored installationid is used.

Install MongoDB (with Encryption)

This application uses TingoDB that is partly compatible with MongoDB to make the first steps easier. But in production you should use MongoDB. We recommend to configure it with MongoDB encryption.

To use MongoDB you must install it (we recommend installation using Docker) and set the correct MONGODB_URI in the configuration file (/config/env.development)

Note: data stored in TingoDB can not be easily migrated to MongoDB. It is possible to write a migration script but this application does not provide such a script.


Licensed under MIT.