fdic-api

libraryN/Apyrest✓ verified 31d ago

Python wrapper for the FDIC BankFind Suite API, providing access to FDIC banking data including institution details, financial reports, history, failures, and summary statistics. Simplifies querying the public FDIC REST API with Pythonic interfaces.

data http-networking

pip install requests

INSTALL

IMPORT

SIG · FDIC-API

fdic-api

datapythonvN/A

Install

2.5s avg

Import

—

Disk

105MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v? · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 70MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 2.5s · import 0.000s · 141MB

105MB installed

● package 105MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

InstitutionsQuery

✓ from requests.api import InstitutionsQuery

✗ from requests import InstitutionsQuery

Query FDIC for banks in California. No authentication required.

import requests # No API key required - FDIC API is public resp = requests.get( "https://api.fdic.gov/banks/institutions", params={"filters": "STNAME:California", "limit": 5, "fields": "NAME,CITY,STNAME,ASSET"} ) resp.raise_for_status() data = resp.json() for inst in data["data"]: print(f"{inst['data']['NAME']} - {inst['data']['CITY']}, {inst['data']['STNAME']}")

Debug

Known issues

gotchaThe pip package name uses a hyphen (fdic-api) but the Python import uses an underscore (fdic_api).

fix

Use 'from fdic_api import InstitutionsQuery' not 'from fdic-api import ...' or 'from fdic import ...'.

affects: all

gotchaThe FDIC API has rate limits and may return 429 errors if too many requests are made in quick succession. The library does not implement automatic retry or backoff.

fix

Implement your own retry logic with exponential backoff, or add delays between requests using time.sleep().

affects: all

gotchaFilter syntax uses the FDIC API's own query language, not Python expressions. String values in filters must be wrapped in escaped double quotes.

fix

Use query.filter('STNAME:"California"') with escaped double quotes around string values.

affects: all

gotchaResults are returned as a list of dictionaries with nested 'data' keys, not flat dictionaries.

fix

Access fields via result['data']['FIELD_NAME'] not result['FIELD_NAME'].

affects: all

gotchaThe default limit on results is small. If you need all matching records, you must handle pagination manually or set a higher limit.

fix

Use query.limit(10000) for larger result sets or implement pagination with query.offset().

affects: all

Upgrade

Version history

N/Alatest on PyPI

Audit

Dependencies

requestsrequiredUsed for making HTTP requests to the FDIC BankFind Suite API.

Agent activity

21 hits · last 30 days

node

Resources

No resource links recorded.