Portfolio Stats – Simple & Log Returns

Use this endpoint when you need quick, reliable calculation of period-by-period simple and log returns plus cumulative return from a raw price series, without building the arithmetic yourself. It is ideal for educational explorations, backtest preprocessing, or validating return calculations. Prefer it over the volatility or Sharpe endpoints when you only need the return series itself, not derived risk metrics.

• Fewer than 2 prices supplied — endpoint requires at least 2 values to compute returns
• Prices contain zero or negative values — all prices must be above zero
• Malformed prices string — if the JSON or comma-separated list cannot be parsed, the call fails
• Too many prices — more than 1000 values exceeds the allowed range
• Payment failure — x402 payment of $0.02 USDC not completed results in 402 response