Endpoint

When does this account actually hit zero?

Days-to-zero, 30-day funding gap, and mobilization-time signal—returned as structured fields on this route.

Answer when cash hits zero and what funding you need in the next thirty days if trends hold.

POST /api/v1/liquidity-runout-forecast

What it returns

Calendar-time path to zero cash and the 30-day funding gap if recent daily net continues — treasury-grade triage in one response.

Structured fields: runway_stable, estimated_days_to_zero_balance, projected_balance_30d_minor, funding_gap_30d_minor, treasury_war_room_hours_recommended_next_30d, methodology_note

Responses always include a template-generated narrative string alongside structured — safe to show to non-technical stakeholders when you need a spoken summary.

Response shape

Every successful response includes the same top-level keys: endpoint, account_id, processing (ephemeral mode + note), structured, and narrative.

Structured subfields for this route: runway_stable, estimated_days_to_zero_balance, projected_balance_30d_minor, funding_gap_30d_minor, treasury_war_room_hours_recommended_next_30d, methodology_note

Minimal example

{
  "endpoint": "liquidity-runout-forecast",
  "account_id": "acct_demo_001",
  "processing": {
    "mode": "ephemeral",
    "note": "Cashytics processes this request in memory only. Your payload is not stored as a ledger of record after the response is sent."
  },
  "structured": {
    "runway_stable": true,
    "estimated_days_to_zero_balance": null,
    "projected_balance_30d_minor": 530000,
    "funding_gap_30d_minor": 0,
    "treasury_war_room_hours_recommended_next_30d": 0,
    "methodology_note": "Window net is non-negative on average — no linear path to zero; still stress-test discrete outflow spikes separately."
  },
  "narrative": "Liquidity runway\nStatus: Net supportive over the observed window\n30d projected balance: 530000 minor units\n\nThis narrative is generated from structured signals using fixed templates."
}

Minimal curl

curl -sS -X POST "https://api.cashytics.com/api/v1/liquidity-runout-forecast" \
  -H "Authorization: Bearer cyt_live_YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d @envelope.json

Use the same envelope.json for every endpoint — add optional blocks when this route requires them.

← All endpoints