Banks
US commercial bank financials and institution profiles from the FDIC BankFind Suite.
Paths are relative to https://api.agentdatasets.com. Every endpoint mirrors an MCP tool over the same service layer — the tool catalog documents the same operations for MCP clients.
GET/v1/banks/financials
Financials
Return one institution's bounded, cursor-paged FDIC financials.
Parameters
| Name | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| cert | integer | Yes | — | — | Exact FDIC certificate number |
| metrics | array<string> | null | No | — | — | Repeated curated metric_key filter; omit for all metrics |
| start | string (date) | null | No | — | — | Inclusive lower report-date bound (YYYY-MM-DD) |
| end | string (date) | null | No | — | — | Inclusive upper report-date bound (YYYY-MM-DD) |
| limit | integer | No | 8 | min 1, max 40 | Report quarters, newest first |
| cursor | string | null | No | — | — | Opaque pagination.next_cursor from the previous response |
Example request
Required parameters only, with values taken from the schema. Optional parameters are in the table above.
[ BASH ]
curl --fail --silent --show-error \
--header "X-API-KEY: adk_..." \
"https://api.agentdatasets.com/v1/banks/financials?cert=1"Response
200 Successful Response · expand a branch to see its fields.
dataBankFinancialsDatarequiredInstitution identity, requested metric vocabulary, and quarterly values.
- certintegerrequired
- namestringrequired
- rssd_idintegerrequirednullable
- activebooleanrequired
- citystringrequirednullable
- statestringrequirednullable
- period_type"quarter"default "quarter"
quartersarray<BankFinancialsQuarter>required
- periodstring (date)required
- fiscal_quarterstringrequired
valuesmap<string, BankFinancialValue>required
[key: string]BankFinancialValueOne exact quarterly metric value with its interpretation and freshness.
- valuestringrequiredpattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
- unitstringrequired
- currencystringrequirednullable
- as_ofstring (date-time)required
metric_definitionsmap<string, BankMetricDefinition>required
[key: string]BankMetricDefinitionInterpretive catalog metadata for one requested financial metric.
- titlestringrequired
- unitsstringrequired
- currencystringrequirednullable
- basisstringrequired
- categorystringrequired
- descriptionstringrequired
metaMetarequiredResult-level provenance. ``source`` is a stable connector identifier (e.g. ``sec_edgar_companyfacts``); ``as_of`` is the freshest value-level ``as_of`` on the returned page, or ``None`` when the page is empty. Event-grained sources carry an aware datetime; date-grained sources (e.g. an SEC filing's report period) carry a plain date.
- sourcestringrequired
- as_ofstring (date-time) | string (date)nullable
paginationPaginationnullable
- limitintegerrequired
- has_morebooleanrequired
- next_cursorstringnullable
GET/v1/banks/search
Search
Return ranked FDIC institution matches for a name or identifier.
Parameters
| Name | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| query | string | Yes | — | — | Institution name, FDIC cert, or RSSD id |
| limit | integer | No | 10 | min 1, max 50 | Maximum ranked institution matches |
Example request
Required parameters only, with values taken from the schema. Optional parameters are in the table above.
[ BASH ]
curl --fail --silent --show-error \
--header "X-API-KEY: adk_..." \
"https://api.agentdatasets.com/v1/banks/search?query=QUERY"Response
200 Successful Response · expand a branch to see its fields.
dataBankInstitutionSearchDatarequiredThe echoed query and its bounded, best-first institution matches.
- querystringrequired
matchesarray<BankInstitutionMatch>required
- certintegerrequired
- rssd_idintegerrequirednullable
- namestringrequired
- citystringrequirednullable
- statestringrequirednullable
- county_fipsstringrequirednullable
- county_namestringrequirednullable
- activebooleanrequired
- primary_regulatorstringrequirednullable
- charter_classstringrequirednullable
- established_datestring (date)requirednullable
- closed_datestring (date)requirednullable
- scoreintegerrequired
- match_reasonstringrequired
- as_ofstring (date-time)required
metaMetarequiredResult-level provenance. ``source`` is a stable connector identifier (e.g. ``sec_edgar_companyfacts``); ``as_of`` is the freshest value-level ``as_of`` on the returned page, or ``None`` when the page is empty. Event-grained sources carry an aware datetime; date-grained sources (e.g. an SEC filing's report period) carry a plain date.
- sourcestringrequired
- as_ofstring (date-time) | string (date)nullable
paginationPaginationnullable
- limitintegerrequired
- has_morebooleanrequired
- next_cursorstringnullable