Hermes Plant logo

Hermes Plant

Finance & quant APIs for AI agents

LP/GP distribution waterfalls for AI agents

WaterfallLens runs the standard private-capital distribution waterfall: return of capital, then preferred return, then GP catch-up, then the carried-interest split. It returns the exact LP and GP amounts, a per-tier b…

4 resources

What WaterfallLens computes, What you send, How an agent calls it

What WaterfallLens computes

WaterfallLens runs the standard private-capital distribution waterfall: return of capital, then preferred return, then GP catch-up, then the carried-interest split. It returns the exact LP and GP amounts, a per-tier breakdown, LP MOIC, GP carry, and the effective carry percentage.

What you send

Provide contributed capital, distributable cash, the carry and catch-up percentages, and the preferred return — either an explicit amount or a rate plus years with simple or compounded accrual. The endpoint solves the catch-up so the GP lands at exactly its carry share of total profit.

How an agent calls it

POST the deal terms to /api/agent-services/waterfall/distribute and pay $0.30 per call over x402. A fund-modeling or LP-reporting agent gets the precise split and tier table without re-implementing waterfall logic that is easy to get subtly wrong.

Why agents outsource this

Waterfalls have edge cases — loss scenarios, an unmet preferred, an incomplete catch-up — that a language model will paper over. WaterfallLens handles each explicitly with findings that explain the outcome.