> ## Documentation Index
> Fetch the complete documentation index at: https://docs.benzinga.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 강세 VS 약세

<ResponseExample>
  ```json Response (200 OK) theme={null}
  {
    "bulls_say_bears_say": [
      {
        "bear_case": "이번 분석은 중국 매출이 전년 대비 3.6% 감소한 점을 강조하며, 핵심 지역에서의 시장 성과에 대한 우려를 제기합니다. 또한 매출총이익률은 전년 대비 약 47% 수준으로 안정적이지만, 증가하는 영업비용이 수익성에 대한 위험 요인으로 작용하고 있습니다. 더 나아가 iPhone 매출 성장 둔화 가능성과 Apple의 평판 하락 가능성은 기업 가치에 하방 압력을 가해 투자자들의 불안을 키울 수 있습니다.",
        "bull_case": "Apple의 4분기 매출은 8% 증가한 1,025억 달러를 기록해 예상치와 대체로 부합했으며, 특히 견조한 iPhone 매출 성과에 힘입어 다음 분기에는 총매출이 10%~12% 증가할 것으로 전망됩니다. 회사는 또한 324억 달러의 영업이익을 보고했으며, 이는 전년 대비 10% 증가한 수치이고, 서비스 매출은 15% 증가해 매출총이익률 개선에 긍정적으로 기여했습니다. 아울러 중국 지역에서의 예상 성장과 AI 및 제품 개발에 대한 전략적 투자를 바탕으로, Apple은 운영비 증가에도 불구하고 지속 가능한 장기 성장을 달성할 수 있는 유리한 위치를 확보하고 있습니다.",
        "id": "6951d73e304f6ecd69d00189",
        "securities": [
          {
            "cik": "0000320193",
            "exchange": "NASDAQ Global Select Consolidated",
            "isin": "US0378331005",
            "name": "APPLE INC",
            "symbol": "AAPL"
          }
        ],
        "ticker": "AAPL",
        "updated": 1766971198
      }
    ]
  }
  ```

  ```json Response (401 Unauthorized) theme={null}
  {
    "ok": false,
    "errors": [
      {
        "code": "auth_failed",
        "id": "unauthorized",
        "value": "인증 토큰이 없거나 유효하지 않습니다"
      }
    ]
  }
  ```

  ```json Response (404 Not Found) theme={null}
  {
    "ok": false,
    "errors": [
      {
        "code": "no_data_found",
        "id": "not_found",
        "value": "지정된 매개변수에 해당하는 데이터를 찾을 수 없습니다"
      }
    ]
  }
  ```

  ```json Response (500 Internal Server Error) theme={null}
  {
    "ok": false,
    "errors": [
      {
        "code": "internal_server_error",
        "id": "server_error",
        "value": "요청을 처리하는 중 예기치 않은 오류가 발생했습니다"
      }
    ]
  }
  ```
</ResponseExample>


## OpenAPI

````yaml ko/openapi/calendar-api.spec.yml GET /api/v1/bulls_bears_say
openapi: 3.0.0
info:
  contact: {}
  description: >-
    تُعيد واجهة برمجة تطبيقات REST هذه بيانات مُنظَّمة لمكالمات المؤتمرات
    الهاتفية (conference calls)، وتوزيعات الأرباح (dividends)، والأرباح (بما في
    ذلك تواريخ الأرباح المستقبلية)، والبيانات الاقتصادية، وإعلانات شركات
    الأدوية، والتوجيّهات المستقبلية للشركات (guidance)، والاكتتابات العامة
    الأولية (IPOs)، والعروض الثانوية، والتقييمات (ratings)، وأنشطة الاندماجات
    والاستحواذات (M&A)، وتجزيئة الأسهم (splits).
  termsOfService: http://swagger.io/terms/
  title: Calendar API
  version: 2.1.0
servers:
  - url: https://api.benzinga.com
    description: PROD
security: []
paths:
  /api/v1/bulls_bears_say:
    get:
      tags:
        - Bulls Say Bears Say
      summary: أحدث السيناريوهات الصعودية والهبوطية لرمز تداول محدّد
      description: >-
        يعيد أحدث الأطروحات الاستثمارية الصعودية والهبوطية لسهم معيّن بناءً على
        رمز التداول الخاص به. تعرض الأطروحات الصعودية مبررات إيجابية لشراء
        السهم، بينما تعرض الأطروحات الهبوطية مبررات سلبية لعدم شرائه.
      operationId: get-bulls-say-bears-say-v1
      parameters:
        - description: رمز تداول السهم المراد الاستعلام عن حالات السوق الصاعدة/الهابطة له
          in: query
          name: symbols
          required: true
          schema:
            type: string
        - description: >-
            إزاحة الصفحة. لأسباب تتعلق بالتحسين والأداء والاعتبارات التقنية، يتم
            تقييد قيم إزاحة الصفحة بين 0 و100000. حَدِّد نتائج الاستعلام
            باستخدام معلمات أخرى مثل التاريخ. القيمة الافتراضية هي 0.
          in: query
          name: page
          schema:
            type: integer
            default: 0
        - description: عدد النتائج التي ستُرجَع، بحد أقصى 200
          in: query
          name: pagesize
          schema:
            type: integer
            maximum: 200
            default: 100
        - description: >-
            الطابع الزمني (Unix timestamp) لآخر تحديث للسجلات بتوقيت UTC.
            سيُجبِر هذا ترتيب الفرز على أن يكون أكبر من أو يساوي الطابع الزمني
            المُشار إليه
          in: query
          name: parameters[updated]
          schema:
            type: integer
      responses:
        '200':
          description: مصفوفة بالحالات الصعودية والهبوطية لرمز التداول المطلوب
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api.BullsSayBearsSayResponse'
        '400':
          description: الطلب غير صالح
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api.ErrorResponse'
        '401':
          description: معلومات المصادقة مفقودة أو غير صالحة
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api.ErrorResponse'
        '404':
          description: لم يتم العثور على سيناريو صعودي/هبوطي لرمز التداول المُقدَّم
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api.ErrorResponse'
        '500':
          description: خطأ داخلي في الخادم
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api.ErrorResponse'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    api.BullsSayBearsSayResponse:
      description: >-
        استجابة واجهة برمجة التطبيقات API التي تتضمن مصفوفة سجلات لـ Bulls Say
        Bears Say
      properties:
        bulls-say-bears-say:
          items:
            $ref: '#/components/schemas/calendarapi.BullsSayBearsSay'
          type: array
      type: object
    api.ErrorResponse:
      properties:
        text:
          type: string
      type: object
    calendarapi.BullsSayBearsSay:
      properties:
        analyst_firms_referenced:
          example: 12
          type: integer
        bear_case:
          example: Market saturation and competitive pressures
          type: string
        bull_case:
          example: Strong product pipeline and ecosystem lock-in effect
          type: string
        created:
          example: 1704819000
          type: integer
        exchange:
          example: NASDAQ
          type: string
        id:
          example: 60a7f5e8e4b0f5a3c8e9f5c0
          type: string
        latest:
          example: true
          type: boolean
        securities:
          items:
            properties:
              cik:
                example: '320193'
                type: string
              exchange:
                example: NASDAQ
                type: string
              isin:
                example: US0378331005
                type: string
              name:
                example: Apple Inc.
                type: string
              symbol:
                example: AAPL
                type: string
            type: object
          type: array
        ticker:
          example: AAPL
          type: string
        updated:
          example: 1704819600
          type: integer
      type: object
  securitySchemes:
    ApiKeyAuth:
      in: query
      name: token
      type: apiKey

````