ToolVet
81trust / 100

Irr

by Internal rate of return (IRR) in Onchain & crypto

x402 APIPassing, checked 3 h ago

Compute the internal rate of return (IRR) of a cashflow stream - the discount rate at which NPV = 0. Index 0 is treated as t=0 (typically the negative initial investment); indices 1..n are inflows in subsequent periods. Solved via Newton-Raphson with bisection fallback. Requires at least one positive and one negative cashflow (otherwise IRR is undefined). Multiple sign changes in the cashflows can produce multiple IRR roots - we return the first one found.

POST https://agent402.tools/api/irr

Last 30 days

All checks passedSome failedAll failedNot checked
Uptime
100%
Response time
189 ms typical, 189 ms slowest 5%
Last check
3 h ago
Next check
any minute now

How to call it

# See the payment challenge (nothing is charged)
curl -i -X POST "https://agent402.tools/api/irr" \
  -H "content-type: application/json" \
  -d '{"cashflows":[-1000,300,400,500,600]}'
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client().register(
  "eip155:8453",
  new ExactEvmScheme(privateKeyToAccount(process.env.AGENT_KEY)),
);
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? Preflight it first for $0.03:
// GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fagent402.tools%2Fapi%2Firr
const res = await pay("https://agent402.tools/api/irr", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({"cashflows":[-1000,300,400,500,600]}),
});
console.log(await res.json());

Example input

{
  "cashflows": [
    -1000,
    300,
    400,
    500,
    600
  ]
}

Example output

{
  "converged": true,
  "irr": 0.248883,
  "iterations": 6,
  "npvAtIrr": 0
}

Security scan

  • No findings. We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.

Recent checks

WhenResultHTTPTimePrice
3 h agoPassed402189 ms$0.001