# PreReason Macro Liquidity Deep Dive

> PreReason Macro Liquidity Deep Dive is a paid API for AI agents from api.prereason.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-11).

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.

## Facts

- Endpoint: GET https://api.prereason.com/api/macro/liquidity?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/prereason-macro-liquidity-deep-dive-7198a255
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_t71EneHvZaB45cutnJ0wb

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability prereason-macro-liquidity-deep-dive-7198a255
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Net liquidity analysis. Fed balance, TGA, reverse repo decomposition. Monetary conditions and liquidity cycle data for macro trading agents.

## Output

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.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "format": "json",
   "briefing": "macro.liquidity"
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/prereason-macro-liquidity-deep-dive-7198a255/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.prereason.com](https://www.zero.xyz/host/api.prereason.com/llms.txt)