@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.
Files changed (34) hide show
  1. package/commands/update_instructions.md +30 -23
  2. package/package.json +1 -1
  3. package/skills/data-model/SKILL.md +58 -0
  4. package/skills/data-model/edgar/DATA_DICTIONARY.md +306 -0
  5. package/skills/data-model/edgar/schema.yaml +1893 -0
  6. package/skills/data-model/fdic/DATA_DICTIONARY.md +243 -0
  7. package/skills/data-model/fdic/schema.yaml +356 -0
  8. package/skills/data-model/fred/DATA_DICTIONARY.md +313 -0
  9. package/skills/data-model/fred/schema.yaml +155 -0
  10. package/skills/data-model/gleif/DATA_DICTIONARY.md +211 -0
  11. package/skills/data-model/gleif/schema.yaml +254 -0
  12. package/skills/data-model/newsdata/schema.yaml +650 -0
  13. package/skills/data-model/overview.md +77 -0
  14. package/skills/data-model/polymarket/DATA_DICTIONARY.md +384 -0
  15. package/skills/data-model/polymarket/schema.yaml +601 -0
  16. package/skills/data-model/sanctions/DATA_DICTIONARY.md +140 -0
  17. package/skills/data-model/sanctions/schema.yaml +153 -0
  18. package/skills/data-model/stocks/DATA_DICTIONARY.md +122 -0
  19. package/skills/data-model/stocks/schema.yaml +131 -0
  20. package/skills/data-model/system_schema.yaml +71 -0
  21. package/skills/data-model/wikipedia/DATA_DICTIONARY.md +185 -0
  22. package/skills/data-model/wikipedia/schema.yaml +255 -0
  23. package/skills/elemental-api/SKILL.md +37 -0
  24. package/skills/elemental-api/articles.md +386 -0
  25. package/skills/elemental-api/entities.md +393 -0
  26. package/skills/elemental-api/events.md +145 -0
  27. package/skills/elemental-api/find.md +279 -0
  28. package/skills/elemental-api/graph.md +239 -0
  29. package/skills/elemental-api/llm.md +18 -0
  30. package/skills/elemental-api/overview.md +51 -0
  31. package/skills/elemental-api/relationships.md +310 -0
  32. package/skills/elemental-api/schema.md +379 -0
  33. package/skills/elemental-api/sentiment.md +93 -0
  34. 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