# LP/GP Waterfall Distribution Calculator

> LP/GP Waterfall Distribution Calculator is a paid API for AI agents from financial-analyst-api-production-b81a.up.railway.app, paid per call via x402, $3/call, status unknown (last checked 2026-09-13).

Calculates penny-accurate LP/GP waterfall distributions across multiple periods with return of capital, preferred return, GP catch-up, and up to 5 promote tiers using IRR or MOIC hurdles

## Facts

- Endpoint: POST https://financial-analyst-api-production-b81a.up.railway.app/waterfall/distribute
- Price: $3/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lp-gp-waterfall-distribution-calculator-7248e38e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IkaGrmRnsf1Tv26Poq9Wu

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 lp-gp-waterfall-distribution-calculator-7248e38e -d '<json body>'
```

Example prompt: Run a waterfall distribution for my real estate fund: we have $5M in capital contributions, an 8% preferred return (ACT/365), a 20% GP catch-up, and a 3-tier promote structure with IRR hurdles at 10%, 15%, and 20% — here are the cash flows across 4 periods. Can you calculate how much goes to the LP vs GP at each stage?

## When to prefer this

Use this endpoint when you need penny-accurate LP/GP waterfall calculations for private equity or real estate funds, especially when modeling multiple distribution periods, tiered promotes with IRR or MOIC hurdles, and GP catch-up provisions. It is ACT/365 day count compliant matching Excel behavior, making it ideal for reconciling fund models. Prefer this over spreadsheet-based tools when you need programmatic, auditable waterfall outputs in an automated workflow.

## Known failure modes

- Missing or malformed cash flow data returns 400 validation error
- Invalid hurdle type (not IRR or MOIC) returns 400
- More than 5 promote tiers specified returns 400
- Payment of $3 USDC not received returns 402 payment required
- Periods with inconsistent date formats may cause day count errors
- Negative capital contributions or invalid percentages return 422

## 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

A period-by-period breakdown of cash distributions showing: return of capital amounts, preferred return accruals and payments, GP catch-up amounts, and allocations across up to 5 promote tiers — all computed to penny accuracy using Python Decimal with ACT/365 day count convention matching Excel behavior.

## Request schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lp-gp-waterfall-distribution-calculator-7248e38e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from financial-analyst-api-production-b81a.up.railway.app](https://www.zero.xyz/host/financial-analyst-api-production-b81a.up.railway.app/llms.txt)
