# x402stock US Net Liquidity Percentile & Macro Gauge

> x402stock US Net Liquidity Percentile & Macro Gauge is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns the current US net liquidity (Fed balance sheet minus TGA minus reverse repo) as a 0–100 percentile score with label, 4-week trend, FRED component breakdown, and up to 520 weeks of history.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/fear-greed/liquidity
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-us-net-liquidity-percentile-macro-gauge-e1d86a8a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QSBF8Zxq4MFDl88s1ucpU

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 x402stock-us-net-liquidity-percentile-macro-gauge-e1d86a8a
```

Example prompt: What's the current US net liquidity percentile score right now — is liquidity expanding or contracting — and can you show me the FRED component breakdown plus the last 52 weeks of history?

## When to prefer this

Use this endpoint when you need a single normalized macro-liquidity gauge that synthesizes Fed balance sheet, TGA, and reverse repo into one 0–100 percentile score with historical context. Prefer it over raw FRED queries when you want pre-computed trend signals, percentile ranking, and component decomposition in one call. Complements the /api/v1/fed-funds endpoint for a fuller macro picture.

## Known failure modes

- Invalid weeks parameter (<=0 or >520) returns a validation error
- FRED data source unavailable causes stale or null component values
- Score or rating returned as null if insufficient data to compute percentile
- Network timeout if FRED upstream is slow

## How this service works

US net liquidity (Fed balance sheet minus Treasury General Account minus reverse repo) as a 0–100 percentile with its label and 4-week trend, broken into its FRED components (WALCL, TGA, RRP, M2) plus ~52 weeks of history. A macro-liquidity gauge for risk appetite. Complements the /api/v1/fed-funds and other FRED macro endpoints. From x402stock, a market & economic data API (x402, USDC).

## Output

Returns a JSON object with: source identifier, as_of date, net liquidity score (0–100 percentile), rating label (e.g. 'Extreme Fear', 'Greed'), current net liquidity in USD trillions, 4-week trend in USD trillions, trend label, an array of FRED components (WALCL, TGA, RRP, M2) each with name, value, date, FRED series ID, and month-over-month percent change, and a history array of weekly net liquidity readings (date + net_usd_trillions).

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "weeks": 52
  }
 }
}
```

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "weeks"
     ],
     "properties": {
      "weeks": {
       "type": "integer",
       "default": 52,
       "maximum": 520,
       "exclusiveMinimum": 0
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "source",
      "as_of",
      "score",
      "rating",
      "net_liquidity_usd_trillions",
      "trend_4w_usd_trillions",
      "trend_label",
      "components",
      "history"
     ],
     "properties": {
      "as_of": {
       "type": "string"
      },
      "score": {
       "anyOf": [
        {
         "type": "number"
        },
        {
         "type": "null"
        }
       ]
      },
      "rating": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "null"
        }
       ]
      },
      "source": {
       "type": "string",
       "const": "x402stock"
      },
      "history": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "date",
         "net_usd_trillions"
        ],
        "properties": {
         "date": {
          "type": "string"
         },
         "net_usd_trillions": {
          "anyOf": [
           {
            "type": "number"
           },
           {
            "type": "null"
           }
          ]
         }
        },
        "additionalProperties": false
       }
      },
      "components": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "name",
         "value_usd_trillions",
         "date",
         "fred_series",
         "mom_percent"
        ],
        "properties": {
         "date": {
          "type": "string"
         },
 
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-06-05T00:00:00.000Z",
  "score": 42,
  "rating": "Neutral",
  "source": "x402stock",
  "history": [
   {
    "date": "2025-01-08",
    "net_usd_trillions": 6.033
   }
  ],
  "components": [
   {
    "date": "2026-05-27",
    "name": "Fed Balance Sheet",
    "fred_series": "WALCL",
    "mom_percent": null,
    "value_usd_trillions": 6.704
   },
   {
    "date": "2026-04-01",
    "name": "M2 Money Supply",
    "fred_series": "M2SL",
    "mom_percent": 0.52,
    "value_usd_trillions": 22.8
   }
  ],
  "trend_label": "Expanding",
  "trend_4w_usd_trillions": 0.155,
  "net_liquidity_usd_trillions": 5.872
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-us-net-liquidity-percentile-macro-gauge-e1d86a8a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)