Skip to content

Stocks · Reference and fundamentals

Stocks short volume

Daily short sale volume of a stock, newest first.
GET/v1/stocks/short-volumestocksShortVolume
On this page

Shares sold short on each trading day against the total reported volume, with the exempt portion and the short volume reported through each FINRA trade reporting facility.

Example request

curl -sS --get "https://api.ordermap.si/v1/stocks/short-volume" \
  -H "Authorization: Bearer $ORDERMAP_API_KEY" \
  --data-urlencode symbol=AAPL

Set ORDERMAP_API_KEY to your key. Replace the dates with a recent trading date.

Parameters

5 parameters, 1 required.

ParameterType and limitsDescription
symbolqueryrequiredstringat most 11 characterspattern ^[A-Za-z]{1,6}(\.[A-Za-z0-9]{1,4})?$Ticker symbol, for example AAPL.
start_datequeryoptionalstringdateInclusive earliest trading date, YYYY-MM-DD.
end_datequeryoptionalstringdateInclusive latest trading date, YYYY-MM-DD.
limitqueryoptionalintegerdefault 100min 1max 1000Maximum rows to return.
cursor_idqueryoptionalstringat most 1024 charactersOpaque cursor returned as pagination.next_cursor_id; resumes the same query on the next page.

Response

StatusMeaningBody
200Successful response.Schema below
400Invalid, unknown or repeated parameters, or an invalid cursor.Error object
401Missing or invalid API key.Error object
403The plan, dataset release or account state does not allow this request.Error object
422The request is valid but no data exists for it.Error object
429Rate limit, burst limit or cooldown; wait Retry-After seconds.Retry-AfterError object
500Internal error.Error object
503Data temporarily unavailable; retry after Retry-After seconds.Retry-AfterError object
504The request timed out.Error object

Authenticated responses carry the X-RateLimit-* headers (see rate limits); 429 and 503 add Retry-After.

200 response body

  • dataarray<object>required11 fields inside
    • datestringdaterequiredTrading date.
    • exempt_volumenumber | nullrequiredShort volume exempt from Regulation SHO.
    • facilitiesarray<object>requiredShort volume by reporting facility.3 fields inside
      • facilitystringrequiredFacility.finra_adfnasdaq_carteretnasdaq_chicagonyse
      • short_volumeinteger | nullrequiredShort volume excluding exempt.
      • short_volume_exemptinteger | nullrequiredExempt short volume.
    • non_exempt_volumenumber | nullrequiredShort volume not exempt.
    • short_volumenumber | nullrequiredShares sold short.
    • short_volume_rationumber | nullrequiredShort volume as a percentage of total volume.
    • symbolstringrequiredTicker symbol.
    • total_volumenumber | nullrequiredTotal reported volume.
  • metaobjectrequiredMeta object
  • paginationobjectrequiredPagination object

Example response

{
  "data": [
    {
      "date": "2026-10-14",
      "exempt_volume": 120000,
      "facilities": [
        {
          "facility": "finra_adf",
          "short_volume": 310000,
          "short_volume_exempt": 1200
        }
      ],
      "non_exempt_volume": 18080000,
      "short_volume": 18200000,
      "short_volume_ratio": 44.4,
      "symbol": "AAPL",
      "total_volume": 41000000
    }
  ],
  "meta": {
    "as_of": 1760659200123,
    "coverage": {
      "complete": true
    },
    "delay_ms": 0,
    "delayed": false,
    "request_id": "0199f0c2-5a1e-7c3b-9d4e-2b6f8a1c3d5e",
    "source": "sip"
  },
  "pagination": {
    "count": 1,
    "has_more": false,
    "limit": 100,
    "next_cursor_id": null,
    "next_url": null
  }
}

Values are illustrative. Missing values are null, never 0.