{"uid":"cap_1bkbl47zk6_Sr9RQ9YXXa","slug":"finmath-future-value-of-annuity-c9965998","name":"finmath Future Value of Annuity","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/fv_annuity","method":"POST","headers":{},"bodySchema":{"type":"object","required":["payment","n_periods","rate_per_period"],"properties":{"due":{"type":"boolean","description":"due"},"payment":{"type":"number","description":"payment"},"n_periods":{"type":"number","description":"n_periods"},"rate_per_period":{"type":"number","description":"rate_per_period"}}},"responseSchema":{"type":"object","required":["result","meta"],"properties":{"meta":{"type":"object"},"result":{}}},"example":{"request":{"due":false,"payment":1000,"n_periods":10,"rate_per_period":0.05},"response":{"meta":{"tool":"fv_annuity","disclaimer":"Deterministic calculation utility. Not financial, investment, or trading advice.","deterministic":true},"result":12577.892535548839}},"exampleRequest":{"due":false,"payment":1000,"n_periods":10,"rate_per_period":0.05},"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_QlTlo0OYrSa_JbTgMoX04","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates the future value of an ordinary annuity or annuity-due given a periodic payment, number of periods, and interest rate per period.","exampleAgentPrompt":"What will my annuity be worth at the end if I make monthly payments of $500 for 10 years (120 periods) at a monthly rate of 0.4167%? Assume it's an ordinary annuity (not due).","exampleUseCases":null,"resultDescription":"Returns a JSON object with a 'result' field containing the computed future value of the annuity as a number, plus a 'meta' object with computation metadata such as the formula used and input echo.","failureModes":["Missing required fields (payment, n_periods, rate_per_period) returns a 400 or validation error","Non-numeric inputs for numeric fields cause a schema validation failure","Negative rate_per_period may produce unexpected or mathematically undefined results","Zero n_periods returns a trivial result or may error","Payment gateway failure (x402) if USDC payment cannot be processed"],"whenToPreferThis":"Use this endpoint when you need exact, deterministic future value of annuity arithmetic — especially when LLM-native math is unreliable for financial calculations. Prefer over manual calculation or LLM approximation when precision matters for financial planning, retirement projections, or structured product analysis. Works for both ordinary annuities and annuities-due via the 'due' flag.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:33:58.921Z","isFirstParty":false}