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

# Get FINRA Short Interest

> [OpenAPI JSON Spec](/docs/output/v1_stocks_short-interest_get.json)
Bi-monthly FINRA consolidated short interest for a US equity:
short interest (shares), change vs prior period, days-to-cover,
average daily volume, and SI% of float/outstanding. Reported by
settlement date and lags ~8 trading days (not real time).
start_time/end_time (unix seconds, filter settlement_date) are
optional but must be sent together; omit both for the latest period.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/stocks/short-interest
openapi: 3.0.0
info:
  contact: {}
  description: >-
    Welcome to Arrays!


    Arrays is a unified financial data layer for both financial institutions and
    retail users, delivering comprehensive market data across crypto and equity
    markets. Our datasets cover fundamentals, ETFs, options, crypto, and more.


    Visit [arrays.org](https://arrays.org) to request an API key and start your
    free trial. You can explore our full API offerings in the documentation
    below.


    For any questions regarding APIs or pricing, please contact
    support@arrays.org.
  title: Arrays API
  version: '1.0'
servers:
  - url: https://data-tools.prd.arrays.org/api
security: []
paths:
  /v1/stocks/short-interest:
    get:
      tags:
        - Stocks
      summary: Get FINRA Short Interest
      description: |-
        [OpenAPI JSON Spec](/docs/output/v1_stocks_short-interest_get.json)
        Bi-monthly FINRA consolidated short interest for a US equity:
        short interest (shares), change vs prior period, days-to-cover,
        average daily volume, and SI% of float/outstanding. Reported by
        settlement date and lags ~8 trading days (not real time).
        start_time/end_time (unix seconds, filter settlement_date) are
        optional but must be sent together; omit both for the latest period.
      parameters:
        - description: Symbol (e.g. NVDA, BRK.B)
          in: query
          name: symbol
          required: true
          schema:
            type: string
        - description: Range start, unix seconds (with end_time)
          in: query
          name: start_time
          schema:
            type: integer
        - description: Range end, unix seconds (with start_time)
          in: query
          name: end_time
          schema:
            type: integer
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/model.APIResponse'
                  - properties:
                      data:
                        items:
                          $ref: '#/components/schemas/model.ShortInterestPoint'
                        type: array
                    type: object
components:
  schemas:
    model.APIResponse:
      properties:
        data: {}
        error:
          $ref: '#/components/schemas/model.APIError'
        pagination: {}
        request_id:
          type: string
        success:
          type: boolean
      type: object
    model.ShortInterestPoint:
      properties:
        average_daily_volume:
          type: integer
        change_in_short_interest:
          type: integer
        change_in_short_interest_percentage:
          type: number
        company_name:
          type: string
        days_to_cover:
          type: number
        last_short_interest:
          type: integer
        settlement_date:
          type: string
        short_interest:
          type: integer
        short_interest_pct_float:
          description: >-
            SI as % of float / outstanding (0-100, may exceed 100). Only
            populated for

            the latest settlement date; null for older rows (computed from
            current

            shares, which are only valid for the most recent period).
          type: number
        short_interest_pct_outstanding:
          type: number
        symbol:
          type: string
        updated_at:
          description: UpdatedAt is our ingestion/upsert time (unix seconds).
          type: integer
      type: object
    model.APIError:
      properties:
        code:
          example: RESOURCE_NOT_FOUND
          type: string
        details:
          items:
            $ref: '#/components/schemas/model.APIErrorDetail'
          type: array
        docs_url:
          type: string
        examples:
          items:
            type: string
          type: array
        hint:
          type: string
        message:
          example: The requested resource was not found.
          type: string
        suggestions:
          items:
            type: string
          type: array
      type: object
    model.APIErrorDetail:
      properties:
        field:
          type: string
        got:
          type: string
        reason:
          type: string
      type: object

````