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

# Get Recommendations

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

## 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}/recommendations`
- Auth: HTTP bearer

Generate an AI strategy recommendation for options on this symbol.

Fetches IV summary and chain, finds ATM options, then runs the
rules-based recommendations engine.

Query params:
  stock_price    — required, current stock price
  rank_score     — EquityRank total score (default 50)
  momentum_score — momentum pillar score (default 50)
  quality_score  — quality pillar score (default 50)
  expiry         — if provided, use this expiry for ATM price lookup

## 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)
- `expiry` string, nullable: Target expiry YYYY-MM-DD for ATM data

## 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)