nyfed_soma_holdings
Pack: nyfed-markets · Endpoint: https://gateway.pipeworx.io/nyfed-markets/mcp
No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/nyfed_soma_holdings for the schema, then POST the same URL with its arguments for the data.
System Open Market Account (SOMA) portfolio — the Fed’s own securities holdings from QE/reinvestment. view=summary (default) gives total by asset bucket (bills, notesbonds, mbs, agencies, tips) over time — the series to read for “SOMA runoff this month”. view=treasury/agency with as_of_date gives the full CUSIP-level holdings snapshot for that date (holding_type narrows to bills/notesbonds/frn/tips for treasury, or agency_debts/mbs/cmbs for agency). Pass cusip alone to look up one security’s full holdings history regardless of view. Publishes on a ~1-week lag (as_of_date defaults to the latest available, not today).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
view | string | no | Default summary. |
holding_type | string | no | For view=treasury: all|bills|notesbonds|frn|tips. For view=agency: all|agency_debts|mbs|cmbs. |
as_of_date | string | no | YYYY-MM-DD. Defaults to the latest published SOMA as-of date. |
cusip | string | no | A single security’s CUSIP — overrides view and searches both Treasury and Agency holdings. |
limit | number | no | Max rows to return. Default 20, max 200. |
Example call
Arguments
{
"view": "summary"
}
curl
curl -X POST https://gateway.pipeworx.io/nyfed-markets/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"nyfed_soma_holdings","arguments":{"view":"summary"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('nyfed_soma_holdings', {
"view": "summary"
});
Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"nyfed-markets": {
"url": "https://gateway.pipeworx.io/nyfed-markets/mcp"
}
}
}
See Getting Started for client-specific install steps.