{"uid":"cap_Kz1CzQCp37MlncUnseI5A","slug":"finmath-xirr-calculator-dbfe54d5","name":"finmath XIRR Calculator","description":"Deterministic finance and crypto math for AI agents: TradFi (NPV, IRR, XIRR, Black-Scholes + Greeks, bonds, VaR, Sharpe) and DeFi (impermanent loss, perp liquidation, funding, Uniswap v3, health factor, cost basis). Exact, model-free arithmetic that LLMs get wrong — priced per call in USDC.","url":"https://finmath.qzqh5rrbkz.workers.dev/v1/xirr","method":"POST","headers":{},"bodySchema":{"type":"object","required":["dates","cashflows"],"properties":{"dates":{"type":"array","description":"dates"},"cashflows":{"type":"array","description":"cashflows"}}},"responseSchema":{"type":"object","required":["result","meta"],"properties":{"meta":{"type":"object"},"result":{}}},"example":{"request":{"dates":["2023-01-01","2023-06-30","2024-01-01"],"cashflows":[-10000,5000,6000]},"response":{"meta":{"tool":"xirr","disclaimer":"Deterministic calculation utility. Not financial, investment, or trading advice.","deterministic":true},"result":0.1325637870716075}},"exampleRequest":{"dates":["2023-01-01","2023-06-30","2024-01-01"],"cashflows":[-10000,5000,6000]},"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_YL_Bu6r2XpUgEoJR7fsUE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes the Extended Internal Rate of Return (XIRR) for irregular cash flow series with exact, deterministic arithmetic","exampleAgentPrompt":"Calculate the XIRR for an investment where I put in $10,000 on 2021-01-15, received $2,500 on 2021-08-20, got $4,000 on 2022-03-10, and finally $6,000 on 2023-06-01 — what's my annualized rate of return?","exampleUseCases":null,"resultDescription":"Returns a JSON object with a 'result' field containing the XIRR as a decimal (annualized rate of return) and a 'meta' object with computation details such as iteration count or convergence information.","failureModes":["No sign change in cash flows (all positive or all negative) — XIRR cannot converge, returns error","Insufficient data points — fewer than two dated cash flows provided","Date and cashflow arrays of mismatched length — returns validation error","Non-convergence if cash flows are pathological — algorithm fails to find a root","Invalid date format in dates array — returns parse error","Payment required (402) if USDC payment header is missing or insufficient"],"whenToPreferThis":"Use this endpoint when you need exact, deterministic XIRR computation for cash flows occurring on irregular dates — especially when LLM arithmetic would be unreliable. Prefer it over generic IRR calculators when dates are non-periodic (e.g., private equity distributions, real estate cash flows, VC investments, personal investment tracking). Ideal for AI agents that need a single authoritative numeric result they can trust without verification.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:52:42.946Z","isFirstParty":false}