> ## 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.

# Blocktrade

<ResponseExample>
  ```json 응답 (200 OK) theme={null}
  {
    "block_trade": [
      {
        "ask": "30.7",
        "bid": "30.13",
        "count": 1,
        "date": "2026-01-06",
        "description": "블록 트레이드: CFLT 2.2M @ $30.15",
        "exchange": "NASDAQ",
        "executing_exchange": "L",
        "id": "695d0f6d8f047b0001fefed9",
        "name": "Confluent",
        "price": "30.15",
        "sale_conditions": "@ TW",
        "size": "2216727",
        "ticker": "CFLT",
        "time": "08:34:34",
        "updated": 1767706477
      }
    ]
  }
  ```

  ```json 응답 (401 권한 없음) theme={null}
  {
    "ok": false,
    "errors": [
      {
        "code": "auth_failed",
        "id": "unauthorized",
        "value": "유효하지 않거나 누락된 인증 토큰입니다"
      }
    ]
  }
  ```

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

  ```json 응답 (500 내부 서버 오류) 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/signal/block_trade
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/signal/block_trade:
    get:
      tags:
        - Block Trade
      summary: BlockTrade الإصدار 1
      description: >-
        تعيد بيانات صفقات الكتل، بما في ذلك الصفقات الضخمة على نحو غير اعتيادي
        التي قد تدل على نشاط تداول مؤسسي
      operationId: get-block-trade-v1
      parameters:
        - description: >-
            إزاحة الصفحة. لأسباب تتعلق بالتحسين والأداء والاعتبارات التقنية، يتم
            تقييد إزاحات الصفحات ضمن النطاق من 0 إلى 100000. قَيِّد نتائج
            الاستعلام باستخدام معلمات أخرى مثل التاريخ. القيمة الافتراضية هي 0
          in: query
          name: page
          schema:
            type: integer
            default: 0
        - description: عدد النتائج المُعادة. الحد الأقصى 1000
          in: query
          name: pageSize
          schema:
            type: integer
            default: 100
        - description: تاريخ البدء بتنسيق YYYY-MM-DD
          in: query
          name: date_from
          schema:
            type: string
            format: date
        - description: تاريخ الانتهاء بتنسيق YYYY-MM-DD
          in: query
          name: date_to
          schema:
            type: string
            format: date
        - description: >-
            رمز تداول واحد أو أكثر، تفصل بينها فاصلة، وبحد أقصى 50 من رموز
            الأسهم
          in: query
          name: tickers
          schema:
            type: string
            format: csv
        - description: >-
            آخر وقت لتحديث السجلات بطابع زمني Unix (UTC). سيفرض هذا أن يكون
            ترتيب الفرز أكبر من أو يساوي الطابع الزمني المشار إليه
          in: query
          name: updated
          schema:
            type: integer
      responses:
        '200':
          description: صفقة ضخمة
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api.BlockTradeResponse'
        '400':
          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.BlockTradeResponse:
      description: >-
        استجابة واجهة برمجة التطبيقات API التي تتضمن مصفوفة سجلات للصفقات
        الكتلية
      properties:
        block-trade:
          items:
            $ref: '#/components/schemas/calendarapi.BlockTrade'
          type: array
      type: object
    api.ErrorResponse:
      properties:
        text:
          type: string
      type: object
    calendarapi.BlockTrade:
      properties:
        ask:
          example: '185.44'
          type: string
        bid:
          example: '185.40'
          type: string
        count:
          example: 1
          type: integer
        cusip:
          example: 37833100
          type: string
        date:
          example: '2024-01-09T00:00:00.000Z'
          type: string
        description:
          example: Large institutional trade
          type: string
        exchange:
          example: NASDAQ
          type: string
        executing_exchange:
          example: Q
          type: string
        id:
          example: 60a7f5e8e4b0f5a3c8e9f5b4
          type: string
        importance:
          example: 4
          type: integer
        isin:
          example: US0378331005
          type: string
        name:
          example: Apple Inc.
          type: string
        price:
          example: '185.42'
          type: string
        sale_conditions:
          example: '@'
          type: string
        size:
          example: '500000'
          type: string
        ticker:
          example: AAPL
          type: string
        time:
          example: '15:45:30'
          type: string
        updated:
          example: 1704819600
          type: integer
      type: object
  securitySchemes:
    ApiKeyAuth:
      in: query
      name: token
      type: apiKey

````