PreReason FX Liquidity Context API

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

{
  "date": "2026-06-12",
  "_timing": {
    "total_ms": 691,
    "computedAt": "2026-06-12T04:46:26.276Z",
    "metrics_ms": 491,
    "correlations_ms": 200,
    "tier_features_ms": 0
  },
  "metrics": {
    "dxy": {
      "name": "dxy",
      "trend": {
        "momentum": "steady",
        "change_7d": 0.43,
        "direction": "flat",
        "change_30d": 1.78,
        "change_90d": 0.83,
        "percentile": 50,
        "percentile_label": "average"
      },
      "signal": "below-trend",
      "context": "Dollar strength (UUP) stable at 27.95. Consolidating: neutral dollar backdrop.",
      "timestamp": "2026-06-11T19:45:14+00:00",
      "confidence": 56,
      "regulatory_mode": "descriptive",
      "value_formatted": "27.95",
      "confidence_label": "Medium",
      "confidence_factors": {
        "data_quality": 100,
        "signal_strength": 100,
        "percentile_score": 0,
        "trend_consistency": 20
      }
    },
    "cny-usd": {
      "name": "cny-usd",
      "trend": {
        "momentum": "steady",
        "change_7d": 0,
        "direction": "flat",
        "change_30d": -0.41,
        "change_90d": -1.89,
        "percentile": 49,
        "percentile_label": "average"
      },
      "signal": "at-trend",
      "context": "CNY/USD stable at 6.7655. Consolidating: Yuan conditions neutral.",
      "timestamp": "2026-06-05T00:00:00+00:00",
      "confidence": 65,
      "regulatory_mode": "descriptive",
      "value_formatted": "6.77",
      "confidence_label": "Medium",
      "confidence_factors": {
        "data_quality": 30,
        "signal_strength": 50,
        "percentile_score": 60,
        "trend_consistency": 100
      }
    },
    "eur-usd": {
      "name": "eur-usd",
      "trend": {
        "momentum": "steady",
        "change_7d": 0,
        "direction": "flat",
        "change_30d": -1.75,
        "change_90d": 0.4,
        "percentile": 46,
        "percentile_label": "average"
      },
      "signal": "at-trend",
      "context": "EUR/USD stable at 1.1533. Consolidating: FX conditions neutral.",
      "timestamp": "2026-06-05T00:00:00+00:00",
      "confidence": 64,
      "regulatory_mode": "descriptive",
      "value_formatted": "1.15",
      "confidence_label": "Medium",
      "confidence_factors": {
        "data_quality": 30,
        "signal_strength": 48,
        "percentile_score": 60,
        "trend_consistency": 100
      }
    },
    "bitcoin-price": {
      "name": "bitcoin-price",
      "trend": {
        "momentum": "steady",
        "change_7d": -0.2,
        "direction": "flat",
        "change_30d": -20.92,
        "change_90d": -10.57,
        "percentile": 69,
        "percentile_label": "above average"
      },
      "signal": "neutral",
      "context": "BTC at $63,626, flat over 7d. Consolidating.",
      "timestamp": "2026-06-12T04:42:29+00:00",
      "confidence": 49,
      "regulatory_mode": "signal",
      "value_formatted": "$63,626",
      "confidence_label": "Medium",
      "confidence_factors": {
        "data_quality": 100,
        "signal_strength": 42,
        "percentile_score": 22,
        "trend_consistency": 60
      }
    },
    "net-liquidity": {
      "name": "net-liquidity",
      "trend": {
        "momentum": "steady",
        "change_7d": 0.42,
        "direction": "flat",
        "change_30d": 1.14,
        "change_90d": 1.53,
        "percentile": 64,
        "percentile_label": "moderate growth"
      },
      "signal": "neutral",
      "context": "Net liquidity stable at $5.90T. Consolidating.",
      "timestamp": "2026-06-12T04:05:42.328+00:00",
      "confidence": 64,
      "regulatory_mode": "signal",
      "value_formatted": "$5.90T",
      "confidence_label": "Medium",
      "confidence_factors": {
        "data_quality": 100,
        "signal_strength": 44,
        "percentile_score": 32,
        "trend_consistency": 100
      }
    }
  },
  "correlations": {
    "eur-usd_vs_dxy": {
      "pair": "eur-usd_vs_dxy",
      "value": null,
      "metric1": "eur-usd",
      "metric2": "dxy",
      "interpretation": "Insufficient data (8 points, need 10+)",
      "unavailable_reason": "eur-usd has only 8 data points in 30-day window"
    },
    "dxy_vs_net-liquidity": {
      "pair": "dxy_vs_net-liquidity",
      "value": -0.05,
      "metric1": "dxy",
      "metric2": "net-liquidity",
      "interpretation": "No meaningful correlation (-0.05)"
    },
    "cny-usd_vs_net-liquidity": {
      "pair": "cny-usd_vs_net-liquidity",
      "value": 0.23,
      "metric1": "cny-usd",
      "metric2": "net-liquidity",
      "interpretation": "Weak positive correlation (+0.23)"
    },
    "eur-usd_vs_bitcoin-price": {
      "pair": "eur-usd_vs_bitcoin-price",
      "value": null,
      "metric1": "eur-usd",
      "metric2": "bitcoin-price",
      "interpretation": "Insufficient data (8 points, need 10+)",
      "unavailable_reason": "eur-usd has only 8 data points in 30-day window"
    }
  },
  "data_quality": {
    "severity": "ok",
    "health_score": 100,
    "metrics_total": 5,
    "metrics_available": 5,
    "correlations_total": 4,
    "unavailable_metrics": [],
    "correlations_computable": 4,
    "unavailable_correlations": []
  },
  "generated_at": "2026-06-12T04:46:26.276Z",
  "_tier_context": {
    "your_tier": "free",
    "related_briefings": [
      {
        "id": "fx.liquidity",
        "tier": "pro",
        "description": "Adds dollar and currency environment"
      },
      {
        "id": "fx.usd",
        "tier": "basic",
        "description": "Adds usd-as-currency briefing. uup dxy proxy + dtwexbgs broad trade-weighted dollar + real-rate-10y (10y nominal minus 10y breakeven) as the foundational driver, plus fed funds and 10y nominal as macro overlay. distinct from the macro briefings by being usd-currency-anchored with real-rate as the primary mechanism."
      },
      {
        "id": "fx.eur",
        "tier": "basic",
        "description": "Adds eur-native briefing: invesco currencyshares euro trust (fxe) plus eur/usd spot, ecb deposit facility rate (short end), germany 10y bund yield (long end), and eurozone m3 money supply (monetary aggregate). counterpart-bank policy depth provided via fed-ecb-spread for the dollar leg."
      },
      {
        "id": "fx.jpy",
        "tier": "basic",
        "description": "Adds jpy-native briefing: invesco currencyshares japanese yen trust (fxy) plus jpy/usd spot, boj short-term policy rate (short end), japan 10y jgb yield (long end, often anchored by yield curve control regime), and boj total assets (largest central-bank balance sheet relative to gdp). carry-trade context via fed-boj-spread, carry-trade-returns-proxy, and 1d carry velocity."
      },
      {
        "id": "fx.policy-divergence",
        "tier": "pro",
        "description": "Adds causal reasoning"
      },
      {
        "id": "fx.momentum",
        "tier": "pro",
        "description": "Adds causal reasoning"
      }
    ],
    "higher_tier_features": [
      "Causal reasoning (Pro)",
      "Regime classification (Pro)",
      "Divergence detection (Pro)",
      "Extended historical data from Jan 2025 (Basic+)",
      "Full historical data access (Pro)"
    ]
  },
  "briefing_used": "fx.liquidity",
  "briefing_metadata": {
    "name": "FX Liquidity",
    "tier": "pro",
    "data_access": "Today + last 30 days",
    "description": "Dollar and currency environment - EUR/USD, CNY/USD direction with net liquidity correlation",
    "metrics_count": 5,
    "correlations_count": 4,
    "earliest_usable_date": "1999-01-04",
    "correlations_window_days": 30
  }
}

{
  "type": "json",
  "example": {
    "context": "Bitcoin trading at $84,200, up 4.2% over 7 days...",
    "metrics": {
      "bitcoin_price": {
        "signal": "bullish",
        "trend_7d": 4.2,
        "confidence": 82
      }
    },
    "briefing": "btc.quick-check",
    "generated_at": "2026-03-17T12:00:00Z"
  }
}