Free Fed Liquidity API

The Fed balance sheet series traders watch, as JSON in dollars: total assets, securities held, bank reserves, the Treasury General Account, overnight reverse repo usage, and the three money market rates. Net liquidity is computed weekly from the components.

Endpoints

GET

/api/markets/fed-liquidity?limit=260

Weekly net liquidity with its components on each H.4.1 Wednesday, oldest first: date, assets, tga, rrp, reserves, net (all USD).

GET

/api/markets/fed-liquidity?series=SOFR&limit=500

One series, oldest first, with its name and unit. Series: WALCL, WSHOSHO, WRESBAL, RRPONTSYD, WTREGEN, SOFR, EFFR, IORB. Balances are USD, rates are percent.

GET

/api/markets/fed-liquidity/csv

Full weekly history of net liquidity and its components as CSV.

Example

import requests

r = requests.get("https://xoomar.com/api/markets/fed-liquidity", params={"limit": 8})
for week in r.json()["data"]:
    print(week["date"], round(week["net"] / 1e12, 3), "T")

Response Shape

Every endpoint returns the same JSON envelope: { data, updatedAt, source, docs }. The data field is an array of records with these fields:

Field	Type	Description
date	string (date)	H.4.1 Wednesday date
assets	number	Fed total assets, USD (WALCL)
tga	number	Treasury General Account, USD (WTREGEN)
rrp	number	Overnight reverse repo usage on that date, USD (RRPONTSYD)
reserves	number \| null	Reserve balances with Federal Reserve Banks, USD (WRESBAL)
net	number	assets minus tga minus rrp, USD

Series responses carry {series, name, unit, points: [{date, value}]}. FRED revises weekly levels; every morning's run rewrites the full series.

Numeric values arrive as strings where precision matters (prices, rates); parse with your language's decimal type for accounting-grade math. Rate limiting is fair-use per IP; a 429 response includes a Retry-After header. No authentication or API key needed. Attribution is appreciated: xoomar.com/markets.

Need more headroom? A free account raises your limit to 120 requests a minute with an X-API-Key header.

Dashboard →Macro API →Policy rates API →

Frequently Asked Questions

Where does the data come from?

FRED's public CSV endpoint for eight series published by the Federal Reserve Board and the New York Fed. No key is needed on either side.

Why are the weekly numbers dated Wednesday?

The H.4.1 reports balance sheet levels as of Wednesday and is released Thursday afternoon. The daily rates and RRP usage are dated the day they apply.

What are the rate limits?

30 requests per minute per IP without a key, 120 with a free account key.

Data on this page is provided for informational purposes only and is not financial advice. See our editorial policy.