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",
    "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": "cit_123456",
                "title": "Tesla Q3 2023 Earnings Report",
                "source_type": "news",
                "source_name": "Reuters",
                "url": "https://example.com/article",
                "published_date": "2023-10-18T10:30:00Z",
                "relevance_score": 0.85
              }
            ],
            "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": "cit_123456",
                "title": "Tesla Q3 2023 Earnings Report",
                "source_type": "news",
                "source_name": "Reuters",
                "url": "https://example.com/article",
                "published_date": "2023-10-18T10:30:00Z",
                "relevance_score": 0.85
              }
            ],
            "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": "cit_123456",
                "title": "Tesla Q3 2023 Earnings Report",
                "source_type": "news",
                "source_name": "Reuters",
                "url": "https://example.com/article",
                "published_date": "2023-10-18T10:30:00Z",
                "relevance_score": 0.85
              }
            ],
            "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",
    "company_name": "Tesla Inc."
  },
  "timestamp": "<string>",
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 100,
    "hasNext": true
  },
  "message": "<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
required

Bulls vs bears analysis data

​
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