Sign in

v1

latestOpenAPI 3.0.02026-07-266091181.5 KB
Bulls Say Bears Say

Latest bull and bear cases for a given ticker symbol

Returns the latest bullish and bearish investment cases for a given stock ticker symbol. Bull cases present positive arguments for buying a stock, while bear cases present negative arguments against it.

get/api/v1/bulls_bears_say

Query parameters

symbolsstring required

Stock ticker symbol to query for bull/bear cases

pageinteger

Page offset. For optimization, performance and technical reasons, page offsets are limited from 0 - 100000. Limit the query results by other parameters such as date. Default is 0

pagesizeinteger

Number of results to be returned. Limit 200

parameters[updated]integer

Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated

Response

An array of bull and bear cases for the requested ticker symbol

Example response

{
  "bulls-say-bears-say": [
    {
      "analyst_firms_referenced": 12,
      "bear_case": "Market saturation and competitive pressures",
      "bull_case": "Strong product pipeline and ecosystem lock-in effect",
      "created": 1704819000,
      "exchange": "NASDAQ",
      "id": "60a7f5e8e4b0f5a3c8e9f5c0",
      "latest": true,
      "securities": [
        {
          "cik": "320193",
          "exchange": "NASDAQ",
          "isin": "US0378331005",
          "name": "Apple Inc.",
          "symbol": "AAPL"
        }
      ],
      "ticker": "AAPL",
      "updated": 1704819600
    }
  ]
}