banks tool
Publicbanks_search_institutions
Resolve a bank name or identifier to ranked FDIC institutions.
Description
Resolve a bank name or identifier to ranked FDIC institutions.
The shared envelope returns the echoed search in data.query, ranked
data.matches, FDIC provenance and freshest match timestamp in meta,
and null pagination because this is a bounded relevance result. Each
match includes cert and RSSD identifiers, name/location, active status,
regulator/charter metadata, lifecycle dates, score, match reason, and
as_of. Pass a match's cert to banks_get_financials.
Use this for FDIC-insured bank institutions. The stocks_* tools cover
SEC public-company filers instead: an FDIC cert is not a stock ticker.
The default limit is 10 and maximum is 50. Errors are bad_parameter
for an empty query and unknown_entity for no identifier/name match;
near-miss names can include suggestions.
Example: banks_search_institutions(query="Frost Bank", limit=5).
Parameters
Input schema
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| query | string | Yes | — | Institution name, FDIC certificate number, or Federal Reserve RSSD id. Digits perform an exact identifier lookup; names are case-insensitive and rank exact, prefix, then substring matches. Use this first to resolve a bank name to the cert required by banks_get_financials. |
| limit | integer | No | 10 | Maximum ranked institution matches (1–50). |