Compare an institution with its peers
fdic_compare_peersRead-onlyIdempotent
Compare one institution with a peer group for one quarter: for each metric, the institution's value next to the peer median, quartiles, minimum and maximum, and its percentile and rank. The default peer group is every institution in the same asset-size band that reported that quarter; narrow it to one state, widen it to all sizes, or name the peers by CERT. Dollar amounts are in thousands; ratios are percentages.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cert | Yes | FDIC certificate number of the institution to compare, from fdic_search_institutions. | |
| metrics | No | Up to 20 metric names (fdic_list_reference topic metrics). Omit for the default health set. | |
| peer_certs | No | An explicit peer list of up to 200 CERTs, in place of the band and state peer group — pass it without peer_asset_band and peer_state. Fewer than five peers still computes, with a notice. | |
| peer_state | No | Limit peers to one headquarters state: a two-letter code, a full state name, or same for the institution's own state. Omit for nationwide. Not combinable with peer_certs. | |
| report_date | No | Quarter to compare: a quarter-end date (2026-06-30), the same without dashes (20260630), or a quarter label (2026Q2). Omit for the latest quarter FDIC has published. | |
| peer_asset_band | No | Peer size band by total assets: same (the band holding the institution's own assets, default), any (all sizes), under_100m, 100m_1b, 1b_10b, 10b_250b, or over_250b; fdic_list_reference topic peer_asset_bands gives each band's bounds. Not combinable with peer_certs. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present when the call failed. Absent on success. | |
| notice | No | Guidance when the peer group is empty or a metric has fewer than five peer values. | |
| data_as_of | No | When FDIC last rebuilt the financials index (ISO timestamp). | |
| peer_group | No | How the peer group was built. | |
| comparisons | No | Per-metric comparison, in metric order. | |
| institution | No | The institution being compared. | |
| report_date | No | Quarter-end date compared (YYYY-MM-DD). | |
| peer_certs_missing | No | Explicit peer CERTs that filed no Call Report for the quarter. | |
| report_date_defaulted | No | True when report_date was omitted and the latest published quarter was used. |