🏛️ Fed H.8 Bank Assets & Liabilities API — Weekly Bank Data

Get the Federal Reserve's H.8 Assets and Liabilities of Commercial Banks in the United States as clean records — bank credit, loans by type (real estate, commercial and industrial, consumer), securities, deposits, borrowings and more, for all, large, small and foreign-related banks, weekly, monthly, quarterly and annual — from the Board's official release package.

Bank analysts, investors, economists and treasury teams use H.8 as the weekly read on US bank lending and deposits. This actor reads the Board's file and delivers one record per value with the line item, bank group, adjustment and measure spelled out — no XML, no API key.

The unit of output is one observation (one series, one date). You pay per observation delivered; a run that finds nothing costs nothing.

📊 Sample Output

series_name	date	value	item	bank_group
B1026NCBA	2026-09-23	5840814.3	(11) Real estate loans	All Commercial Banks in the United States
B1026NCBA	2026-09-16	5836706.7	(11) Real estate loans	All Commercial Banks in the United States
B1026NCBA	2026-09-09	5832306.2	(11) Real estate loans	All Commercial Banks in the United States
B1026NCBA	2026-09-02	5829780.5	(11) Real estate loans	All Commercial Banks in the United States
B1026NCBA	2026-08-26	5832701.4	(11) Real estate loans	All Commercial Banks in the United States

Rows from live run TDDEiXwItaA3nYOaw on Apify (input: items 1058 and 1026, all commercial banks, seasonally adjusted, levels, weekly, since 2026). Notice the weekly Wednesday dates, newest first, and the H.8 line item named on every row (values in millions of dollars).

✅ What you get

Every field of each record:

