# financial-analyst.ai Waterfall Distribution

> financial-analyst.ai Waterfall Distribution is a paid API for AI agents from financial-analyst.ai, paid per call via x402, $3/call, status unknown (last checked 2026-10-11).

Computes LP/GP waterfall distributions across preferred return, GP catch-up, and multiple promote tiers, returning splits, IRR, MOIC, and per-period cash flow allocation.

## Facts

- Endpoint: POST https://financial-analyst.ai/waterfall/distribute?utm_source=zero.xyz
- Price: $3/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/financial-analyst-ai-5194eddf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1z5IBzBKE2XviLYE9eOCX

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 financial-analyst-ai-5194eddf -d '<json body>'
```

Example prompt: Run a waterfall distribution on this deal: $10M total equity split 90% LP / 10% GP, 8% preferred return, 100% GP catch-up to 20% promote, then a 30% GP promote above a 15% IRR hurdle, with cash flows of -$10M at close and $18M at exit after 5 years — give me the LP and GP splits, IRR, MOIC, and per-period allocation.

## When to prefer this

Choose this endpoint when you need a rigorous, multi-tier LP/GP waterfall model that handles preferred return, GP catch-up, and stacked promote tiers in a single call — ideal for private equity fund distributions, real estate joint ventures, or any partnership structure requiring precise per-period cash flow allocation alongside IRR and MOIC. Prefer this over a simple XIRR endpoint when partnership economics and carried interest splits are the primary output needed.

## Known failure modes

- Invalid or missing cash flow schedule returns 422 validation error
- Preferred return rate out of supported range returns 400 bad request
- Inconsistent LP/GP contribution percentages not summing to 100% returns 400
- Promote tier thresholds defined out of order or overlapping return 400
- Payment failure or insufficient USDC balance returns 402
- Malformed promote tier configuration returns 422
- Server-side computation timeout on very complex multi-tier structures returns 504

## How this service works

LP/GP waterfall distribution across preferred return, GP catch-up, and multiple promote tiers. Returns LP and GP splits, IRR, MOIC, and per-period cash flow allocation.

## Output

Returns LP and GP dollar distributions broken out by waterfall tier (preferred return, catch-up, promote tiers), overall IRR and MOIC for the deal, and a per-period cash flow allocation table showing how each period's distributions are split between LP and GP.

## Request schema (JSON Schema)

```json
{
 "type": "object"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/financial-analyst-ai-5194eddf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from financial-analyst.ai](https://www.zero.xyz/host/financial-analyst.ai/llms.txt)