Skip to main content
GET
/
v1
/
financials
/
short-interest
Get Short Interest Data
curl --request GET \
  --url https://api.aries.com/v1/financials/short-interest \
  --header 'Authorization: Bearer <token>'
{
  "results": [
    {
      "ticker": "AAPL",
      "settlementDate": "2017-12-29",
      "shortInterest": 45746430,
      "avgDailyVolume": 23901107,
      "daysToCover": 1.91
    }
  ],
  "status": "OK",
  "requestId": "7a867902c54d496b8239089f103b0fa8",
  "nextUrl": "https://api.aries.com/v1/financials/short-interest?cursor=..."
}

Authorizations

Authorization
string
header
required

OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.

Query Parameters

tickers
string

Single ticker or comma-separated list (e.g. AAPL or AAPL,MSFT,GOOG)

Example:

"AAPL"

tickerAfter
string

Ticker greater than (exclusive)

tickerFrom
string

Ticker greater than or equal (inclusive)

tickerBefore
string

Ticker less than (exclusive)

tickerTo
string

Ticker less than or equal (inclusive)

daysToCover
number<double>

Days to cover (exact)

daysToCoverList
string

Comma-separated list of days to cover

daysToCoverAbove
number<double>

Days to cover greater than (exclusive)

daysToCoverMin
number<double>

Days to cover greater than or equal (inclusive)

daysToCoverBelow
number<double>

Days to cover less than (exclusive)

daysToCoverMax
number<double>

Days to cover less than or equal (inclusive)

settlementDate
string<date>

Settlement date (YYYY-MM-DD)

settlementDates
string

Comma-separated list of settlement dates

settlementDateAfter
string<date>

Settlement date after (exclusive)

settlementDateFrom
string<date>

Settlement date from (inclusive)

settlementDateBefore
string<date>

Settlement date before (exclusive)

settlementDateTo
string<date>

Settlement date to (inclusive)

avgDailyVolume
integer<int64>

Average daily volume (exact)

avgDailyVolumeList
string

Comma-separated list of average daily volumes

avgDailyVolumeAbove
integer<int64>

Average daily volume greater than (exclusive)

avgDailyVolumeMin
integer<int64>

Average daily volume greater than or equal (inclusive)

avgDailyVolumeBelow
integer<int64>

Average daily volume less than (exclusive)

avgDailyVolumeMax
integer<int64>

Average daily volume less than or equal (inclusive)

limit
integer

Maximum number of results

Required range: x >= 1
sort
string

Sort field

next
string

Pagination cursor

Response

Successful response

results
object[]
status
string
requestId
string
nextUrl
string

URL for next page of results