Open Finance Hackathon Docs

Overview

The Open Finance Hackathon Documentation is designed to help hackathon teams get up and running fast — from your first API call to your final demo. This community-maintained resource provides everything you need to build innovative financial applications using UAE Open Finance APIs.

Documentation Structure

The docs are organized into focused sections to help you find what you need:

Getting Started

Quick orientation for new participants:

• Starter Kit — Full-stack application with backend API and frontend UI
• Postman Collection — Pre-configured API testing environment
• Client Registration — Step-by-step sandbox onboarding

Open Finance APIs

Complete API reference documentation covering:

API Category	Description
Bank Data Sharing	Consent-driven access to customer banking data including accounts, balances, transactions, and beneficiaries
Payment Initiation	Consent-driven initiation and management of customer payments
Products and Leads	Structured banking product data with application capabilities
Confirmation of Payee	Verification of payee account details before payments

Hackathon Challenge Tracks

Four focus areas combining intelligent automation with Open Finance:

• Retail & Wealth — Personal finance insights and investment guidance
• SME & Corporate — Business cash-flow and lending solutions
• Risk & Compliance — Fraud detection and regulatory automation
• Smart Automation — Autonomous systems with user consent

Starter Kit Quick Start

The hackathon starter kit provides an integrated development environment with Node.js/Express backend and Vite-powered frontend.

Installation

# Clone the repository
git clone https://github.com/openfinance-os/starter-kit.git
cd starter-kit

# Install dependencies
npm install

Configuration

Add your credentials to api/config.js:

module.exports = {
  CLIENT_ID: 'your_client_id',
  SIGNING_KEY_ID: 'your_signing_key_id'
};

Place your certificate files in api/certificates/:

• client_signing.key
• client_transport.key
• client_transport.pem

Run Development Server

npm run dev

Access points:

• Swagger API Docs: http://localhost:1411/api-docs
• Frontend UI: http://localhost:1411/client

Key Capabilities

The starter kit enables these core workflows:

• User Registration — Onboard to the Open Finance sandbox
• OAuth Consent Flows — Implement authorization with banks
• Token Management — Handle access and refresh tokens
• Banking Data Access — Retrieve accounts, balances, transactions
• Payment Initiation — Create and manage payments
• Payee Confirmation — Verify payment recipients
• Product Discovery — Explore available financial products

Contributing to the Docs

The documentation is open source and welcomes contributions:

# Clone the docs repository
git clone https://github.com/openfinance-os/docs.git
cd docs

# Install Mintlify CLI
npm i -g mintlify

# Start local development server
mint dev

View your changes at http://localhost:3000.

Resources

Resource	Link
Live Documentation	docs.openfinance-hackathon.com
Docs GitHub Repo	github.com/openfinance-os/docs
Community Discussions	GitHub Discussions
Open Finance Standards	OpenFinance UAE Wiki

Agentic Coding

The docs include resources for building AI-powered financial applications, with guidance on implementing agentic workflows that leverage Open Finance APIs.

Support

For hackathon support:

• Post questions in GitHub Discussions
• Check the Support section in the documentation
• Review existing examples and project templates

License

MIT License — see the docs repository for details.