https://github.com/dpguthrie/bankfind
Python interface to the FDIC's API for publically available bank data
https://github.com/dpguthrie/bankfind
api api-wrapper banking data finance pandas python united-states
Last synced: 6 months ago
JSON representation
Python interface to the FDIC's API for publically available bank data
- Host: GitHub
- URL: https://github.com/dpguthrie/bankfind
- Owner: dpguthrie
- License: mit
- Created: 2020-08-22T02:59:15.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-04-15T22:34:16.000Z (almost 3 years ago)
- Last Synced: 2025-07-17T15:04:25.344Z (7 months ago)
- Topics: api, api-wrapper, banking, data, finance, pandas, python, united-states
- Language: Python
- Homepage: https://bankfind.dpguthrie.com
- Size: 457 KB
- Stars: 11
- Watchers: 1
- Forks: 8
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
Python interface to the FDIC's API for publically available bank data
---
**Documentation**: https://bankfind.dpguthrie.com
**Source Code**: https://github.com/dpguthrie/bankfind
**FDIC Documentation**: https://banks.data.fdic.gov/docs/
---
## Overview
**bankfind** is a python interface to publically available bank data from the FDIC.
There are currently, as of 8/11/20, five endpoints that the FDIC has exposed to the public:
- **failures** - returns detail on failed financial institutions
- **institutions** - returns a list of financial institutions
- **history** - returns detail on structure change events
- **locations** - returns locations / branches of financial institutions
- **summary** - returns aggregate financial and structure data, subtotaled by year, regarding financial institutions
## Requirements
Python 2.7, 3.5+
- [Requests](https://requests.readthedocs.io/en/master/) - The elegant and simple HTTP library for Python, built for human beings.
- [Pandas](https://pandas.pydata.org/) - Fast, powerful, flexible and easy to use open source data analysis and manipulation tool
## Installation
```python
pip install bankfind
```
## Example
```python
import bankfind as bf
# Get Institutions
data = bf.get_institutions()
# Get Institutions from Colorado with high ROE
data = bf.get_institutions(filters="STNAME:Colorado AND ROE:[25 TO *]")
# Get Commercial Banks from Colorado that aren't S-Corps
data = bf.get_institutions(filters="STNAME:Colorado AND SUBCHAPS:0 AND CB:1")
```
## License
This project is licensed under the terms of the MIT license.