api_investment_return
Read-onlyIdempotent
Calculate deterministic stock, ETF and investment profit, fees, distributions and percentage return from user-provided assumptions; no market quotes or recommendations. One call costs 0.01 USDC on Base x402; customer-owned provider credentials use X-Provider-Key header where needed.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| shares | Yes | Number of shares, greater than zero | |
| exit_price | Yes | Assumed exit price per share, zero or greater | |
| total_fees | No | Combined entry and exit charges, default 0 | |
| entry_price | Yes | Assumed entry price per share, greater than zero | |
| distributions_total | No | Total received distributions or dividends, default 0 |