Here is a reworked README.md that accurately reflects your project’s current state and objective as a Financial Data Aggregator prototype using Plaid Link and FDX APIs to simulate a Data Out use case.
This version is concise, professional, and tailored to your architecture and goals.
FDA_V2 is a prototype web application and API server that demonstrates a Data Out use case for open banking.
It enables a customer to link their bank account using Plaid Link and then retrieve their financial data—including contact, account, transaction, and statement information—via FDX-aligned APIs.
The goal is to simulate a modern, standards-based data sharing experience, showing how a consumer can control and export their financial data to third-party applications using industry protocols.
-
Plaid Link Integration:
Customers can securely link their bank accounts using the Plaid Link widget. -
FDX-Aligned API Endpoints:
Simulates a provider-side Financial Data Exchange (FDX) API, returning customer, account, transaction, and statement data in FDX format. -
Professional Web UI:
Responsive, Fidelity-branded dashboard for linking accounts and viewing retrieved data. -
Data Out Simulation:
Models the consumer experience of exporting their financial data to an external app or aggregator. -
Node.js/Express Backend:
RESTful API server with modular code, SQLite database, and clear separation of UI and API logic.
FDA_V2/
├── node_modules/ # Project dependencies
├── public/ # Static assets (UI, CSS, JS)
│ ├── index.html
│ ├── main.js
│ └── style.css
├── fdx-api.js # Main API server (FDX endpoints)
├── accounts-api.js # API logic for accounts
├── fdx.db # SQLite database file
├── package.json # Node.js dependencies and scripts
├── readme.md # Project documentation
└── ... # Other configuration and SQL files
-
Clone the repository:
git clone https://github.com/jryan99/FDA_V2.git cd FDA_V2 -
Install dependencies:
npm install
-
Set up the database:
- Ensure
fdx.dbexists, or run the provided SQL scripts to initialize the schema.
- Ensure
-
Start the API server:
node fdx-api.js
- The server will be available at
http://localhost:3000(or your configured port).
- The server will be available at
-
Web UI:
Openhttp://localhost:3000/public/index.htmlin your browser to use the Fidelity-style dashboard and simulate account linking and data retrieval. -
API Endpoints:
Use REST endpoints to retrieve FDX-format data:GET /api/openbank/customer/:customerIdGET /api/openbank/accounts?customerId=...GET /api/openbank/transactions?customerId=...GET /api/openbank/statements?customerId=...
-
Plaid Link:
The UI will launch Plaid Link for simulated account linking.
(Configure your Plaid sandbox credentials in the environment as needed.)
- All source code is in the project root and
public/directory. - Modify
fdx-api.js,main.js, andstyle.cssto extend or customize functionality. - Static assets (HTML, JS, CSS) are served from the
public/directory.
This project demonstrates how a financial institution or fintech can implement a Data Out solution using Plaid Link for account authentication and FDX APIs for secure, standards-based data sharing.
It is intended for prototyping, demonstration, and educational purposes in the context of open banking and consumer data rights.
Contributions are welcome! Please fork the repository and submit a pull request with your improvements.
This project is licensed under the MIT License.
Note:
- For production use, ensure all secrets and credentials are stored securely and not in the repository.
- For more details, see the inline documentation in each source file.
[1] https://ppl-ai-file-upload.s3.amazonaws.com/web/direct-files/attachments/38576876/4e54cbe9-76bb-4b7d-9a7a-63af960e2b1d/readme.md [2] https://github.com/plaid/pattern-account-funding/blob/master/README.md [3] https://plaid.com/core-exchange/docs/ [4] https://plaid.com/products/core-exchange/ [5] https://plaid.com/core-exchange/docs/reference/5.1/ [6] https://plaid.com/core-exchange/docs/reference/5.2/ [7] https://plaid.com/core-exchange/docs/reference/5.3/ [8] https://plaid.com/resources/open-finance/what-is-fdx/ [9] https://apis.io/apis/plaid/plaid-fdx-api/ [10] https://www.feathery.io/integrations/plaid [11] https://remoteok.com/remote-api+saas-jobs