Skip to main content
GET
/
bulls-vs-bears-summary
/
{symbol}
Get bulls vs bears summary
curl --request GET \
  --url https://api.fcontext.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"
  },
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 100,
    "hasNext": true
  },
  "message": "<string>",
  "timestamp": "<string>",
  "meta": {
    "pagination": {
      "page": 1,
      "limit": 10,
      "total": 100,
      "hasNext": true
    }
  }
}

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
required

ISO 8601 timestamp of the response

pagination
object

Pagination information for paginated responses

message
string

Optional success message

meta
object

Optional metadata including pagination, statistics, and additional context