XOOMAR

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, license, attribution, meta }. In meta, source names who publishes the data and sourceAttribution is the credit line to show with it. The data field is an array of records with these fields:

FieldTypeDescription
datestring (date)H.4.1 Wednesday date
assetsnumberFed total assets, USD (WALCL)
tganumberTreasury General Account, USD (WTREGEN)
rrpnumberOvernight reverse repo usage on that date, USD (RRPONTSYD)
reservesnumber | nullReserve balances with Federal Reserve Banks, USD (WRESBAL)
netnumberassets minus tga minus rrp, USD

Series responses carry {series, name, unit, points: [{date, value}]}. Past weekly values can change when the Fed revises them.

Numeric fields typed string in the table carry exact decimals; parse them with your language's decimal type. No key needed to start: 10 requests a minute per IP without a key and 30 a minute with a free account key, with at least six months of history. A 429 response carries a Retry-After header in seconds. Credit XOOMAR with a link to the dataset page when you republish the data; the data terms are on the terms page.

A free account key raises the limit; send it in an X-API-Key header.

Frequently Asked Questions

Where does the data come from?
Eight series published by the Federal Reserve Board (the H.4.1 release and the interest rate on reserve balances) and the New York Fed (SOFR, EFFR and overnight reverse repo usage).
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?
10 requests a minute per IP without a key and 30 a minute with a free account key, with at least six months of history.

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