# FDIC BankFind Suite · History

Get market and financial data with FDIC BankFind Suite · History from Alexandria through one Spiral API key. What happened to a bank or its branches over time: when it opened, merged, changed its name or charter, or opened and closed branches. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Alexandria
- Category: Finance
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `banks-data-fdic-gov/bank-data/history`
- Page: https://spiral.ai/tools/alexandria/banks-data-fdic-gov/bank-data/history

## Pricing

$0.00873 per call.

## Limits

- 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

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `to` | text |  | — | Latest effective date to include, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. |
| `cert` | number | 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. |
| `from` | text |  | — | Earliest effective date to include, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. |
| `name` | text |  | — | Fuzzy institution name search (BankFind `search=NAME:...`). Pattern: ^[^"\\]+$. |
| `state` | text |  | — | Two-letter state or territory code, matched against `PSTALP`, the institution's headquarters state. Pattern: ^[A-Za-z]{2,3}$. |
| `cursor` | text |  | — | next_cursor from the previous page of the same query (the record offset). |
| `fields` | list |  | — | Projection: column names to return instead of the default set, e.g. ["INSTNAME", "EFFDATE", "CHANGECODE_DESC", "ACQ_INSTNAME", "OFF_NAME"]. 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/. |
| `filters` | text |  | — | 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_by` | list |  | — | Columns to sort by, in priority order, e.g. ["PROCDATE"]. Defaults to `EFFDATE` descending (most recent first). Unique tiebreak columns are always appended so offset paging is stable. An unsortable or unknown column is invalid_input. |
| `page_size` | number | 1 to 1000 | 25 | Records per page. |
| `sort_order` | one of | asc, desc | — | Direction for every sort column. Defaults to the direction of the default sort. |
| `change_code` | number | 1 to 999 | — | Event code: 110 new institution, 211 failure of the whole institution, 213 assisted merger, 221 absorption, 223 merger without assistance, 240 voluntary closing, 420 change of chartering agency, 510 legal name change, 520 relocation, 711 branch opening, 712 branch purchased, 721 branch closing, 722 branch sold, 810 participated in a merger, among others. CHANGECODE_DESC says each in words. |

## Example

```bash
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/history",
    "input": {
      "to": "<to>"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=banks-data-fdic-gov%2Fbank-data%2Fhistory

## Common questions

### FDIC BankFind Suite · History

**How much does FDIC BankFind Suite · History 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 · History through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "banks-data-fdic-gov/bank-data/history"` 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 · History?**

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

**Can my AI agent use FDIC BankFind Suite · History?**

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

