{"uid":"cap_W8gigd4-eVxmEfSVM_4aQ","slug":"return-on-average-equity-distribution-histogram-a660ddf1","name":"Return on Average Equity Distribution Histogram","description":"Return on average equity - Distribution histogram: Bin up to 200 calculated observations into equal-width bins, including edge definitions. Metric: Return on average equity. Supplied figures only; returns JSON with formula, units and limitations. One of 50 calculators with 20 analysis modes. No live feed, financial advice or trade execution. 0.01 USDC includes one bounded distribution histogram report.","url":"https://market.datapackvibe.com/x402/assistant-finance-return-equity-histogram?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"bins":{"type":"integer","default":5,"maximum":30,"minimum":1},"rows":{"type":"array","items":{"type":"object","required":["net_income","average_equity"],"properties":{"net_income":{"type":"number","default":3000,"maximum":1000000000000,"minimum":-1000000000000,"description":"Amount in a consistent supplied currency and reporting period"},"average_equity":{"type":"number","default":20000,"maximum":1000000000000,"minimum":0,"description":"Amount in a consistent supplied currency and reporting period","exclusiveMinimum":0}},"additionalProperties":false},"default":[{"net_income":3000,"average_equity":20000},{"net_income":3300.0000000000005,"average_equity":22000},{"net_income":3000,"average_equity":20000},{"net_income":3300.0000000000005,"average_equity":22000}],"maxItems":200,"minItems":2}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JwjQBfk9RzkG4dig9sq-u","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Bins up to 200 return-on-average-equity (ROAE) observations into equal-width histogram buckets with edge definitions, formula, units, and limitations.","exampleAgentPrompt":"Bin these 12 company ROAE observations into 8 equal-width histogram buckets — net incomes are [3000, 3500, 2800, 4100, 3900, 2500, 4500, 3200, 3700, 2900, 4200, 3100] and average equities are [20000, 22000, 18000, 25000, 24000, 17000, 27000, 21000, 23000, 19000, 26000, 20500] — and give me the bin edges, counts, the formula used, and any limitations.","exampleUseCases":[{"title":"Portfolio ROAE spread analysis","prompt":"I have return data for 50 companies — net incomes and average equities for each — and I want to see how their return on average equity is distributed. Can you bin them into 10 equal-width histogram buckets and tell me the bin edges and counts?"},{"title":"Peer benchmarking distribution report","prompt":"Take these 30 quarterly ROAE observations from our industry peer group and split them into 6 histogram bins so I can see where most companies cluster. Here are the net income and average equity figures for each quarter."},{"title":"Single-company multi-period ROAE histogram","prompt":"I have 24 months of data for one company — monthly net income and average equity — and I want a 5-bin histogram of their return on average equity over time, including the formula and any limitations in the output."}],"resultDescription":"Returns a JSON object containing the histogram bin definitions (edges and counts) for the calculated ROAE observations, along with the formula used (net income / average equity), units, and stated limitations of the calculation. Up to 30 bins can be specified across up to 200 input rows.","failureModes":["Fewer than 2 rows supplied — minimum 2 observations required","average_equity value of zero or below — field requires exclusiveMinimum > 0","More than 200 rows submitted — exceeds maximum item count","Bins parameter outside 1–30 range — clamped or rejected","Missing required fields net_income or average_equity on any row — validation error","Payment of 0.01 USDC not completed — 402 Payment Required response"],"whenToPreferThis":"Choose this endpoint when you need a bounded frequency distribution (histogram) of return-on-average-equity values across multiple observations — companies, periods, or funds. It is ideal when you have pre-collected net income and average equity figures and want binned distribution output with metadata (formula, units, limitations) rather than a single-point ratio calculation. Prefer it over a simple ROAE calculator when you need statistical spread insight across a dataset of 2–200 observations.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-22T12:46:49.925Z","isFirstParty":false,"canonicalSlug":"return-on-average-equity-distribution-histogram-a660ddf1"}