# Fed SOMA Balance Sheet API > Live data on the Federal Reserve's balance sheet — the System Open Market Account (SOMA) — via the Federal Reserve Bank of New York's public markets API. SOMA is the portfolio of Treasury securities, agency debt and agency MBS the Fed holds, the asset side of the world's most important central-bank balance sheet, the thing that grows in QE and shrinks in QT. Get the latest weekly snapshot — total holdings and the breakdown across bills, notes and bonds, TIPS, FRNs, agency MBS, CMBS and agency debt. Pull the weekly time series back two decades to see every round of quantitative easing and tightening. Read the actual line-item securities the Fed owns — each CUSIP with its security type, maturity, coupon, par value held and share of the issue outstanding. Bucket the Treasury holdings by time to maturity, the profile that drives the pace of runoff. Live, no key, nothing stored. Distinct from money-market reference-rate, FX-rate, central-bank-policy and stock-index APIs — this is the size, composition and maturity of the Fed's actual securities portfolio. Perfect for rates, macro, fixed-income and analytics apps. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/fedsoma-api/..." ``` ## Pricing - **Free** (Free) — 5,000 calls/Mo, 2 req/s - **Starter** ($10/Mo) — 120,000 calls/Mo, 5 req/s - **Pro** ($28/Mo) — 780,000 calls/Mo, 12 req/s - **Business** ($68/Mo) — 4,300,000 calls/Mo, 30 req/s ## Endpoints ### Holdings #### `GET /v1/holdings` — Line-item securities the Fed holds **Parameters:** - `type` (query, optional, string) — treasury or agency Example: `treasury` - `limit` (query, optional, string) — Max 1-500 Example: `50` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/fedsoma-api/v1/holdings?type=treasury&limit=50" ``` **Response:** ```json { "data": { "type": "treasury", "count": 50, "source": "Federal Reserve (NY Fed SOMA)", "holdings": [ { "cusip": "912828YS3", "coupon": 1.75, "issuer": null, "maturity_date": "2029-11-15", "par_value_usd": 54497640800, "security_type": "NotesBonds", "percent_outstanding": 0.6154274172826583, "change_from_prior_week_usd": 0 }, { "cusip": "912828YB0", "coupon": 1.625, "issuer": null, "maturity_date": "2029-08-15", "par_value_usd": 47136916700, "security_type": "NotesBonds", "percent_outstanding": 0.5089353658393064, "change_from_prior_week_usd": 0 }, { "cusip": "91282CCB5", "coupon": 1.625, "issuer": null, "maturity_date": "2031-05-15", "par_value_usd": 44211784200, "security_type": "NotesBonds", "percent_outstanding": 0.299380202152112, "change_from_prior_week_usd": 0 }, { "cusip": "91282CDY4", "coupon": 1.875, "issuer": null, "maturity_date": "2032-02-15", "par_value_usd": 36207764200, " …(truncated, see openapi.json for full schema) ``` #### `GET /v1/maturity` — Holdings by time to maturity **Parameters:** - `type` (query, optional, string) — treasury or agency Example: `treasury` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/fedsoma-api/v1/maturity?type=treasury" ``` **Response:** ```json { "data": { "type": "treasury", "source": "Federal Reserve (NY Fed SOMA)", "buckets": [ { "bucket": "0-1y", "positions": 106, "share_pct": 21.3935, "par_value_usd": 933585979800 }, { "bucket": "1-5y", "positions": 154, "share_pct": 31.6017, "par_value_usd": 1379060541100 }, { "bucket": "5-10y", "positions": 56, "share_pct": 10.9965, "par_value_usd": 479874786600 }, { "bucket": "10-20y", "positions": 66, "share_pct": 23.9303, "par_value_usd": 1044290267800 }, { "bucket": "20y+", "positions": 49, "share_pct": 12.078, "par_value_usd": 527070005600 } ], "as_of_date": "2026-06-03", "total_par_usd": 4363881580900 }, "meta": { "timestamp": "2026-06-09T20:24:29.944Z", "request_id": "222e042f-6a19-4caf-9ae7-b78cade3a3da" }, "status": "ok", "message": "Maturity profile retrieved successfully", "success": true } ``` ### Balance #### `GET /v1/balance` — Latest SOMA snapshot **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/fedsoma-api/v1/balance" ``` **Response:** ```json { "data": { "source": "Federal Reserve (NY Fed SOMA)", "frn_usd": 18357825800, "mbs_usd": 1957187501265.1, "cmbs_usd": 7598700119.7, "tips_usd": 279041230200, "bills_usd": 469471926700, "total_usd": 6331014782284.8, "as_of_date": "2026-06-03", "agencies_usd": 2347000000, "notes_bonds_usd": 3597010598200, "tips_inflation_compensation_usd": 105411554928.19 }, "meta": { "timestamp": "2026-06-09T20:24:30.095Z", "request_id": "2975040e-19d0-47ac-bca7-378fa9ab0d5e" }, "status": "ok", "message": "Balance retrieved successfully", "success": true } ``` #### `GET /v1/history` — Weekly SOMA time series **Parameters:** - `limit` (query, optional, string) — Weeks, max ~1200 Example: `52` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/fedsoma-api/v1/history?limit=52" ``` **Response:** ```json { "data": { "count": 52, "source": "Federal Reserve (NY Fed SOMA)", "history": [ { "frn_usd": 18357825800, "mbs_usd": 1957187501265.1, "cmbs_usd": 7598700119.7, "tips_usd": 279041230200, "bills_usd": 469471926700, "total_usd": 6331014782284.8, "as_of_date": "2026-06-03", "agencies_usd": 2347000000, "notes_bonds_usd": 3597010598200, "tips_inflation_compensation_usd": 105411554928.19 }, { "frn_usd": 18357825800, "mbs_usd": 1957187501265.1, "cmbs_usd": 7598700119.7, "tips_usd": 279041230200, "bills_usd": 462895926700, "total_usd": 6324463782284.8, "as_of_date": "2026-05-27", "agencies_usd": 2347000000, "notes_bonds_usd": 3597035598200, "tips_inflation_compensation_usd": 104570610142.22 }, { "frn_usd": 18357825800, "mbs_usd": 1970040695527.8, "cmbs_usd": 7619857248.3, "tips_usd": 279041230200, "bills_usd": 459606926700, "total_usd": 6334049133676.1, "as_of_date": "2026-05-20", "agencies_usd": 2347000000, "notes_bonds_usd": 3597035598200, …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/fedsoma-api OpenAPI spec: https://www.oanor.com/api/fedsoma-api/openapi.json