{"uid":"cap_t71EneHvZaB45cutnJ0wb","slug":"prereason-macro-liquidity-deep-dive-7198a255","name":"PreReason Macro Liquidity Deep Dive","description":"Net liquidity analysis. Fed balance, TGA, reverse repo decomposition. Monetary conditions and liquidity cycle data for macro trading agents.","url":"https://api.prereason.com/api/macro/liquidity?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Historical date in YYYY-MM-DD format. A paid call serves today or any ?date= on record."},"format":{"enum":["json","markdown"],"type":"string","description":"Response format. markdown is token-optimized for LLMs, json is structured. Default is markdown."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"metrics":{"tga":{"name":"tga"},"m2-supply":{"name":"m2-supply"},"fed-balance":{"name":"fed-balance"},"bank-reserves":{"name":"bank-reserves"},"net-liquidity":{"name":"net-liquidity"},"nyfed-rrp-daily":{"name":"nyfed-rrp-daily"},"nyfed-soma-total":{"name":"nyfed-soma-total"},"bis-global-liquidity-usd":{"name":"bis-global-liquidity-usd"}},"briefing_used":"macro.liquidity","briefing_metadata":{"name":"Liquidity Momentum","description":"One state of US dollar liquidity (adding, steady or draining, from net liquidity's 30 day change) with its drivers, their sources and known times, bank reserves from the Federal Reserve Board's H.4.1, and repo against the Fed's range; plus Fed balance, Treasury General Account, M2 money supply, composite net liquidity tracking with 7d/30d/90d trend changes and percentile rankings, NY Fed System Open Market Account (SOMA) total holdings, and daily reverse-repo take-up as the collateral-cash imbalance signal","metrics_count":8,"correlations_count":4}}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"format":"json","briefing":"macro.liquidity"}}},"response":{"date":"2026-06-18","_timing":{"total_ms":405,"computedAt":"2026-06-18T06:03:40.052Z","metrics_ms":289,"correlations_ms":116,"tier_features_ms":0},"metrics":{"tga":{"name":"tga","trend":{"momentum":"steady","change_7d":0,"direction":"flat","change_30d":5.99,"change_90d":-5.26,"percentile":92,"percentile_label":"extremely high"},"signal":"above-trend","context":"Treasury General Account at $828.12B, up 6.0% over 30d. Accelerating: draining liquidity from system.","timestamp":"2026-06-10T00:00:00+00:00","confidence":81,"regulatory_mode":"descriptive","value_formatted":"$828.12B","confidence_label":"High","confidence_factors":{"data_quality":30,"signal_strength":100,"percentile_score":100,"trend_consistency":60}},"m2-supply":{"name":"m2-supply","trend":{"momentum":"steady","change_7d":0,"direction":"flat","change_30d":0,"change_90d":0,"percentile":100,"percentile_label":"extremely high"},"signal":"above-trend","context":"M2 money supply stable at $22.80T. Consolidating: neutral monetary conditions.","timestamp":"2026-04-01T00:00:00+00:00","confidence":69,"regulatory_mode":"descriptive","value_formatted":"$22.80T","confidence_label":"Medium","confidence_factors":{"data_quality":30,"signal_strength":100,"percentile_score":100,"trend_consistency":20}},"fed-balance":{"name":"fed-balance","trend":{"momentum":"steady","change_7d":0,"direction":"flat","change_30d":0.18,"change_90d":1.04,"percentile":79,"percentile_label":"high"},"signal":"at-trend","context":"Fed balance sheet stable at $6.73T, +0.2% over 30d. Consolidating: neutral liquidity conditions.","timestamp":"2026-06-10T00:00:00+00:00","confidence":49,"regulatory_mode":"descriptive","value_formatted":"$6.73T","confidence_label":"Medium","confidence_factors":{"data_quality":30,"signal_strength":38,"percentile_score":2,"trend_consistency":100}},"net-liquidity":{"name":"net-liquidity","trend":{"momentum":"steady","change_7d":0.94,"direction":"flat","change_30d":0.13,"change_90d":1.52,"percentile":81,"percentile_label":"above-average growth"},"signal":"neutral","context":"Net liquidity stable at $5.89T. Consolidating.","timestamp":"2026-06-18T05:05:42.455+00:00","confidence":55,"regulatory_mode":"signal","value_formatted":"$5.89T","confidence_label":"Medium","confidence_factors":{"data_quality":100,"signal_strength":38,"percentile_score":0,"trend_consistency":100}}},"correlations":{"tga_vs_net-liquidity":{"pair":"tga_vs_net-liquidity","value":-0.03,"metric1":"tga","metric2":"net-liquidity","interpretation":"No meaningful correlation (-0.03)"},"fed-balance_vs_net-liquidity":{"pair":"fed-balance_vs_net-liquidity","value":0.31,"metric1":"fed-balance","metric2":"net-liquidity","interpretation":"Weak positive correlation (+0.31)"}},"data_quality":{"severity":"ok","health_score":100,"metrics_total":4,"metrics_available":4,"correlations_total":2,"unavailable_metrics":[],"correlations_computable":2,"unavailable_correlations":[]},"generated_at":"2026-06-18T06:03:40.052Z","_tier_context":{"your_tier":"free","related_briefings":[{"id":"macro.liquidity","tier":"basic","description":"Adds fed balance, treasury general account, m2 money supply, and composite net liquidity tracking with 7d/30d/90d trend changes and ytd percentile rankings"},{"id":"macro.auctions","tier":"basic","description":"Adds bid-to-cover ratios for the most recent 10y and 30y treasury auctions, indirect bidder share, primary dealer takedown, and days to the next scheduled auction"},{"id":"macro.calendar","tier":"basic","description":"Adds weekly macro release calendar: us core data (nfp, unemployment, cpi, weekly initial jobless claims) plus atlanta fed gdpnow nowcast of current-quarter real gdp, upcoming treasury auction calendar, and current fed funds rate. international scope: top print per major non-us economy (eurozone hicp, china cpi, boj policy rate). usa-weighted, 10 metrics, intentionally curated rather than exhaustive: surfaces the data points that move markets each week without overwhelming."},{"id":"macro.rates","tier":"pro","description":"Adds causal reasoning, narrative analysis"}],"higher_tier_features":["Causal reasoning (Pro)","Narrative analysis (Pro)","Regime classification (Pro)","Divergence detection (Pro)","Historical context (Pro)","Extended historical data from Jan 2025 (Basic+)","Full historical data access (Pro)"]},"briefing_used":"macro.liquidity","briefing_metadata":{"name":"Liquidity Momentum","tier":"basic","data_access":"Today + last 30 days","description":"Fed balance, Treasury General Account, M2 money supply, and composite net liquidity tracking with 7d/30d/90d trend changes and YTD percentile rankings","metrics_count":4,"correlations_count":2,"earliest_usable_date":"2002-12-18","correlations_window_days":90}}},"exampleRequest":{"format":"json","briefing":"macro.liquidity"},"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CbIg70Qb3x-w3YyMy1Y7P","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a detailed breakdown of macro net liquidity including Fed balance sheet decomposition, Treasury General Account (TGA), and Reverse Repo (RRP) dynamics with trend signals.","exampleAgentPrompt":"Pull me PreReason's macro liquidity deep dive for today — I want the full net liquidity formula breakdown with TGA, RRP, and Fed balance sheet decomposition in markdown format.","exampleUseCases":null,"resultDescription":"A structured briefing containing the computed net liquidity figure, decomposed Fed balance sheet components, TGA and RRP balances, trend direction signals, and confidence scores — available as JSON or token-optimized markdown.","failureModes":["Missing or invalid briefing param returns 400 error","Date out of tier access range returns 403 or empty data","Invalid date format (not YYYY-MM-DD) returns validation error","Unpaid or expired x402 payment returns 402 Payment Required","Requesting a Tier 2 briefing without appropriate subscription returns access error"],"whenToPreferThis":"Choose this endpoint when you need a structured, signal-rich breakdown of macro net liquidity specifically — covering the Fed balance sheet, TGA, and RRP components — rather than a broader macro snapshot or cross-asset overview. Ideal for agents tracking monetary policy transmission and liquidity cycle phases.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:44:35.115Z","isFirstParty":false,"canonicalSlug":"prereason-macro-liquidity-deep-dive-7198a255"}