• record_id — unique per observation: release, series code and date.
• release_code — H.8.
• series_name — the Board's series code, e.g. B1058NCBA.
• series_description, series_long_description — the Board's short and long descriptions.
• bank_group_code, bank_group — CB all commercial banks, DM domestically chartered, LG large domestic, SM small domestic, FR foreign-related.
• category_code, category — A assets, L liabilities, M memo.
• item_code, item — the H.8 line, e.g. 1058 = (34) Deposits.
• seasonal_adjustment_code, seasonal_adjustment — SA or NSA.
• measure_code, measure — LEVEL dollar levels or RATE percent change at an annual rate.
• frequency — Weekly (Wednesday), Monthly, Quarterly or Annual (from the Board's code list).
• unit, unit_multiplier, currency — unit and multiplier from the Board's code lists (e.g. Currency, Millions), and the currency where one applies.
• date — period end date as published (e.g. 2026-06-30 for the second quarter).
• value — the observation as a number.
• observation_status, observation_status_label — A normal; NC/ND not calculable / no data (delivered only with includeNoData).
• release, release_prepared — release name and when the Board prepared the package.
• source, source_dataset, licence, attribution, observed_at — provenance on every record: the Board and the release, the package file and its last-modified time, the Board's public-domain notice quoted, the citation the Board asks for, and the UTC read time.

⚙️ Sample inputs

1. Store example — deposits at all commercial banks

{
  "seriesNames": ["B1058NCBA"],
  "maxRecords": 10
}

The 10 newest weekly values of deposits, all commercial banks, seasonally adjusted; about $0.50 on the Free plan.

2. Narrowed — large vs small bank assets, weekly, 2026

{
  "bankGroups": ["LG", "SM"],
  "categories": ["A"],
  "measures": ["LEVEL"],
  "seasonalAdjustment": ["SA"],
  "frequencies": ["weekly"],
  "dateFrom": "2026",
  "maxRecords": 3000
}

Every weekly asset level this year for large and small domestically chartered banks.

3. Bulk — latest weekly value of every line, all banks

{
  "bankGroups": ["CB"],
  "frequencies": ["weekly"],
  "latestOnly": true,
  "maxRecords": 200
}

One record per weekly all-bank series: its newest week.

Input fields:

Field	Meaning
seriesNames	exact Board series codes, e.g. B1058NCBA
seriesNameStartsWith	series codes starting with any of these, e.g. B1058
descriptionContains	every word of an entry in the description; quote a phrase to keep it together
bankGroups	CB, DM, LG, SM, FR
categories	A, L, M
itemCodes	H.8 line items, e.g. 1001, 1026, 1058
seasonalAdjustment	SA, NSA
measures	LEVEL, RATE
frequencies	weekly, monthly, quarterly, annual
dateFrom / dateTo	date window
latestOnly	one record per series
includeNoData	also deliver not-calculable values
order	newest_first or oldest_first
maxRecords	most observations delivered and billed (default 1,000)

🧾 JSON sample record

{
  "record_id": "H8:B1026NCBA:2026-09-23",
  "release_code": "H.8",
  "series_name": "B1026NCBA",
  "series_description": "Real estate loans, all commercial banks, seasonally adjusted",
  "series_long_description": "Real estate loans, all commercial banks, seasonally adjusted",
  "bank_group_code": "CB",
  "bank_group": "All Commercial Banks in the United States",
  "category_code": "A",
  "category": "Assets",
  "item_code": "1026",
  "item": "(11) Real estate loans",
  "seasonal_adjustment_code": "SA",
  "seasonal_adjustment": "Seasonally adjusted",
  "measure_code": "LEVEL",
  "measure": "Levels (USD)",
  "frequency": "Weekly (Wednesday)",
  "unit": "Currency",
  "unit_multiplier": "Millions",
  "currency": "USD",
  "date": "2026-09-23",
  "value": 5840814.3,
  "observation_status": "A",
  "observation_status_label": "Normal",
  "release": "H.8 Assets and Liabilities of Commercial Banks in the United States",
  "release_prepared": "2026-10-02T10:00:00",
  "source": "Board of Governors of the Federal Reserve System — H.8 Assets and Liabilities of Commercial Banks in the United States (statistical release XML package)",
  "source_dataset": "FRB_h8_xml.zip (H8_data.xml), Last-Modified Fri, 02 Oct 2026 20:15:11 GMT",
  "licence": "Public domain. Federal Reserve Board: \"Unless otherwise indicated, information on Board's website is in the public domain and may be copied and distributed without permission. Please cite to the Board as the source of the information.\" (federalreserve.gov/disclaimer.htm)",
  "attribution": "Source: Board of Governors of the Federal Reserve System (US), H.8 Assets and Liabilities of Commercial Banks in the United States",
  "observed_at": "2026-10-04T05:12:34Z"
}

🔧 How it works

1. Robots check. www.federalreserve.gov/robots.txt is requested on every run. It answers with an HTML "page not found" (HTTP 404): no robots policy is published (FLAGGED). The actor records that and relies on the Board's public-domain notice; a real robots.txt that disallowed the package would stop the run with nothing charged.

2. Table of contents first. The release package FRB_h8_xml.zip is a static ZIP on the Board's H.8 release page. The actor reads its table of contents and code lists by byte range, then streams and decompresses the data file as it arrives.

3. Filter while reading. Each series is checked against your filters as soon as it starts; only matching series keep their observations.

4. Deliver, then charge. Matching observations (newest first by default) are pushed in batches, each charged after delivery, so records and charges always match. Reading stops at maxRecords or your maximum charge.

5. Receipt. RUN_RECEIPT records the robots result, the package and its date, bytes read, series matched, and delivered and charged counts.

No login, API key, proxy or bot workaround — one public Board file, and no personal data in it.

💰 Pricing example

Per observation delivered, no start fee, no monthly charge:

Apify plan	Price per observation
Free	$0.05
Bronze	$0.045
Silver	$0.04
Gold, Platinum, Diamond	$0.0335

• 10 observations (the Store example): $0.50 on the Free plan, $0.335 on Gold.
• 1,000 observations (the default cap): $50 on Free, $45 on Bronze, $40 on Silver, $33.50 on Gold.

Coverage and size. Live count from the package read on 3–4 October 2026 (FRB_h8_xml.zip, 8.4 MB compressed, Last-Modified 2 October 2026; release of 2 October 2026): 978,755 observations in 1,411 series (410 weekly, 607 monthly, 197 quarterly, 197 annual), from 1947-01-31 to 2026-09-23; 978,655 carry a value and 100 are marked not calculable. The planning index counted 978,755 observations across 1,411 series — they agree. A filter is required; a whole-file read takes seconds, and a full pull is 978,655 valued records, billed per observation.

⚖️ Legal & ToS

Data: Board of Governors of the Federal Reserve System, H.8 Assets and Liabilities of Commercial Banks in the United States, from the XML package on the Board's statistical release page. The Board's notice says: "Unless otherwise indicated, information on Board's website is in the public domain and may be copied and distributed without permission. Please cite to the Board as the source of the information." Every record carries that notice in licence and a citation in attribution.

Robots FLAG: www.federalreserve.gov/robots.txt returns a 404 page — no robots policy is published. That is recorded on every run and not treated as permission by itself; the public-domain notice governs reuse. One public file, declared User-Agent, no login, key, proxy or form. Aggregate statistics only — no personal data.

Data Download Program retirement: the Board is retiring its Data Download Program ("Build Your Package" goes the week of November 9, 2026; the program later). Its notice (16 July 2026) says historical data "will remain available for download as XML files on statistical release pages" — that release-page XML file is exactly what this actor reads, not the Data Download Program. If the Board ever moves or withdraws it, runs end with a source-unavailable message and nothing is charged.

Not affiliated with or endorsed by the Federal Reserve; figures are the Board's as published.

❓ FAQ

Do I need a FRED key or an account? No. The actor reads the Board's public release file, which needs no key, login or registration.

Why must I give a filter? The full release is 978,755 observations. A filter keeps runs fast and bills only what you asked for; an unfiltered run is refused with a clear message.

How fresh is the data? As fresh as the Board's H.8 package: every record carries the package's prepared time and last-modified date.

What happens when the Data Download Program retires? Nothing for this actor: it already reads the release-page XML file the Board says will remain available.

Which date is a weekly value for? The Wednesday of the week, as the Board publishes it (frequency = Weekly (Wednesday)).

🆘 Troubleshooting

• 0 records — check item codes against the H.8 release table numbers; bank groups are two letters.
• Growth rates mixed with levels — add measures: ["LEVEL"] or ["RATE"].
• Stopped at maxRecords — raise maxRecords or use latestOnly.
• SOURCE UNAVAILABLE message — the server did not answer after three tries; nothing was charged — run again later.
• CAPPED message — your maximum total charge was reached; raise it in the run options.

🔗 Related Actors

• US Credit Union Financial Records — NCUA — credit union call-report financials beside bank aggregates.
• Germany Bank Lending Survey - Bundesbank — German bank lending conditions.
• ECB Bank Lending & Deposit Rate Records — Euro Area MIR — euro-area bank lending and deposit rates.
• US Treasury Fiscal Records — Rates & Debt — US Treasury rates and debt.

🏢 About NexGen Signal — official-source data products from government and regulator publications. Browse the catalog: apify.com/nexgensignal

⭐ Found this useful?

If this actor saved you time, a rating on its Apify Store page helps other buyers find it.

Part of NexGen Signal — official-source data products.