{"id":108,"library":"fdic-api","title":"FDIC API Python Wrapper","description":"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.","status":"active","version":"N/A","language":"python","source_language":"en","source_url":"https://github.com/dpanagop/fdic-api","tags":["fdic","banking","finance","api-wrapper","government-data","python"],"install":[{"cmd":"pip install requests","lang":"bash","label":"HTTP client (no official PyPI package)"}],"dependencies":[{"reason":"Used for making HTTP requests to the FDIC BankFind Suite API.","package":"requests","optional":false}],"imports":[{"note":"The import package name is fdic_api (underscore), not fdic.","wrong":"from fdic import InstitutionsQuery","symbol":"InstitutionsQuery","correct":"from fdic_api import InstitutionsQuery"},{"note":"Used for querying financial report data from the FDIC API.","symbol":"FinancialsQuery","correct":"from fdic_api import FinancialsQuery"},{"note":"Used for querying institutional history events.","symbol":"HistoryQuery","correct":"from fdic_api import HistoryQuery"},{"note":"Used for querying FDIC bank failure records.","symbol":"FailuresQuery","correct":"from fdic_api import FailuresQuery"},{"note":"Used for querying aggregate summary statistics.","symbol":"SummaryQuery","correct":"from fdic_api import SummaryQuery"}],"quickstart":{"code":"import requests\n\n# No API key required - FDIC API is public\nresp = requests.get(\n    \"https://api.fdic.gov/banks/institutions\",\n    params={\"filters\": \"STNAME:California\", \"limit\": 5, \"fields\": \"NAME,CITY,STNAME,ASSET\"}\n)\nresp.raise_for_status()\ndata = resp.json()\nfor inst in data[\"data\"]:\n    print(f\"{inst['data']['NAME']} - {inst['data']['CITY']}, {inst['data']['STNAME']}\")","lang":"python","description":"Query FDIC for banks in California. No authentication required."},"warnings":[{"fix":"Use 'from fdic_api import InstitutionsQuery' not 'from fdic-api import ...' or 'from fdic import ...'.","message":"The pip package name uses a hyphen (fdic-api) but the Python import uses an underscore (fdic_api).","severity":"gotcha","affected_versions":"all"},{"fix":"Implement your own retry logic with exponential backoff, or add delays between requests using time.sleep().","message":"The 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.","severity":"gotcha","affected_versions":"all"},{"fix":"Use query.filter('STNAME:\"California\"') with escaped double quotes around string values.","message":"Filter syntax uses the FDIC API's own query language, not Python expressions. String values in filters must be wrapped in escaped double quotes.","severity":"gotcha","affected_versions":"all"},{"fix":"Access fields via result['data']['FIELD_NAME'] not result['FIELD_NAME'].","message":"Results are returned as a list of dictionaries with nested 'data' keys, not flat dictionaries.","severity":"gotcha","affected_versions":"all"},{"fix":"Use query.limit(10000) for larger result sets or implement pagination with query.offset().","message":"The default limit on results is small. If you need all matching records, you must handle pagination manually or set a higher limit.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-12T08:09:33.030Z","next_check":"2026-06-17T00:00:00.000Z","problems":[{"fix":"pip install fdic-api","cause":"The `fdic-api` package has not been installed in the current Python environment.","error":"ModuleNotFoundError: No module named 'fdic_api'"},{"fix":"import fdic_api","cause":"Python module names cannot contain hyphens. The package name `fdic-api` is imported using an underscore.","error":"SyntaxError: invalid syntax (when trying 'import fdic-api')"},{"fix":"client = fdic_api.FdicApi()\nbank_data = client.get_institutions()","cause":"The method 'get_banks' does not exist on the `FdicApi` client. The correct method to retrieve institution data is 'get_institutions'.","error":"AttributeError: 'FdicApi' object has no attribute 'get_banks'"},{"fix":"client.get_institutions(limit=10) # Ensure integer values for integer parameters","cause":"A method parameter that expects an integer (e.g., `limit`) was provided with a string value instead.","error":"TypeError: 'str' object cannot be interpreted as an integer"}],"ecosystem":"rest","meta_description":null,"install_score":0,"install_tag":"stale","quickstart_score":80,"quickstart_tag":"verified","pypi_latest":null,"install_checks":{"last_tested":"2026-05-12","tag":"stale","tag_description":"widespread failures or data too old to trust","results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"default","exit_code":1,"wheel_type":null,"failure_reason":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"default","exit_code":1,"wheel_type":null,"failure_reason":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"default","exit_code":1,"wheel_type":null,"failure_reason":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"default","exit_code":1,"wheel_type":null,"failure_reason":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"default","exit_code":1,"wheel_type":null,"failure_reason":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"default","exit_code":1,"wheel_type":null,"failure_reason":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"default","exit_code":1,"wheel_type":null,"failure_reason":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"default","exit_code":1,"wheel_type":null,"failure_reason":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"default","exit_code":1,"wheel_type":null,"failure_reason":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"default","exit_code":1,"wheel_type":null,"failure_reason":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null}]},"quickstart_checks":{"last_tested":"2026-05-12","tag":"verified","tag_description":"quickstart runs on critical runtimes, recently tested","results":[{"runtime":"python:3.10-alpine","exit_code":0},{"runtime":"python:3.10-slim","exit_code":0},{"runtime":"python:3.11-alpine","exit_code":0},{"runtime":"python:3.11-slim","exit_code":0},{"runtime":"python:3.12-alpine","exit_code":0},{"runtime":"python:3.12-slim","exit_code":0},{"runtime":"python:3.13-alpine","exit_code":0},{"runtime":"python:3.13-slim","exit_code":0},{"runtime":"python:3.9-alpine","exit_code":0},{"runtime":"python:3.9-slim","exit_code":0}]}}