@yottagraph-app/aether-instructions 1.1.8 → 1.1.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/commands/update_instructions.md +30 -23
- package/package.json +1 -1
- package/skills/data-model/SKILL.md +58 -0
- package/skills/data-model/edgar/DATA_DICTIONARY.md +306 -0
- package/skills/data-model/edgar/schema.yaml +1893 -0
- package/skills/data-model/fdic/DATA_DICTIONARY.md +243 -0
- package/skills/data-model/fdic/schema.yaml +356 -0
- package/skills/data-model/fred/DATA_DICTIONARY.md +313 -0
- package/skills/data-model/fred/schema.yaml +155 -0
- package/skills/data-model/gleif/DATA_DICTIONARY.md +211 -0
- package/skills/data-model/gleif/schema.yaml +254 -0
- package/skills/data-model/newsdata/schema.yaml +650 -0
- package/skills/data-model/overview.md +77 -0
- package/skills/data-model/polymarket/DATA_DICTIONARY.md +384 -0
- package/skills/data-model/polymarket/schema.yaml +601 -0
- package/skills/data-model/sanctions/DATA_DICTIONARY.md +140 -0
- package/skills/data-model/sanctions/schema.yaml +153 -0
- package/skills/data-model/stocks/DATA_DICTIONARY.md +122 -0
- package/skills/data-model/stocks/schema.yaml +131 -0
- package/skills/data-model/system_schema.yaml +71 -0
- package/skills/data-model/wikipedia/DATA_DICTIONARY.md +185 -0
- package/skills/data-model/wikipedia/schema.yaml +255 -0
- package/skills/elemental-api/SKILL.md +37 -0
- package/skills/elemental-api/articles.md +386 -0
- package/skills/elemental-api/entities.md +393 -0
- package/skills/elemental-api/events.md +145 -0
- package/skills/elemental-api/find.md +279 -0
- package/skills/elemental-api/graph.md +239 -0
- package/skills/elemental-api/llm.md +18 -0
- package/skills/elemental-api/overview.md +51 -0
- package/skills/elemental-api/relationships.md +310 -0
- package/skills/elemental-api/schema.md +379 -0
- package/skills/elemental-api/sentiment.md +93 -0
- package/skills/elemental-api/server.md +186 -0
|
@@ -0,0 +1,243 @@
|
|
|
1
|
+
# Data Dictionary: FDIC
|
|
2
|
+
|
|
3
|
+
## Purpose
|
|
4
|
+
|
|
5
|
+
This dictionary documents the entity types, properties, and relationships that the FDIC source contributes to the Lovelace knowledge graph.
|
|
6
|
+
|
|
7
|
+
FDIC ingests data from the Federal Deposit Insurance Corporation's BankFind Suite API (`https://api.fdic.gov/banks/`), which provides public data on all FDIC-insured depository institutions in the United States. The source covers:
|
|
8
|
+
|
|
9
|
+
- **Institution profiles**: identity, location, charter, and regulatory information for ~4,300 active and ~27,800 total (including inactive) FDIC-insured banks and thrifts
|
|
10
|
+
- **Quarterly financial data**: balance sheet and income statement figures from Call Reports (FFIEC 031/041/051), updated quarterly with data back to 1984
|
|
11
|
+
- **Bank failures**: all 4,100+ FDIC-insured institution failures since 1934, including resolution details and acquiring institution
|
|
12
|
+
|
|
13
|
+
Financial figures are reported in thousands of USD as filed in Call Reports. Not all institutions report all fields; smaller banks (FFIEC 051 filers) report a reduced set.
|
|
14
|
+
|
|
15
|
+
**Source names used on records:**
|
|
16
|
+
|
|
17
|
+
| Pipeline | `Record.Source` |
|
|
18
|
+
|----------|----------------|
|
|
19
|
+
| Institution profiles + financials | `fdic` |
|
|
20
|
+
| Bank failures | `fdic_failure` |
|
|
21
|
+
|
|
22
|
+
---
|
|
23
|
+
|
|
24
|
+
## Entity Types
|
|
25
|
+
|
|
26
|
+
### `organization`
|
|
27
|
+
|
|
28
|
+
An FDIC-insured depository institution (commercial bank, savings bank, savings association, or industrial bank).
|
|
29
|
+
|
|
30
|
+
- Primary key: `fdic_certificate_number` (FDIC Certificate Number, unique identifier assigned to each insured institution)
|
|
31
|
+
- Entity resolver: named entity. Strong ID = `fdic_certificate_number`. Disambiguation context includes institution name, city, state, and holding company name. Prior names serve as aliases.
|
|
32
|
+
- Sources: `fdic`, `fdic_failure`
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
## Properties
|
|
37
|
+
|
|
38
|
+
### Organization Properties
|
|
39
|
+
|
|
40
|
+
#### Identity and Registration (source: `fdic`)
|
|
41
|
+
|
|
42
|
+
Data source: FDIC BankFind Suite Institutions API (`https://api.fdic.gov/banks/institutions`).
|
|
43
|
+
|
|
44
|
+
* `fdic_certificate_number`
|
|
45
|
+
* The FDIC Certificate Number uniquely identifying this insured institution. Also serves as the entity's strong ID for resolution.
|
|
46
|
+
* Examples: `"628"` (JPMorgan Chase Bank, N.A.), `"3850"` (First Community Bank)
|
|
47
|
+
* Derivation: `CERT` field from the Institutions API response.
|
|
48
|
+
|
|
49
|
+
* `fed_rssd_id`
|
|
50
|
+
* Federal Reserve RSSD ID, a unique identifier assigned by the Federal Reserve to every financial institution, branch, and office.
|
|
51
|
+
* Examples: `"852218"`, `"242"`
|
|
52
|
+
* Derivation: `FED_RSSD` field from the Institutions API response.
|
|
53
|
+
|
|
54
|
+
* `physical_address`
|
|
55
|
+
* Headquarters street address formatted as a single string.
|
|
56
|
+
* Examples: `"1111 Polaris Pkwy, Columbus, OH 43240"`, `"101 Main St, Xenia, IL 62899"`
|
|
57
|
+
* Derivation: `ADDRESS`, `CITY`, `STALP`, `ZIP` fields concatenated from the Institutions API response.
|
|
58
|
+
|
|
59
|
+
* `charter_class`
|
|
60
|
+
* FDIC institution charter class code describing the type of charter and regulatory supervision.
|
|
61
|
+
* Examples: `"N"` (national bank, OCC-supervised), `"SM"` (state-chartered, Fed member), `"NM"` (state-chartered, non-Fed-member), `"SB"` (savings bank), `"SA"` (savings association)
|
|
62
|
+
* Derivation: `BKCLASS` field from the Institutions API response.
|
|
63
|
+
|
|
64
|
+
* `regulatory_agency`
|
|
65
|
+
* The primary federal regulatory agency supervising this institution.
|
|
66
|
+
* Examples: `"OCC"` (Office of the Comptroller of the Currency), `"FED"` (Federal Reserve), `"FDIC"` (Federal Deposit Insurance Corporation)
|
|
67
|
+
* Derivation: `REGAGNT` field from the Institutions API response.
|
|
68
|
+
|
|
69
|
+
* `established_date`
|
|
70
|
+
* Date the institution was established, formatted as YYYY-MM-DD.
|
|
71
|
+
* Examples: `"1824-01-01"`, `"1934-01-01"`
|
|
72
|
+
* Derivation: `ESTYMD` field from the Institutions API response, reformatted from MM/DD/YYYY.
|
|
73
|
+
|
|
74
|
+
* `fdic_insurance_date`
|
|
75
|
+
* Date the institution obtained FDIC insurance, formatted as YYYY-MM-DD.
|
|
76
|
+
* Examples: `"1934-01-01"`, `"2005-06-15"`
|
|
77
|
+
* Derivation: `INSDATE` field from the Institutions API response, reformatted from MM/DD/YYYY.
|
|
78
|
+
|
|
79
|
+
* `active_flag`
|
|
80
|
+
* Whether the institution is currently active (open and operating).
|
|
81
|
+
* Values: `1.0` = active, `0.0` = inactive
|
|
82
|
+
* Derivation: `ACTIVE` field from the Institutions API response, stored as float.
|
|
83
|
+
|
|
84
|
+
* `holding_company_name`
|
|
85
|
+
* Name of the top-tier bank holding company, if any.
|
|
86
|
+
* Examples: `"JPMORGAN CHASE&CO"`, `"FIRST COMMUNITY BANCSHARES"`
|
|
87
|
+
* Derivation: `NAMEHCR` field from the Institutions API response. Omitted when the institution is not part of a holding company.
|
|
88
|
+
|
|
89
|
+
* `website`
|
|
90
|
+
* The institution's primary website URL.
|
|
91
|
+
* Examples: `"www.jpmorganchase.com"`, `"www.fcbanking.com"`
|
|
92
|
+
* Derivation: `WEBADDR` field from the Institutions API response. Omitted when blank.
|
|
93
|
+
|
|
94
|
+
* `fdic_geographic_region`
|
|
95
|
+
* FDIC supervisory region name.
|
|
96
|
+
* Examples: `"Chicago"`, `"Atlanta"`, `"Dallas"`
|
|
97
|
+
* Derivation: `FDICREGN` field from the Institutions API response.
|
|
98
|
+
|
|
99
|
+
* `institution_category`
|
|
100
|
+
* FDIC specialization group description classifying the institution by size and type.
|
|
101
|
+
* Examples: `"International Specialization"`, `"ALL OTHER UNDER 1 BILLION"`, `"ALL OTHER 1 TO 10 BILLION"`
|
|
102
|
+
* Derivation: `SPECGRPN` field from the Institutions API response.
|
|
103
|
+
|
|
104
|
+
* `office_count`
|
|
105
|
+
* Total number of offices (branches) operated by the institution, including domestic and foreign.
|
|
106
|
+
* Examples: `5320.0`, `1.0`, `25.0`
|
|
107
|
+
* Derivation: `OFFICES` field from the Institutions API response, stored as float.
|
|
108
|
+
|
|
109
|
+
* `former_name`
|
|
110
|
+
* A previous legal name of the institution. One property value per prior name entry.
|
|
111
|
+
* Examples: `"Chemical Bank"`, `"The Chase Manhattan Bank"`
|
|
112
|
+
* Derivation: `PRIORNAME1` through `PRIORNAME6` fields from the Institutions API response. Each non-empty prior name produces a separate atom. Prior names also serve as aliases for entity resolution.
|
|
113
|
+
|
|
114
|
+
#### Financial Data (source: `fdic`)
|
|
115
|
+
|
|
116
|
+
Data source: FDIC BankFind Suite Financials API (`https://api.fdic.gov/banks/financials`). All dollar amounts are in thousands of USD as reported in Call Reports. Updated quarterly; the `REPDTE` field indicates the report period end date.
|
|
117
|
+
|
|
118
|
+
* `total_assets`
|
|
119
|
+
* Total assets of the institution as reported in Call Reports.
|
|
120
|
+
* Unit: thousands of USD
|
|
121
|
+
* Examples: `3752662000.0` (JPMorgan Chase, Q4 2025), `56044.0` (First Community Bank)
|
|
122
|
+
* Derivation: `ASSET` field from the Financials API response, stored as float.
|
|
123
|
+
|
|
124
|
+
* `total_deposits`
|
|
125
|
+
* Total deposits held by the institution.
|
|
126
|
+
* Unit: thousands of USD
|
|
127
|
+
* Examples: `2697842000.0`, `47678.0`
|
|
128
|
+
* Derivation: `DEP` field from the Financials API response, stored as float.
|
|
129
|
+
|
|
130
|
+
* `total_liabilities`
|
|
131
|
+
* Total liabilities.
|
|
132
|
+
* Unit: thousands of USD
|
|
133
|
+
* Derivation: `LIAB` field from the Financials API response, stored as float.
|
|
134
|
+
|
|
135
|
+
* `shareholders_equity`
|
|
136
|
+
* Total equity capital.
|
|
137
|
+
* Unit: thousands of USD
|
|
138
|
+
* Derivation: `EQ` field from the Financials API response, stored as float.
|
|
139
|
+
|
|
140
|
+
* `net_income`
|
|
141
|
+
* Net income (loss) for the reporting period. Negative for losses.
|
|
142
|
+
* Unit: thousands of USD
|
|
143
|
+
* Derivation: `NETINC` field from the Financials API response, stored as float.
|
|
144
|
+
|
|
145
|
+
* `net_loans_and_leases`
|
|
146
|
+
* Net loans and leases after deducting allowance for loan losses.
|
|
147
|
+
* Unit: thousands of USD
|
|
148
|
+
* Derivation: `LNLSNET` field from the Financials API response, stored as float.
|
|
149
|
+
|
|
150
|
+
* `insured_deposits`
|
|
151
|
+
* Estimated amount of insured deposits (covered by FDIC insurance, up to $250K per depositor).
|
|
152
|
+
* Unit: thousands of USD
|
|
153
|
+
* Derivation: `DEPINS` field from the Financials API response, stored as float.
|
|
154
|
+
|
|
155
|
+
* `uninsured_deposits`
|
|
156
|
+
* Estimated amount of deposits exceeding FDIC insurance coverage limits.
|
|
157
|
+
* Unit: thousands of USD
|
|
158
|
+
* Derivation: `DEPUNINS` field from the Financials API response, stored as float.
|
|
159
|
+
|
|
160
|
+
* `return_on_assets`
|
|
161
|
+
* Return on assets (annualized net income as a percentage of average total assets).
|
|
162
|
+
* Examples: `1.34`, `1.42`
|
|
163
|
+
* Derivation: `ROA` field from the Financials API response, stored as float. Expressed as a percentage.
|
|
164
|
+
|
|
165
|
+
* `return_on_equity`
|
|
166
|
+
* Return on equity (annualized net income as a percentage of average total equity).
|
|
167
|
+
* Examples: `15.32`, `16.87`
|
|
168
|
+
* Derivation: `ROE` field from the Financials API response, stored as float. Expressed as a percentage.
|
|
169
|
+
|
|
170
|
+
* `net_interest_margin`
|
|
171
|
+
* Net interest margin (net interest income as a percentage of average earning assets).
|
|
172
|
+
* Examples: `2.96`, `3.91`
|
|
173
|
+
* Derivation: `NIMY` field from the Financials API response, stored as float. Expressed as a percentage.
|
|
174
|
+
|
|
175
|
+
* `number_of_employees`
|
|
176
|
+
* Total number of full-time equivalent employees.
|
|
177
|
+
* Examples: `226674.0`, `12.0`
|
|
178
|
+
* Derivation: `NUMEMP` field from the Financials API response, stored as float.
|
|
179
|
+
|
|
180
|
+
* `interest_income`
|
|
181
|
+
* Total interest income for the reporting period.
|
|
182
|
+
* Unit: thousands of USD
|
|
183
|
+
* Derivation: `INTINC` field from the Financials API response, stored as float.
|
|
184
|
+
|
|
185
|
+
* `interest_expense`
|
|
186
|
+
* Total interest expense for the reporting period.
|
|
187
|
+
* Unit: thousands of USD
|
|
188
|
+
* Derivation: `EINTEXP` field from the Financials API response, stored as float.
|
|
189
|
+
|
|
190
|
+
#### Failure Information (source: `fdic_failure`)
|
|
191
|
+
|
|
192
|
+
Data source: FDIC BankFind Suite Failures API (`https://api.fdic.gov/banks/failures`). These properties are set on organization entities for institutions that have failed.
|
|
193
|
+
|
|
194
|
+
* `failure_date`
|
|
195
|
+
* Date the institution was closed by its chartering authority.
|
|
196
|
+
* Examples: `"2026-01-30"`, `"2025-06-27"`
|
|
197
|
+
* Derivation: `FAILDATE` field from the Failures API response, reformatted from M/D/YYYY to YYYY-MM-DD.
|
|
198
|
+
|
|
199
|
+
* `failure_resolution_type`
|
|
200
|
+
* Type of resolution action taken by the FDIC.
|
|
201
|
+
* Examples: `"P&A"` (Purchase and Assumption), `"PI"` (Purchase and Assumption — Insured Deposits), `"PA"` (Purchase and Assumption — All Deposits), `"PO"` (Payout)
|
|
202
|
+
* Derivation: `RESTYPE1` field from the Failures API response.
|
|
203
|
+
|
|
204
|
+
* `failure_estimated_loss`
|
|
205
|
+
* Estimated loss to the Deposit Insurance Fund (DIF) from the failure.
|
|
206
|
+
* Unit: thousands of USD
|
|
207
|
+
* Examples: `23460.0`, `30284.0`
|
|
208
|
+
* Derivation: `COST` field from the Failures API response. Null when the estimate is not yet available.
|
|
209
|
+
* Note: may be updated over time as the FDIC finalizes loss estimates.
|
|
210
|
+
|
|
211
|
+
* `failure_total_deposits`
|
|
212
|
+
* Total deposits at the time of failure.
|
|
213
|
+
* Unit: thousands of USD
|
|
214
|
+
* Derivation: `QBFDEP` field from the Failures API response, stored as float.
|
|
215
|
+
|
|
216
|
+
* `failure_total_assets`
|
|
217
|
+
* Total assets at the time of failure.
|
|
218
|
+
* Unit: thousands of USD
|
|
219
|
+
* Derivation: `QBFASSET` field from the Failures API response, stored as float.
|
|
220
|
+
|
|
221
|
+
* `acquired_by`
|
|
222
|
+
* Link from the failed institution to the acquiring institution (the bank that purchased assets/assumed deposits).
|
|
223
|
+
* Target flavor: `organization`
|
|
224
|
+
* Examples: First Independence Bank acquired Metropolitan Capital B&T
|
|
225
|
+
* Derivation: `BIDNAME` field from the Failures API response. Omitted when no acquirer (payout resolution). The acquiring institution is created as a separate organization entity identified by name.
|
|
226
|
+
|
|
227
|
+
---
|
|
228
|
+
|
|
229
|
+
## Entity Relationships
|
|
230
|
+
|
|
231
|
+
```
|
|
232
|
+
organization ──[acquired_by]──→ organization (failed bank → acquirer, from fdic_failure)
|
|
233
|
+
```
|
|
234
|
+
|
|
235
|
+
---
|
|
236
|
+
|
|
237
|
+
## Attributes
|
|
238
|
+
|
|
239
|
+
FDIC records do not use source-specific attributes beyond the standard citation text on atoms.
|
|
240
|
+
|
|
241
|
+
- **Institution atoms**: citation text follows the pattern `"FDIC BankFind: {field_description} for {institution_name} (CERT: {cert})"`.
|
|
242
|
+
- **Financial atoms**: citation text follows the pattern `"FDIC Call Report ({report_date}): {field_description} for {institution_name} (CERT: {cert})"`.
|
|
243
|
+
- **Failure atoms**: citation text follows the pattern `"FDIC Failure: {institution_name} failed {failure_date}"`.
|
|
@@ -0,0 +1,356 @@
|
|
|
1
|
+
# Dataset schema for FDIC banking data (BankFind Suite API).
|
|
2
|
+
#
|
|
3
|
+
# This schema describes entity types, properties, and relationships produced
|
|
4
|
+
# by atomizing structured JSON from the FDIC BankFind Suite API endpoints:
|
|
5
|
+
# Institutions, Financials (Call Reports), and Failures. All elements are
|
|
6
|
+
# passive — they are created by the atomizer from parsed JSON fields, not
|
|
7
|
+
# by LLM extraction.
|
|
8
|
+
#
|
|
9
|
+
# Two source identifiers are used on records:
|
|
10
|
+
# - "fdic" — institution profiles + quarterly financials
|
|
11
|
+
# - "fdic_failure" — bank failure and resolution data
|
|
12
|
+
name: "fdic"
|
|
13
|
+
description: "FDIC-insured depository institution profiles, quarterly Call Report financials, and bank failure/resolution data from the FDIC BankFind Suite API"
|
|
14
|
+
|
|
15
|
+
extraction:
|
|
16
|
+
flavors: closed
|
|
17
|
+
properties: closed
|
|
18
|
+
relationships: closed
|
|
19
|
+
attributes: closed
|
|
20
|
+
events: closed
|
|
21
|
+
|
|
22
|
+
flavors:
|
|
23
|
+
- name: "organization"
|
|
24
|
+
description: "A particular business, institution, or organization such as a corporation, university, government agency, or non-profit"
|
|
25
|
+
display_name: "Organization"
|
|
26
|
+
mergeability: not_mergeable
|
|
27
|
+
strong_id_properties: ["fdic_certificate_number"]
|
|
28
|
+
passive: true
|
|
29
|
+
|
|
30
|
+
- name: "location"
|
|
31
|
+
description: "A specific named geographic location such as a city, country, region, or landmark"
|
|
32
|
+
display_name: "Location"
|
|
33
|
+
mergeability: not_mergeable
|
|
34
|
+
examples: ["New York City", "San Francisco", "North America", "Bakery Square"]
|
|
35
|
+
passive: true
|
|
36
|
+
|
|
37
|
+
# --- Identity and Registration (source: fdic) ---
|
|
38
|
+
|
|
39
|
+
properties:
|
|
40
|
+
- name: "fdic_certificate_number"
|
|
41
|
+
type: string
|
|
42
|
+
description: "FDIC Certificate Number uniquely identifying an insured institution, derived from the CERT field in the Institutions API"
|
|
43
|
+
display_name: "FDIC Certificate Number"
|
|
44
|
+
mergeability: not_mergeable
|
|
45
|
+
domain_flavors: ["organization"]
|
|
46
|
+
examples: ["628", "3850"]
|
|
47
|
+
passive: true
|
|
48
|
+
|
|
49
|
+
- name: "fed_rssd_id"
|
|
50
|
+
type: string
|
|
51
|
+
description: "Federal Reserve RSSD ID assigned to the financial institution by the Federal Reserve, derived from the FED_RSSD field"
|
|
52
|
+
display_name: "Federal Reserve RSSD ID"
|
|
53
|
+
mergeability: not_mergeable
|
|
54
|
+
domain_flavors: ["organization"]
|
|
55
|
+
examples: ["852218", "242"]
|
|
56
|
+
passive: true
|
|
57
|
+
|
|
58
|
+
- name: "physical_address"
|
|
59
|
+
type: string
|
|
60
|
+
description: "Physical street address of the entity"
|
|
61
|
+
display_name: "Physical Address"
|
|
62
|
+
mergeability: not_mergeable
|
|
63
|
+
domain_flavors: ["organization"]
|
|
64
|
+
examples: ["1111 Polaris Pkwy, Columbus, OH 43240", "101 Main St, Xenia, IL 62899"]
|
|
65
|
+
passive: true
|
|
66
|
+
|
|
67
|
+
- name: "charter_class"
|
|
68
|
+
type: string
|
|
69
|
+
description: "FDIC institution charter class code describing charter type and regulatory supervision (e.g., N=national bank OCC-supervised, SM=state-chartered Fed member, NM=state-chartered non-member, SB=savings bank, SA=savings association)"
|
|
70
|
+
display_name: "Charter Class"
|
|
71
|
+
mergeability: not_mergeable
|
|
72
|
+
domain_flavors: ["organization"]
|
|
73
|
+
examples: ["N", "SM", "NM", "SB", "SA"]
|
|
74
|
+
passive: true
|
|
75
|
+
|
|
76
|
+
- name: "regulatory_agency"
|
|
77
|
+
type: string
|
|
78
|
+
description: "Primary federal regulatory agency supervising this institution, derived from the REGAGNT field"
|
|
79
|
+
display_name: "Regulatory Agency"
|
|
80
|
+
mergeability: not_mergeable
|
|
81
|
+
domain_flavors: ["organization"]
|
|
82
|
+
examples: ["OCC", "FED", "FDIC"]
|
|
83
|
+
passive: true
|
|
84
|
+
|
|
85
|
+
- name: "established_date"
|
|
86
|
+
type: string
|
|
87
|
+
description: "Date the institution was established, reformatted from ESTYMD to YYYY-MM-DD"
|
|
88
|
+
display_name: "Established Date"
|
|
89
|
+
mergeability: not_mergeable
|
|
90
|
+
domain_flavors: ["organization"]
|
|
91
|
+
examples: ["1824-01-01", "1934-01-01"]
|
|
92
|
+
passive: true
|
|
93
|
+
|
|
94
|
+
- name: "fdic_insurance_date"
|
|
95
|
+
type: string
|
|
96
|
+
description: "Date the institution obtained FDIC deposit insurance, reformatted from INSDATE to YYYY-MM-DD"
|
|
97
|
+
display_name: "FDIC Insurance Date"
|
|
98
|
+
mergeability: not_mergeable
|
|
99
|
+
domain_flavors: ["organization"]
|
|
100
|
+
examples: ["1934-01-01", "2005-06-15"]
|
|
101
|
+
passive: true
|
|
102
|
+
|
|
103
|
+
- name: "active_flag"
|
|
104
|
+
type: float
|
|
105
|
+
description: "Whether the institution is currently active and operating (1.0 = active, 0.0 = inactive), derived from the ACTIVE field"
|
|
106
|
+
display_name: "Active Flag"
|
|
107
|
+
mergeability: not_mergeable
|
|
108
|
+
domain_flavors: ["organization"]
|
|
109
|
+
passive: true
|
|
110
|
+
|
|
111
|
+
- name: "holding_company_name"
|
|
112
|
+
type: string
|
|
113
|
+
description: "Name of the top-tier bank holding company, derived from the NAMEHCR field; omitted when the institution is independent"
|
|
114
|
+
display_name: "Holding Company Name"
|
|
115
|
+
mergeability: not_mergeable
|
|
116
|
+
domain_flavors: ["organization"]
|
|
117
|
+
examples: ["JPMORGAN CHASE&CO", "FIRST COMMUNITY BANCSHARES"]
|
|
118
|
+
passive: true
|
|
119
|
+
|
|
120
|
+
- name: "website"
|
|
121
|
+
type: string
|
|
122
|
+
description: "Primary website URL of the institution, derived from the WEBADDR field; omitted when blank"
|
|
123
|
+
display_name: "Website"
|
|
124
|
+
mergeability: not_mergeable
|
|
125
|
+
domain_flavors: ["organization"]
|
|
126
|
+
examples: ["www.jpmorganchase.com", "www.fcbanking.com"]
|
|
127
|
+
passive: true
|
|
128
|
+
|
|
129
|
+
- name: "fdic_geographic_region"
|
|
130
|
+
type: string
|
|
131
|
+
description: "FDIC supervisory region name, derived from the FDICREGN field"
|
|
132
|
+
display_name: "FDIC Geographic Region"
|
|
133
|
+
mergeability: not_mergeable
|
|
134
|
+
domain_flavors: ["organization"]
|
|
135
|
+
examples: ["Chicago", "Atlanta", "Dallas"]
|
|
136
|
+
passive: true
|
|
137
|
+
|
|
138
|
+
- name: "institution_category"
|
|
139
|
+
type: string
|
|
140
|
+
description: "FDIC specialization group description classifying the institution by size and type, derived from the SPECGRPN field"
|
|
141
|
+
display_name: "Institution Category"
|
|
142
|
+
mergeability: not_mergeable
|
|
143
|
+
domain_flavors: ["organization"]
|
|
144
|
+
examples: ["International Specialization", "ALL OTHER UNDER 1 BILLION", "ALL OTHER 1 TO 10 BILLION"]
|
|
145
|
+
passive: true
|
|
146
|
+
|
|
147
|
+
- name: "office_count"
|
|
148
|
+
type: float
|
|
149
|
+
description: "Total number of offices (branches) operated by the institution including domestic and foreign, derived from the OFFICES field"
|
|
150
|
+
display_name: "Office Count"
|
|
151
|
+
mergeability: not_mergeable
|
|
152
|
+
domain_flavors: ["organization"]
|
|
153
|
+
examples: ["5320.0", "1.0", "25.0"]
|
|
154
|
+
passive: true
|
|
155
|
+
|
|
156
|
+
- name: "former_name"
|
|
157
|
+
type: string
|
|
158
|
+
description: "A previous legal name of the entity"
|
|
159
|
+
display_name: "Former Name"
|
|
160
|
+
mergeability: not_mergeable
|
|
161
|
+
domain_flavors: ["organization"]
|
|
162
|
+
examples: ["Chemical Bank", "The Chase Manhattan Bank"]
|
|
163
|
+
passive: true
|
|
164
|
+
|
|
165
|
+
# --- Quarterly Financial Data (source: fdic) ---
|
|
166
|
+
# From FDIC BankFind Suite Financials API (Call Reports FFIEC 031/041/051).
|
|
167
|
+
# Shared properties (total_assets, total_liabilities, shareholders_equity,
|
|
168
|
+
# net_income) are converted from thousands to USD for cross-source
|
|
169
|
+
# compatibility. FDIC-specific properties remain in thousands of USD.
|
|
170
|
+
|
|
171
|
+
- name: "total_assets"
|
|
172
|
+
type: float
|
|
173
|
+
description: "Total assets"
|
|
174
|
+
display_name: "Total Assets"
|
|
175
|
+
mergeability: not_mergeable
|
|
176
|
+
domain_flavors: ["organization"]
|
|
177
|
+
passive: true
|
|
178
|
+
|
|
179
|
+
- name: "total_deposits"
|
|
180
|
+
type: float
|
|
181
|
+
description: "Total deposits held by the institution in thousands of USD as reported in Call Reports"
|
|
182
|
+
display_name: "Total Deposits"
|
|
183
|
+
mergeability: not_mergeable
|
|
184
|
+
domain_flavors: ["organization"]
|
|
185
|
+
passive: true
|
|
186
|
+
|
|
187
|
+
- name: "total_liabilities"
|
|
188
|
+
type: float
|
|
189
|
+
description: "Total liabilities"
|
|
190
|
+
display_name: "Total Liabilities"
|
|
191
|
+
mergeability: not_mergeable
|
|
192
|
+
domain_flavors: ["organization"]
|
|
193
|
+
passive: true
|
|
194
|
+
|
|
195
|
+
- name: "shareholders_equity"
|
|
196
|
+
type: float
|
|
197
|
+
description: "Total stockholders' or shareholders' equity"
|
|
198
|
+
display_name: "Shareholders Equity"
|
|
199
|
+
mergeability: not_mergeable
|
|
200
|
+
domain_flavors: ["organization"]
|
|
201
|
+
passive: true
|
|
202
|
+
|
|
203
|
+
- name: "net_income"
|
|
204
|
+
type: float
|
|
205
|
+
description: "Net income or loss for the reporting period"
|
|
206
|
+
display_name: "Net Income"
|
|
207
|
+
mergeability: not_mergeable
|
|
208
|
+
domain_flavors: ["organization"]
|
|
209
|
+
passive: true
|
|
210
|
+
|
|
211
|
+
- name: "net_loans_and_leases"
|
|
212
|
+
type: float
|
|
213
|
+
description: "Net loans and leases after deducting allowance for loan losses, in thousands of USD as reported in Call Reports"
|
|
214
|
+
display_name: "Net Loans and Leases"
|
|
215
|
+
mergeability: not_mergeable
|
|
216
|
+
domain_flavors: ["organization"]
|
|
217
|
+
passive: true
|
|
218
|
+
|
|
219
|
+
- name: "insured_deposits"
|
|
220
|
+
type: float
|
|
221
|
+
description: "Estimated FDIC-insured deposits (covered up to $250K per depositor) in thousands of USD"
|
|
222
|
+
display_name: "Insured Deposits"
|
|
223
|
+
mergeability: not_mergeable
|
|
224
|
+
domain_flavors: ["organization"]
|
|
225
|
+
passive: true
|
|
226
|
+
|
|
227
|
+
- name: "uninsured_deposits"
|
|
228
|
+
type: float
|
|
229
|
+
description: "Estimated deposits exceeding FDIC insurance coverage limits, in thousands of USD"
|
|
230
|
+
display_name: "Uninsured Deposits"
|
|
231
|
+
mergeability: not_mergeable
|
|
232
|
+
domain_flavors: ["organization"]
|
|
233
|
+
passive: true
|
|
234
|
+
|
|
235
|
+
- name: "return_on_assets"
|
|
236
|
+
type: float
|
|
237
|
+
description: "Return on assets: annualized net income as a percentage of average total assets"
|
|
238
|
+
display_name: "Return on Assets"
|
|
239
|
+
mergeability: not_mergeable
|
|
240
|
+
domain_flavors: ["organization"]
|
|
241
|
+
passive: true
|
|
242
|
+
|
|
243
|
+
- name: "return_on_equity"
|
|
244
|
+
type: float
|
|
245
|
+
description: "Return on equity: annualized net income as a percentage of average total equity capital"
|
|
246
|
+
display_name: "Return on Equity"
|
|
247
|
+
mergeability: not_mergeable
|
|
248
|
+
domain_flavors: ["organization"]
|
|
249
|
+
passive: true
|
|
250
|
+
|
|
251
|
+
- name: "net_interest_margin"
|
|
252
|
+
type: float
|
|
253
|
+
description: "Net interest margin: net interest income as a percentage of average earning assets"
|
|
254
|
+
display_name: "Net Interest Margin"
|
|
255
|
+
mergeability: not_mergeable
|
|
256
|
+
domain_flavors: ["organization"]
|
|
257
|
+
passive: true
|
|
258
|
+
|
|
259
|
+
- name: "number_of_employees"
|
|
260
|
+
type: float
|
|
261
|
+
description: "Total number of full-time equivalent employees as reported in Call Reports"
|
|
262
|
+
display_name: "Number of Employees"
|
|
263
|
+
mergeability: not_mergeable
|
|
264
|
+
domain_flavors: ["organization"]
|
|
265
|
+
passive: true
|
|
266
|
+
|
|
267
|
+
- name: "interest_income"
|
|
268
|
+
type: float
|
|
269
|
+
description: "Total interest income for the reporting period, in thousands of USD"
|
|
270
|
+
display_name: "Interest Income"
|
|
271
|
+
mergeability: not_mergeable
|
|
272
|
+
domain_flavors: ["organization"]
|
|
273
|
+
passive: true
|
|
274
|
+
|
|
275
|
+
- name: "interest_expense"
|
|
276
|
+
type: float
|
|
277
|
+
description: "Total interest expense for the reporting period, in thousands of USD"
|
|
278
|
+
display_name: "Interest Expense"
|
|
279
|
+
mergeability: not_mergeable
|
|
280
|
+
domain_flavors: ["organization"]
|
|
281
|
+
passive: true
|
|
282
|
+
|
|
283
|
+
# --- Failure Identifiers (source: fdic_failure) ---
|
|
284
|
+
|
|
285
|
+
- name: "fdic_financial_institution_number"
|
|
286
|
+
type: string
|
|
287
|
+
description: "FDIC Financial Institution Number assigned to a failed bank, derived from the FIN field in the Failures API"
|
|
288
|
+
display_name: "FDIC Financial Institution Number"
|
|
289
|
+
mergeability: not_mergeable
|
|
290
|
+
domain_flavors: ["organization"]
|
|
291
|
+
examples: ["2470", "10537"]
|
|
292
|
+
passive: true
|
|
293
|
+
|
|
294
|
+
# --- Failure Information (source: fdic_failure) ---
|
|
295
|
+
|
|
296
|
+
- name: "failure_date"
|
|
297
|
+
type: string
|
|
298
|
+
description: "Date the institution was closed by its chartering authority, reformatted from FAILDATE to YYYY-MM-DD"
|
|
299
|
+
display_name: "Failure Date"
|
|
300
|
+
mergeability: not_mergeable
|
|
301
|
+
domain_flavors: ["organization"]
|
|
302
|
+
examples: ["2026-01-30", "2025-06-27"]
|
|
303
|
+
passive: true
|
|
304
|
+
|
|
305
|
+
- name: "failure_resolution_type"
|
|
306
|
+
type: string
|
|
307
|
+
description: "Type of FDIC resolution action taken (e.g., P&A=Purchase and Assumption, PI=Purchase and Assumption Insured Deposits, PA=Purchase and Assumption All Deposits, PO=Payout)"
|
|
308
|
+
display_name: "Failure Resolution Type"
|
|
309
|
+
mergeability: not_mergeable
|
|
310
|
+
domain_flavors: ["organization"]
|
|
311
|
+
examples: ["P&A", "PI", "PA", "PO"]
|
|
312
|
+
passive: true
|
|
313
|
+
|
|
314
|
+
- name: "failure_estimated_loss"
|
|
315
|
+
type: float
|
|
316
|
+
description: "Estimated loss to the FDIC Deposit Insurance Fund from the institution's failure, in thousands of USD; may be updated as estimates are finalized"
|
|
317
|
+
display_name: "Failure Estimated Loss"
|
|
318
|
+
mergeability: not_mergeable
|
|
319
|
+
domain_flavors: ["organization"]
|
|
320
|
+
examples: ["23460.0", "30284.0"]
|
|
321
|
+
passive: true
|
|
322
|
+
|
|
323
|
+
- name: "failure_total_deposits"
|
|
324
|
+
type: float
|
|
325
|
+
description: "Total deposits held by the institution at the time of failure, in thousands of USD"
|
|
326
|
+
display_name: "Failure Total Deposits"
|
|
327
|
+
mergeability: not_mergeable
|
|
328
|
+
domain_flavors: ["organization"]
|
|
329
|
+
passive: true
|
|
330
|
+
|
|
331
|
+
- name: "failure_total_assets"
|
|
332
|
+
type: float
|
|
333
|
+
description: "Total assets held by the institution at the time of failure, in thousands of USD"
|
|
334
|
+
display_name: "Failure Total Assets"
|
|
335
|
+
mergeability: not_mergeable
|
|
336
|
+
domain_flavors: ["organization"]
|
|
337
|
+
passive: true
|
|
338
|
+
|
|
339
|
+
relationships:
|
|
340
|
+
- name: "is_located_at"
|
|
341
|
+
description: "An entity is located at, operates in, resides in, is headquartered in, was born in, visits, or died in a location"
|
|
342
|
+
display_name: "Located At"
|
|
343
|
+
mergeability: not_mergeable
|
|
344
|
+
domain_flavors: ["organization"]
|
|
345
|
+
target_flavors: ["location"]
|
|
346
|
+
examples: ["JPMorgan Chase Bank is located at Columbus, OH"]
|
|
347
|
+
passive: true
|
|
348
|
+
|
|
349
|
+
- name: "acquired_by"
|
|
350
|
+
description: "Links a failed institution to the acquiring institution that purchased its assets and/or assumed its deposits during FDIC resolution; derived from the BIDNAME field in the Failures API"
|
|
351
|
+
display_name: "Acquired By"
|
|
352
|
+
mergeability: not_mergeable
|
|
353
|
+
domain_flavors: ["organization"]
|
|
354
|
+
target_flavors: ["organization"]
|
|
355
|
+
examples: ["First Independence Bank acquired Metropolitan Capital B&T"]
|
|
356
|
+
passive: true
|