Skip to content

Daily Short Volume ​

GET /api/v1.0/quote/{symbol}/short/daily-volume

Get daily short selling trade data for a symbol, sorted by date from newest to oldest. HK returns trade-level short data (short selling turnover, daily average ratio, etc.). US returns position-level short data (total short shares, Nasdaq/NYSE short shares, short ratio, etc.).

Parameters ​

NameTypeInRequiredDescription
symbolstringpathyesSymbol code, e.g. HK.00700 or US.AAPL.
countintquerynoNumber of records. Default 30, max 90.

Request Example ​

bash
curl "https://webapi.futunn.com/api/v1.0/quote/HK.00700/short/daily-volume?count=2" | jq

Response Fields ​

HK items fields:

NameTypeDescription
dataobject
data.itemsobject[]
data.items[].timestampintData time, millisecond timestamp, e.g. 1779336000000
data.items[].timestamp_strstringData date in YYYY-MM-DD (in market timezone), e.g. 2026-05-29
data.items[].shares_tradedintTotal shares traded for the day, e.g. 39653795
data.items[].turnovernumberTurnover for the day (HKD), e.g. 17646360645.68
data.items[].short_sell_shares_tradedintShort-sell shares traded for the day, e.g. 3261400
data.items[].short_sell_turnovernumberShort-sell turnover for the day, e.g. 1452038240
data.items[].open_pricenumberOpen price for the day, e.g. 460
data.items[].close_pricenumberClose price, e.g. 304.99
data.items[].last_close_pricenumberPrevious day close price, e.g. 302.25
data.items[].daily_trade_avg_rationumberDaily trading average ratio (percentage), e.g. 11.49
data.items[].total_shares_shortintTotal shares short, e.g. 5080936
data.items[].nasdaq_shares_shortintNasdaq shares short, e.g. 3485781
data.items[].nyse_shares_shortintNYSE shares short, e.g. 1595155
data.items[].short_percentnumberShort percent (percentage), e.g. 11.825 means 11.825%
data.items[].volumeintVolume, e.g. 42965126
data.marketstringMarket identifier, fixed as US
data.aggregated_shortintAggregated short-position shares (HK only), e.g. 54177721
data.aggregated_short_rationumberAggregated short ratio versus outstanding shares (percentage, HK only), e.g. 0.59
data.new_timestringData update time string (HK only), format dd/MM/yyyy, e.g. 15/05/2026
paginationobjectPagination returned by some endpoints

HK data-level additional fields:

FieldTypeDescription
marketstringMarket identifier, fixed HK.
aggregated_shortintAggregated short position shares.
aggregated_short_ratiofloatAggregated short as percentage of float (%).
new_timestringData update time (dd/MM/yyyy).

US items fields:

FieldTypeDescription
timestampintData time (millisecond timestamp).
timestamp_strstringData date (yyyy-MM-dd).
total_shares_shortintTotal short shares on the day.
nasdaq_shares_shortintNasdaq short shares.
nyse_shares_shortintNYSE short shares.
short_percentfloatShort percentage (%).
volumeintVolume.
close_pricefloatClose price.
last_close_pricefloatPrevious trading day close price.
daily_trade_avg_ratiofloatDaily trade average ratio (%).

Supported Markets ​

  • Markets: HK and US only. Other markets are not supported.
  • Categories: Only shortable securities (stocks, ETFs, REITs, etc.). Options, futures, warrants, indices are not supported.
  • Non-designated shortable securities return no_data.

Error Codes ​

ret_codeerror.codeTrigger ConditionHandling
0--Success--
-3invalid_parametercount out of range / invalid symbol formatCorrect parameters and retry
-7invalid_symbolsymbol cannot be resolved to a securityCheck symbol code
-8unsupportedMarket or category not supportedOnly call for HK/US shortable securities
-10no_dataNo short selling data for the securityTreat as no short data available

Response Example ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "market": "HK",
    "aggregated_short": 46242547,
    "aggregated_short_ratio": 0.5,
    "new_time": "29/05/2026",
    "items": [
      {
        "timestamp": 1780588800000,
        "timestamp_str": "2026-06-05",
        "shares_traded": 31649780,
        "turnover": 14465428854.749,
        "short_sell_shares_traded": 4660100,
        "short_sell_turnover": 2135963680,
        "open_price": 461.6,
        "close_price": 453.2,
        "last_close_price": 459,
        "daily_trade_avg_ratio": 10.51
      }
    ]
  }
}