{"uid":"cap_hJwl7MCHU1pc5TE8v5akY","slug":"api-quantoracle-dev-2fe6f6a5","name":"QuantOracle: Time Value of Money – Future Value Calculator","description":"QuantOracle: tvm/future-value","url":"https://api.quantoracle.dev/v1/tvm/future-value","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"rate":{"type":"number","title":"Rate","description":"Interest rate per period","exclusiveMinimum":-1},"payment":{"type":"number","title":"Payment","default":0,"description":"Periodic payment amount (annuity)"},"periods":{"type":"integer","title":"Periods","maximum":1000,"minimum":1,"description":"Number of periods"},"present_value":{"type":"number","title":"Present Value","default":0,"description":"Present lump sum to grow"},"payment_timing":{"enum":["end","begin"],"type":"string","title":"Payment Timing","default":"end","description":"Payment at end or beginning of period"}}},"responseSchema":null,"example":{"request":{"rate":0.05,"periods":10,"present_value":1000},"response":{"ms":7.42,"_meta":{"url":"https://quantoracle.dev","docs":"https://api.quantoracle.dev/docs","powered_by":"QuantOracle"},"future_value":1628.8946,"fv_of_annuity":0,"growth_factor":1.628895,"fv_of_lump_sum":1628.8946,"total_interest":628.8946,"total_payments":0}},"exampleRequest":{"rate":0.05,"periods":10,"present_value":1000},"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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_6-DhgPhS6gYrqR1bSI77o","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 future value of a lump sum or annuity given an interest rate, number of periods, and present value","exampleAgentPrompt":"What will $10,000 be worth after 10 years if I invest it at a 5% annual interest rate? Show me the total interest earned and the growth factor.","exampleUseCases":null,"resultDescription":"Returns the computed future value of the lump sum, growth factor, total interest accrued, future value of any annuity component, and total payments — along with response latency in milliseconds.","failureModes":["Missing required fields (rate, periods, present_value) returns 400 Bad Request","Negative periods or nonsensical rate values may return a validation error","Service unavailable returns 503","Payment failure or insufficient USDC balance blocks the request"],"whenToPreferThis":"Use this endpoint when you need a precise, fast, server-side TVM future value computation with detailed breakdown (growth factor, total interest, lump sum vs annuity split) rather than computing locally. Especially useful in automated financial planning agents or when auditable, consistent computation is required across many scenarios.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:43:23.510Z","isFirstParty":false}