Added value: +{
+  "description": "Present only when Market Eyes Live has a trade plan for this ticker (an entry zone, an alert level and position sizing). The plan values are never included here; they are part of a Market Eyes Live subscription.",
+  "properties": {
+    "described_on": {
+      "description": "the rating page, present when that page describes the plan",
+      "type": "string"
+    },
+    "included": {
+      "description": "always false: the plan values are not part of this data",
+      "type": "boolean"
+    },
+    "note": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "included",
+    "note"
+  ],
+  "type": "object"
+}

Previous value: -"Ticker symbol, e.g. NVDA, AAPL, VOO"New value: +"U.S. ticker symbol, e.g. NVDA, AAPL, VOO"

Previous value: -"MELANY rating for the ticker. Present on a successful rating; omitted for not-found or rate-limited results, which return an explanatory text message instead."New value: +"MELANY rating for the ticker. Present on a successful rating; omitted for not-covered, not-found or rate-limited results, which return an explanatory text message instead."

Added value: +{
+  "type": "string"
+}

Removed value: -{
-  "description": "true if a suggested entry plan exists in the app; the plan itself is not returned here",
-  "type": "boolean"
-}

Removed value: -{
-  "type": "string"
-}

Added value: +{
+  "description": "how the ratings are built and graded",
+  "type": "string"
+}

Added value: +"the public rating page for this ticker"

Removed value: -{
-  "description": "The engine's internal word for the same call: BUY, HOLD or SELL for a mature name, otherwise the speculative or fund-native tier. rating_tier is what a user sees.",
-  "type": [
-    "string",
-    "null"
-  ]
-}

Previous value: -"User-facing conviction tier. Mature ladder, weakest to strongest: Unfavorable, Hold, Favorable, Highest Conviction. Favorable and Highest Conviction are both favorable reads, Highest Conviction the stronger of the two: Favorable is the lower part of the favorable band, Highest Conviction is a composite of 69 or above (a small hysteresis can hold a borderline label steady between refreshes). Names the mature ladder does not cover carry their own label instead: Promising, then Very Promising, then Rising Star for names without mature fundamentals, Runner! for a momentum surge, Catalyst Watch for a news-driven gap up on volume. rating_raw carries the engine word behind the label."New value: +"Conviction tier. Mature ladder, weakest to strongest: Unfavorable, Hold, Favorable, Highest Conviction. Favorable and Highest Conviction are both favorable reads; Highest Conviction is a composite of 69 or above (for a stock, a small hysteresis can hold a borderline label steady between refreshes; a fund or REIT word follows its label in the app, which has none). Names the mature ladder does not cover carry their own label: Promising, then Very Promising, then Rising Star for names without mature fundamentals, Runner! for a momentum surge, Catalyst Watch for a news-driven gap up on volume. ETFs and REITs use the same mature ladder, chosen by the tone of the fund's own label in the app (a favorable fund label reads Favorable or Highest Conviction, a cautious or neutral one Hold, a negative one Unfavorable); a leveraged or inverse fund never reads above Hold. These nine words are the complete set; null when no tier applies."

Added value: +{
+  "description": "data source name",
+  "type": "string"
+}

Added value: +"descriptive risk notes; never instructions"

Previous value: -[
-  "symbol",
-  "composite_score",
-  "as_of",
-  "factors"
-]New value: +[
+  "symbol",
+  "composite_score",
+  "as_of",
+  "factors",
+  "source",
+  "disclaimer"
+]

Added value: +{
+  "description": "The engine's internal word for the same call: BUY, HOLD or SELL for a mature name, otherwise the speculative or fund-native tier. rating_tier is what a user sees.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Previous value: -"conviction ladder, e.g. BUY, Very Promising, Hold"New value: +"User-facing conviction tier. Mature ladder, weakest to strongest: Unfavorable, Hold, Favorable, Highest Conviction. Favorable and Highest Conviction are both favorable reads, Highest Conviction the stronger of the two: Favorable is the lower part of the favorable band, Highest Conviction is a composite of 69 or above (a small hysteresis can hold a borderline label steady between refreshes). Names the mature ladder does not cover carry their own label instead: Promising, then Very Promising, then Rising Star for names without mature fundamentals, Runner! for a momentum surge, Catalyst Watch for a news-driven gap up on volume. rating_raw carries the engine word behind the label."

Previous value: -nullNew value: +{
+  "description": "MELANY rating for the ticker. Present on a successful rating; omitted for not-found or rate-limited results, which return an explanatory text message instead.",
+  "properties": {
+    "as_of": {
+      "description": "YYYY-MM-DD scoring date",
+      "type": "string"
+    },
+    "company": {
+      "type": "string"
+    },
+    "composite_score": {
+      "description": "0-100, higher is stronger",
+      "type": "number"
+    },
+    "factors": {
+      "description": "each 0-100, higher is stronger",
+      "properties": {
+        "catalyst": {
+          "type": "number"
+        },
+        "earnings": {
+          "type": "number"
+        },
+        "macro_fit": {
+          "type": "number"
+        },
+        "momentum": {
+          "type": "number"
+        },
+        "quality": {
+          "type": "number"
+        },
+        "risk_adjusted": {
+          "type": "number"
+        },
+        "sentiment": {
+          "type": "number"
+        },
+        "valuation": {
+          "type": "number"
+        }
+      },
+      "type": "object"
+    },
+    "freshness": {
+      "description": "present only when scored live on demand",
+      "type": "string"
+    },
+    "has_entry_plan": {
+      "description": "true if a suggested entry plan exists in the app; the plan itself is not returned here",
+      "type": "boolean"
+    },
+    "links": {
+      "properties": {
+        "app": {
+          "type": "string"
+        },
+        "rating_page": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "rating_tier": {
+      "description": "conviction ladder, e.g. BUY, Very Promising, Hold",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "scale": {
+      "type": "string"
+    },
+    "symbol": {
+      "type": "string"
+    },
+    "theme": {
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "strength": {
+          "type": "number"
+        }
+      },
+      "type": "object"
+    },
+    "top_risks": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "symbol",
+    "composite_score",
+    "as_of",
+    "factors"
+  ],
+  "type": "object"
+}