Spiral gives your agent every tool with one account. Browse the tools →

AlexandriaFinanceAvailable now

FDIC BankFind Suite · Institutions

banks-data-fdic-gov/bank-data/institutions

Get market and financial data with FDIC BankFind Suite · Institutions from Alexandria through one Spiral API key. Find a US bank or savings institution and its FDIC certificate number (CERT), which every other function filters on, or list banks by state, size or status. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

Pricing

$0.00873 per call.

Limits

Runs
In the background
Returns
json
Longest queue wait
1 hour
Run deadline
5 minutes
Longest run, end to end
225 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
certnumber
1 to 9999999
—

FDIC certificate number, the institution id shared by every BankFind dataset (3511 = Wells Fargo Bank, N.A.; 628 = JPMorgan Chase Bank, N.A.). Find it with institutions. A number no institution has ever held is not_found.

citytext—

Exact city, matched against CITY as BankFind stores it, case included (Sioux Falls, not sioux falls). Pattern: ^[^"\\]+$.

nametext—

Fuzzy name search over current and prior names (BankFind search=NAME:...), tolerant of misspelling: Wells Fargo, Silvergate. Pattern: ^[^"\\]+$.

statetext—

Two-letter state or territory code, matched against STALP, the headquarters state. Pattern: ^[A-Za-z]{2,3}$.

activetrue or false—

true for institutions open and insured today, false for closed ones. Omit for both.

cursortext—

next_cursor from the previous page of the same query (the record offset).

fieldslist—

Projection: column names to return instead of the default set, e.g. ["ASSET", "DEP", "ROA", "WEBADDR"]. The identity columns are always added and every record carries ID. An unknown name is ignored. The FDIC's column definitions are at https://api.fdic.gov/banks/docs/.

filterstext—

Raw BankFind filter, ANDed with the other inputs. Lucene-style: FIELD:value, FIELD:"two words", FIELD:("A","B") for any of several, FIELD:[low TO high] for an inclusive range (* open), !(FIELD:value) to exclude, AND/OR between terms. Column names are upper case and values match exactly as stored, case included. An unknown column matches nothing (an empty result, not an error); a syntax error is invalid_input.

sort_bylist—

Columns to sort by, in priority order, e.g. ["DEP"] or ["NAME"]. Defaults to ASSET descending (largest first). Unique tiebreak columns are always appended so offset paging is stable. An unsortable or unknown column is invalid_input.

page_sizenumber
1 to 1000
25

Records per page.

sort_orderone of
asc, desc
—

Direction for every sort column. Defaults to the direction of the default sort.

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "banks-data-fdic-gov/bank-data/institutions",
    "input": {
      "cert": 1
    }
  }'

Frequently asked questions

How much does FDIC BankFind Suite · Institutions cost?

$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use FDIC BankFind Suite · Institutions through an API?

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "banks-data-fdic-gov/bank-data/institutions"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with Alexandria to use FDIC BankFind Suite · Institutions?

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

Can my AI agent use FDIC BankFind Suite · Institutions?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.