Market Eyes Live - stock ratings and mortgage-rate context

Added value: +{
+  "description": "present (true) only when Market Eyes Live has a trade plan for this ticker; the plan values are not included",
+  "type": "boolean"
+}

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 symbols, e.g. [\"NVDA\",\"AMD\"]"New value: +"U.S. ticker symbols, e.g. [\"NVDA\",\"AMD\"]"

Previous value: -"one row per requested ticker, in input order"New value: +"one row per distinct requested ticker, in input order (BRK.B and BRK-B are one ticker)"

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

Previous value: -"present instead of scores when the ticker is outside the daily set"New value: +"present instead of scores: the ticker is outside the daily-refreshed set, not on the coverage list, not covered, or shares its symbol with a futures contract or coin"

Previous value: -"User-facing conviction tier, same ladder as get_stock_rating: Unfavorable, Hold, Favorable, Highest Conviction weakest to strongest, with Highest Conviction at a composite of 69 or above. Names without mature fundamentals read Promising, Very Promising or Rising Star instead."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: +{
+  "type": "string"
+}

Added value: +{
+  "properties": {
+    "methodology": {
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

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

Previous value: -[
-  "comparison"
-]New value: +[
+  "comparison",
+  "source",
+  "disclaimer"
+]

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

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

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

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

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

Added value: +[
+  "source",
+  "disclaimer"
+]

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: +{
+  "type": "string"
+}

Added value: +"User-facing conviction tier, same ladder as get_stock_rating: Unfavorable, Hold, Favorable, Highest Conviction weakest to strongest, with Highest Conviction at a composite of 69 or above. Names without mature fundamentals read Promising, Very Promising or Rising Star instead."

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: +{
+  "properties": {
+    "comparison": {
+      "description": "one row per requested ticker, in input order",
+      "items": {
+        "properties": {
+          "as_of": {
+            "type": "string"
+          },
+          "company": {
+            "type": "string"
+          },
+          "composite_score": {
+            "description": "0-100",
+            "type": "number"
+          },
+          "momentum": {
+            "type": "number"
+          },
+          "note": {
+            "description": "present instead of scores when the ticker is outside the daily set",
+            "type": "string"
+          },
+          "quality": {
+            "type": "number"
+          },
+          "rating_page": {
+            "type": "string"
+          },
+          "rating_tier": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "symbol": {
+            "type": "string"
+          },
+          "valuation": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "symbol"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "comparison"
+  ],
+  "type": "object"
+}

Previous value: -nullNew value: +{
+  "description": "today's public mortgage-rate context; omitted only if the live feed is momentarily unavailable, which returns a text message instead",
+  "properties": {
+    "as_of": {
+      "description": "YYYY-MM-DD of the data",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "links": {
+      "properties": {
+        "app": {
+          "type": "string"
+        },
+        "live_data": {
+          "type": "string"
+        },
+        "should_i_lock": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "mbs": {
+      "properties": {
+        "meaning": {
+          "type": "string"
+        },
+        "momentum": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "rate_environment": {
+      "description": "falling, stable, or rising",
+      "type": "string"
+    },
+    "ten_year_treasury": {
+      "properties": {
+        "direction": {
+          "type": "string"
+        },
+        "yield_pct": {
+          "type": [
+            "number",
+            "null"
+          ]
+        }
+      },
+      "type": "object"
+    },
+    "what_moves_mortgage_rates": {
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

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"
+}