KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #cli #open-source #ai #claude-code #codex #developer-tools #dsh-plugin #ai-agent #mcp #deepseek-harness

Understanding-Financial-Reports-using-Natural-Language-Processing

★ 53 Open GitHub ↗

Investigate how mutual funds leverage credit derivatives by studying their routine filings to the SEC using NLP techniques 📈🤑

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Understanding Financial Reports using Natural Language Processing

This project serves as my undergraduate Computer Science thesis in Natural Language Processing.

## Background

This project investigates how mutual funds leverage credit derivative by studying their routine filings to the U.S. Securities and Exchange Commission. Credit derivatives are used to transfer credit risk related to an underlying entity from one party to another without transferring the actual underlying entity.

Instead of studying all credit derivatives, we focus on Credit Default Swap (CDS), one of the popular credit derivatives that were considered the culprit of the 2007-2008 financial crisis. A credit default swap is a particular type of swap designed to transfer the credit exposure of fixed income products between two or more parties. In a credit default swap, the buyer of the swap makes payments to the swaps seller up until the maturity date of a contract. In return, the seller agrees that, in the event that the debt issuer defaults or experiences another credit event, the seller will pay the buyer the securitys premium as well as all interest payments that would have been paid between that time and the securitys maturity date.

CDS is traded over-the-counter, thus there exists little public information on its trading activities for the outside investors. However, such information is valuable. CDS is designed as a hedging tool that the buyers use to protect themselves from potential default events of the reference entity. Besides, it is also used for speculation and liquidity management especially during a crisis.

Before SEC has requested more frequent and detailed fund holdings reporting at the end of 2016, mutual funds filed the forms in discrepant formats. This made it extremely difficult to effectively extract information from the reports for carrying out further analysis. There exist some previous studies that explored how mutual funds have made use of CDS (Adam and Guttler, 2015, Jiang and Zhu, 2016), but only examined a fraction of institutions over a short period of time. In this project, we aim to extract as much CDS-related information as possible from all the filings available to date to enable more thorough downstream analysis. This information appears not only in the form of charts but also in words, thus Natural Language Processing (NLP) is the key.

## Tools Used

1. The core of this project can be recognised as a Named Entity Recognition Task, so we implemented a BiLSTM-CRF model and a CRF model to conduct sequence labelling on unsturctured data. Its implementation is still in progress and can be found here: `https://github.com/sudhamstarun/AwesomeNER` <br>
2. A RESTful API based web application is developed to work as a Credit Default Swap Search Engine in order to make it extremely accessible for researchers and analysts to have access to all the historical mentions of Credit Default Swap by simply searching *counterparty* or *reference entities* `https://github.com/sudhamstarun/Credit-Default-Swap-Search-Engine`

## Basic Folder Structure

1. The Data Crawling folder is essentially the web crawling scripts written in Python to extract the N-CSR, N-CSRS and N-Q reports from the SEC website.
2. Data Preprocessing folder contains two further folders dedicated to:
   1. Restructuring Scripts: These scripts were written to further restructure the data extracted from the SEC website(148 GB) and to it's current folder heirarchy shown in the image below. Some of the noteworthy scripts are:
      1. `restructure.sh`: This script focuses on restructuring the initial folder structure into 3 different folders for N-CSR, N-CSRS, N-Q
   2. Sentence Extraction: The python-based scripts were written to parse the HTML tags present in the report and also to perform other tasks such as removing stop words and extracting sentences which contained unstructured CDS information.
3. Rule-Based Extraction: This folder contains the rule-based framework developed based on python to extract the tables containing CDS information and save it in a .csv format. This makes it extremely easy to convert reports from .NET format to .csv format making it easy to visualise and analyse the data.
4.  Finally, the website folder contains the code for the landing page created for course requirements.

## Installation and Demo

1. Before running any of the scripts, make sure you set up a virtual environment and activate the environment.
2. Then install all the necessary python dependencies by using the command:
``` bash
pip3 install -r requirements.txt
```
3. To run the *sentence extraction* script simply run:

```bash
python3 sentenceExtraction.py [name of the .txt or .htmlfile]
```
4. To run the HTMl tags parsing script, run:
``` bash
python3 HTML_Parser.py [name of the .txt or .html file]
```

5. Finally, to run the table extractor script, simply run the following command:
```bash
python3 parserExtractor.py [name of the .txt or .html file]
```
The output of the table-extractor script will be saved in the sample output folder.

## Authors:

[Tarun Sudhams](https://github.com/sudhamstarun)
[Varun Vamsi](https://github.com/Varunvamsi)

Understanding-Financial-Reports-using-Natural-Language-Processing

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README