# V2 Short Interest and Float

`GET` `https://api.unusualwhales.com/api/shorts/{ticker}/interest-float/v2`

Returns short interest, float size, days-to-cover, and related percentage calculations for a given ticker.

Broker-dealers report short interest to FINRA twice per month then FINRA publishes the aggregated results approximately one week after each submission window closes. Because updates arrive on this fixed schedule, data in the response from this endpoint can lag the current date by several weeks. This is a FINRA reporting constraint, not a data delivery issue or bug.

This endpoint updates twice a month and pulls data from FINRA. The update schedule can be viewed on the FINRA website [here](https://www.finra.org/filing-reporting/regulatory-filing-systems/short-interest)


## Authentication

```
Authorization: Bearer YOUR_API_KEY
```

## Path Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `ticker` | SingleTicker | Yes | A single ticker |


## Response (200)

| Field | Type | Description |
|-------|------|-------------|
| `days_to_cover` | string | The estimated number of days to cover all short positions based on average daily trading volume. |
| `fee_rate` | date | The fee rate. |
| `market_date` | date | The date of the short interest data. |
| `rebate_rate` | date | The rebate rate. |
| `short_interest` | integer | The total number of shares sold short. |
| `short_shares_available` | date | The short shares available. |
| `si_float` | string | The short interest float ratio. |
| `si_float_with_synth_long_pct_of_total_shares` | string | The short interest float ratio with volume of shares sold short added to total float. |
| `symbol` | string | The ticker symbol. |
| `total_float` | integer | The float (available shares for trading). |


## Example

### curl

```bash
curl -X GET "https://api.unusualwhales.com/api/shorts/{ticker}/interest-float/v2" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
```

### Python

```python
import http.client

conn = http.client.HTTPSConnection("api.unusualwhales.com")
headers = {"Authorization": "Bearer YOUR_API_KEY", "Accept": "application/json"}
conn.request("GET", "/api/shorts/{ticker}/interest-float/v2", headers=headers)
response = conn.getresponse()
print(response.read().decode("utf-8"))
```

## Response Example

```json
{
  "data": {
    "days_to_cover": "2.1",
    "fee_rate": "0.2782",
    "market_date": "2023-04-15",
    "rebate_rate": "3.3518",
    "short_interest": 75000,
    "short_shares_available": 10000000,
    "si_float": "0.017647058",
    "si_float_with_synth_long_pct_of_total_shares": "0.01734104046",
    "symbol": "EXMP",
    "total_float": 4250000
  }
}
```