GET
/
bulls-vs-bears-summary
/
{symbol}
Get bulls vs bears summary
curl --request GET \
  --url https://api.financialcontext.com/bulls-vs-bears-summary/{symbol} \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "data": {
    "id": "summary_123456",
    "symbol": "TSLA",
    "company_name": "Tesla Inc.",
    "controversial_issues": [
      {
        "id": "issue_123456",
        "symbol": "TSLA",
        "issue_type": "environmental",
        "title": "Environmental Impact of Manufacturing",
        "description": "Concerns about the environmental impact...",
        "severity_score": 0.6,
        "bullish_viewpoints": [
          {
            "id": "vp_123456",
            "stance": "bullish",
            "title": "Strong Q3 Performance Indicates Growth",
            "description": "Tesla's Q3 results show...",
            "key_arguments": [
              "Revenue growth of 15%",
              "Improved margins"
            ],
            "confidence_score": 0.75,
            "citations": [
              {
                "id": "<any>",
                "title": "<any>",
                "url": "<any>",
                "source_type": "<any>",
                "source_name": "<any>",
                "published_date": "<any>",
                "relevance_score": "<any>"
              }
            ],
            "created_at": "2023-10-18T10:30:00Z",
            "updated_at": "2023-10-18T10:30:00Z"
          }
        ],
        "bearish_viewpoints": [
          {
            "id": "vp_123456",
            "stance": "bullish",
            "title": "Strong Q3 Performance Indicates Growth",
            "description": "Tesla's Q3 results show...",
            "key_arguments": [
              "Revenue growth of 15%",
              "Improved margins"
            ],
            "confidence_score": 0.75,
            "citations": [
              {
                "id": "<any>",
                "title": "<any>",
                "url": "<any>",
                "source_type": "<any>",
                "source_name": "<any>",
                "published_date": "<any>",
                "relevance_score": "<any>"
              }
            ],
            "created_at": "2023-10-18T10:30:00Z",
            "updated_at": "2023-10-18T10:30:00Z"
          }
        ],
        "neutral_viewpoints": [
          {
            "id": "vp_123456",
            "stance": "bullish",
            "title": "Strong Q3 Performance Indicates Growth",
            "description": "Tesla's Q3 results show...",
            "key_arguments": [
              "Revenue growth of 15%",
              "Improved margins"
            ],
            "confidence_score": 0.75,
            "citations": [
              {
                "id": "<any>",
                "title": "<any>",
                "url": "<any>",
                "source_type": "<any>",
                "source_name": "<any>",
                "published_date": "<any>",
                "relevance_score": "<any>"
              }
            ],
            "created_at": "2023-10-18T10:30:00Z",
            "updated_at": "2023-10-18T10:30:00Z"
          }
        ],
        "overall_sentiment": "bullish",
        "sentiment_confidence": 0.8,
        "created_at": "2023-10-18T10:30:00Z",
        "updated_at": "2023-10-18T10:30:00Z"
      }
    ],
    "total_bullish_viewpoints": 15,
    "total_bearish_viewpoints": 8,
    "total_neutral_viewpoints": 3,
    "overall_sentiment_score": 0.3,
    "sentiment_confidence": 0.75,
    "last_analyzed_at": "2023-10-18T10:30:00Z",
    "created_at": "2023-10-18T10:30:00Z",
    "updated_at": "2023-10-18T10:30:00Z"
  },
  "message": "<string>",
  "timestamp": "2023-11-07T05:31:56Z",
  "meta": {
    "pagination": {
      "currentPage": 1,
      "pageSize": 20,
      "totalItems": 150,
      "totalPages": 8,
      "hasMore": true,
      "hasPrevious": false
    }
  }
}

Authorizations

X-API-Key
string
header
required

Path Parameters

symbol
string
required

Stock symbol (e.g., AAPL, NASDAQ:AAPL)

Required string length: 1 - 20
Example:

"AAPL"

Query Parameters

issue_type
enum<string>

Filter by issue type

Available options:
environmental,
social,
governance,
financial,
regulatory,
competitive
Example:

"environmental"

min_severity
number

Minimum severity score

Required range: 0 <= x <= 1
Example:

0.5

include_viewpoints
boolean
default:true

Include detailed viewpoints

Example:

true

include_citations
boolean
default:false

Include citation details

Example:

false

page
integer
default:1

Page number, starting from 1

Required range: -9007199254740991 <= x <= 9007199254740991
Example:

1

page_size
integer
default:10

Number of items per page, range 1-100

Required range: -9007199254740991 <= x <= 9007199254740991
Example:

10

Response

Bulls vs bears summary retrieved successfully

Bulls vs bears analysis response

success
boolean
required

Indicates successful API response

data
object | null
required

Bulls vs bears analysis data Complete bulls vs bears analysis summary for a stock

timestamp
string<date-time>
required

ISO 8601 timestamp of the response

message
string

Optional success message

meta
object

Optional metadata including pagination, statistics, and additional context