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

# 空売り残高

<ResponseExample>
  ```json レスポンス (200 OK) theme={null}
  {
    "shortInterestData": {
      "AAPL": {
        "data": [
          {
            "recordDate": "2026-01-12",
            "symbol": "AAPL",
            "company": "Apple Inc. Common Stock",
            "totalShortInterest": "112732788",
            "daysToCover": 2.71,
            "shortPercentOfFloat": 0.77,
            "shortPriorMo": "122035714",
            "percentChangeMoMo": -7.62,
            "sharesFloat": "14688854878",
            "averageDailyVolume": "41632615",
            "sharesOutstanding": "14697926000",
            "exchange": "NNM",
            "sector": "Technology",
            "industry": "Consumer Electronics",
            "exchangeReceiptDate": "2026-01-05",
            "settlementDate": "2025-12-31"
          }
        ]
      }
    }
  }
  ```
</ResponseExample>


## OpenAPI

````yaml ja/openapi/data-api-proxy.spec.yml GET /api/v1/shortinterest
openapi: 3.0.0
info:
  contact: {}
  description: >-
    توفّر واجهة برمجة التطبيقات REST هذه نقاط نهاية للبحث في الأساسيات المالية
    والحصول على تفاصيلها.
  termsOfService: http://swagger.io/terms/
  title: Data API Proxy
  version: 2.0.0
servers:
  - url: https://api.benzinga.com
    description: PROD
security: []
paths:
  /api/v1/shortinterest:
    get:
      tags:
        - Market Data
      summary: بيانات مراكز البيع المكشوف
      description: >-
        يجلب بيانات الاهتمام بالبيع على المكشوف للأوراق المالية المحددة. يتضمّن
        معلومات حول الأسهم المباعة على المكشوف، وأيام التغطية، ونِسَب الاهتمام
        بالبيع على المكشوف. يدعم تضمين بيانات تقارير FINRA الاختيارية والتصفية
        حسب نطاق تاريخي.
      operationId: get-short-interest
      parameters:
        - description: >-
            قائمة من رموز تداول الأسهم مفصولة بفواصل (مثل AAPL,MSFT,TSLA). حقل
            مطلوب.
          in: query
          name: symbols
          required: true
          schema:
            type: string
        - description: >-
            تضمين بيانات تقرير مراكز البيع على المكشوف من FINRA. القيمة
            الافتراضية: false
          in: query
          name: finraReport
          schema:
            type: boolean
        - description: رقم الصفحة لأغراض التقسيم إلى صفحات. يُستخدم مع معلمة pageSize.
          in: query
          name: page
          schema:
            type: integer
        - description: >-
            عدد النتائج في كل صفحة. تختلف القيمة الافتراضية حسب إعدادات نقطة
            النهاية.
          in: query
          name: pageSize
          schema:
            type: integer
        - description: 'تاريخ البدء لبيانات مراكز البيع على المكشوف. التنسيق: YYYY-MM-DD'
          in: query
          name: from
          schema:
            type: string
        - description: 'تاريخ الانتهاء لبيانات مراكز البيع على المكشوف. الصيغة: YYYY-MM-DD'
          in: query
          name: to
          schema:
            type: string
      responses:
        '200':
          description: بيانات مراكز البيع المكشوف للرموز المطلوبة
          content:
            application/json:
              schema:
                type: object
        '400':
          description: طلب غير صالح - معامل الرموز مفقود أو غير صالح
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bzhttp.Resp'
        '500':
          description: خطأ داخلي في الخادم
          content:
            application/json:
              schema:
                type: object
      security:
        - ApiKeyAuth: []
components:
  schemas:
    bzhttp.Resp:
      properties:
        data:
          additionalProperties: true
          type: object
        errors:
          items:
            $ref: '#/components/schemas/bzhttp.Error'
          type: array
        ok:
          type: boolean
      type: object
    bzhttp.Error:
      properties:
        code:
          $ref: '#/components/schemas/bzhttp.ErrorCode'
        id:
          type: string
        value:
          type: string
      type: object
    bzhttp.ErrorCode:
      enum:
        - json_unmarshaling_error
        - no_data_found
        - no_matching_endpoint
        - bad_request
        - db_error
        - internal_server_error
        - auth_failed
        - forbidden
        - failed_dependency
        - service_unavailable
        - upstream_api_error
        - unsupported_message_type
        - database_query_error
      type: string
      x-enum-varnames:
        - ErrorJSONUnmarshaling
        - ErrorNoDataFound
        - ErrorNoMatchingEndpoint
        - ErrorBadRequest
        - ErrorDBError
        - ErrorInternalServerError
        - ErrorAuthFailed
        - ErrorForbidden
        - ErrorFailedDependency
        - ErrorServiceUnavailable
        - ErrorUpstreamAPIError
        - ErrorUnsupportedMessageType
        - ErrorDBQueryError
  securitySchemes:
    ApiKeyAuth:
      in: query
      name: token
      type: apiKey

````