---
title: "Get Analysis"
method: GET
path: "/api/options/{symbol}/analysis"
tags: ["options"]
---

# Get Analysis

`GET /api/options/{symbol}/analysis`

## Request

- Base URL: `https://api.equity-rank.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.equity-rank.com/api/options/{symbol}/analysis`
- Auth: HTTP bearer

Combined options analysis in a single call:
- IV rank, PCR, implied move (summary)
- Strategy recommendation with rationale and payoff math
- IV mispricing scan (BSM vs market mid, top 5 candidates)

On success: result is cached to analysis_cache for offline/budget fallback.
On failure: serves the most-recent cached result if available.

The frontend calls this once per symbol load; no further options endpoints needed.

## Path parameters

- `symbol` string, required

## Query parameters

- `stock_price` number, required: Current stock price
- `rank_score` number: EquityRank total score 0-100
- `momentum_score` number: Momentum pillar score 0-100
- `quality_score` number: Quality pillar score 0-100
- `consensus_margin_of_safety` number, nullable: Consensus MOS % (negative = overvalued)

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/equity-rank/apis/equity-rank-api.md) · [All operations](https://skmtc.dev/equity-rank/apis/equity-rank-api/llms.txt) · [OpenAPI document](https://skmtc.dev/equity-rank/apis/equity-rank-api/revisions/c2f2463fee33?raw)