{"uid":"cap_h3Kd1VpiqIG5KlMNlg8le","slug":"business-utils-agent-roi-calculator-f28cdfd8","name":"Business Utils Agent – ROI Calculator","description":"A comprehensive business utilities agent offering KPI calculations, ROI analysis, profit margin calculations, customer acquisition cost analysis, churn rate calculations, and AI-powered business plan reviews.","url":"https://business-utils-agent.up.railway.app/kpi/roi","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"cost":{"type":"number","description":"Cost or initial investment amount"},"gain":{"type":"number","description":"Gain or profit from the investment"}}},"responseSchema":{"type":"json","example":{"roi":1.5,"percentage":150}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_N9NB6ggLAVWPM10prjb-n","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates Return on Investment (ROI) given a cost and a gain, returning the ROI ratio and percentage.","exampleAgentPrompt":"Can you calculate the ROI for a campaign where we spent $5,000 and generated $12,500 in profit — what's the return on investment ratio and percentage?","exampleUseCases":[{"title":"Marketing campaign ROI evaluation","prompt":"We ran a paid ads campaign that cost us $8,000 and brought in $20,000 in revenue. Can you calculate the ROI ratio and percentage so I can report back to the team?"},{"title":"Capital equipment purchase ROI","prompt":"I bought a piece of machinery for $50,000 and it generated $75,000 in profit over the year. What's my ROI on that investment?"},{"title":"Software subscription profitability check","prompt":"We pay $1,200 a year for a SaaS tool and it saved us $4,500 in labor costs. Can you compute the ROI and percentage return on that spend?"}],"resultDescription":"Returns a JSON object with two fields: 'roi' (a decimal ratio, e.g. 1.5 meaning 150% return) and 'percentage' (the ROI expressed as a percentage, e.g. 150). Both represent how much return was achieved relative to the cost.","failureModes":["Missing 'cost' or 'gain' fields — returns a validation or 400 error","Cost of zero causing division-by-zero — may return an error or undefined result","Non-numeric inputs for cost or gain — likely returns a 422 or parsing error","Negative gain inputs (loss scenarios) — may return a negative ROI, check if supported","Service downtime on Railway hosting — returns 503 or connection timeout"],"whenToPreferThis":"Use this endpoint when you need a quick, reliable ROI ratio and percentage from a known cost and gain figure. It is ideal for agents automating business reporting, KPI dashboards, or financial decision support where ROI is a required metric. Prefer this over spreadsheet calculations when building automated pipelines or when other KPI endpoints on this service are already in use.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:36:47.222Z","isFirstParty":false}