Workflows

Options Dashboard

Use these endpoints together when building an options dashboard for a single symbol:

  1. GET /options/chain to discover available expirations and inspect contracts.
  2. GET /options/iv for volatility smile and term structure.
  3. GET /options/expected-move for expiration-level move estimates.
  4. GET /options/open-interest for strike and expiry concentration.
  5. GET /options/uoa for unusual options activity.
  6. GET /greeks/gex for gamma exposure and zero level.

Recommended starting parameters:

ticker=SPY
range_pct=0.15
basis=open_interest

Portfolio Analytics

Use GET /quant/portfolio-optimizer for allocation and GET /quant/risk for asset-versus-benchmark risk.

Example portfolio optimizer request:

curl "https://perspicium.com/api/v0/quant/portfolio-optimizer?tickers=SPY&tickers=QQQ&tickers=TLT&objective=sharpe&period=5y" \
  -H "Authorization: ApiKey $PERSPICIUM_API_KEY"

Then inspect:

  • weights
  • risk_contributions
  • port_return
  • port_vol
  • sharpe
  • opt_portfolio
  • eq_portfolio

Regime and Breadth Context

Use these endpoints to add market context around a strategy:

  • GET /quant/asset-correlation for cross-asset returns and current correlation.
  • GET /quant/sector-insights for sector breadth and cumulative return series.
  • GET /quant/market-memory for historical analog matching.
  • GET /quant/seasonality for calendar, monthly, quarterly, weekday, or presidential-cycle behavior.

Expiration Filtering

Some options endpoints accept repeated expiration parameters:

expiration=2026-05-15&expiration=2026-06-19

Use GET /options/chain or GET /options/iv to discover currently available expiration dates before applying filters.