Analyst Ratings History (Monthly Buy/Hold/Sell Counts)

{
  "type": "object",
  "required": [
    "ticker"
  ],
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Stock ticker symbol (e.g. 'AAPL')."
    },
    "exchange": {
      "type": "string",
      "description": "Stock exchange (e.g. 'NYSE', 'NASDAQ')."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "Buy": {
                "type": "string",
                "description": "Count of Buy ratings that month, as a numeric string."
              },
              "Date": {
                "type": "string",
                "description": "First day of the covered month, e.g. '09/01/2023' (MM/DD/YYYY)."
              },
              "Hold": {
                "type": "string",
                "description": "Count of Hold ratings that month, as a numeric string."
              },
              "Sell": {
                "type": "string",
                "description": "Count of Sell ratings that month, as a numeric string."
              },
              "StrongBuy": {
                "type": "string",
                "description": "Count of Strong Buy ratings that month, as a numeric string."
              },
              "TotalRatings": {
                "type": "string",
                "description": "Total analyst ratings that month, as a numeric string; equal to Sell+Hold+Buy+StrongBuy for that month in every row observed."
              }
            },
            "additionalProperties": false
          },
          "description": "Monthly analyst rating counts, oldest first, on a real successful lookup (AAPL: 38 months, roughly 3 years of history). On an unrecognized ticker, this endpoint has been observed returning an unrelated fallback stock listing instead of an error or an empty result (see usage.md) -- none of that listing's fields are mapped to this shape, so those entries appear here as empty objects rather than ratings data."
        }
      },
      "additionalProperties": false
    },
    "status": {
      "type": "string",
      "description": "'success' on both real calls observed, including the unrecognized-ticker case."
    }
  },
  "description": "The analyst-ratings record, as returned at routing.responseResultPath ($.output).",
  "additionalProperties": false
}