Short Interest
Query stock short positions and availability.
Available data
- Returns
- Stock short positions, changes and days to cover
- Market coverage
- HK stocks
- What each request returns
- View a stock’s short positions by reporting period, for the latest period or historical records.
Authentication
Query Parameters
Provide at least one of asset_id or query. query also requires market
asset_idstringqueryconditionalAsset identifier for stocks, crypto assets and other asset objects
querystringqueryconditionalStock or ETF ticker/name; market is required when using query
Required with query; optional with asset_id
marketstringqueryconditionalRequired with query; optional when asset_id identifies the subject. HK stocks
Filter by stock and date, and choose whether to include historical records
asset_classstringqueryoptionalAsset class for disambiguation; cannot override the endpoint subject type
settlement_datedatequeryoptionalRequested date; omit for the latest period. For HK dates, check date_semantic_status
include_historybooleanqueryoptionalRequest history; defaults to false
pageintegerqueryoptionalPage number, starting at 1; defaults to 1
page_sizeintegerqueryoptionalDefaults to 50, maximum 100; explicitly set 20 if preferred
Response
request_idstringExamplereq_exampleRequest trace ID
Object resolution status
Data status
Business data
Business records
report_datedateExample2026-10-16Report date
settlement_datedateExample2026-10-16Position date; the reporting date for HK stocks
date_semantic_statusstringExamplereport_date_as_settlementDate semantics; report_date_as_settlement indicates a report-date substitution
short_interestnumberExample76657024Short-interest shares
previous_short_interestnumberExample81361624Previous published short-interest shares
previous_report_datedateExample2026-10-09Previous reporting date
previous_settlement_datedateExample2026-10-09Previous-period date; the reporting date for HK stocks
changenumberExample-4704596Share change versus previous period
change_pctnumberExample-5.782328Change versus previous period (%)
average_daily_volumenumberExample17891800Average daily volume
days_to_covernumberExample4.284478Days to cover
float_sharesnumber | nullFree-float shares
short_float_pctnumber | nullShort interest / free-float shares (%)
currencystringExampleHKDAmount currency; HKD southbound, CNY northbound
listing_idstringExamplelisting_00700_xhkgListing ID
source_symbolstringExample00700Source security code
Pagination, freshness and limitations
GateData object references
Object type
idstringExampleasset_00700_common_stockObject ID
Pagination
pageintegerExample1Current page
page_sizeintegerExample20Page size
totalintegerExample1Total matching records
Source tracking array
ref_idstringExamplesrc_opaqueSource tracking ID
observed_atdatetimeExample2026-10-30T05:00:00ZData observation time
updated_atdatetimeExample2026-10-30T05:00:00ZData update time (UTC)
limitations[]string[]Examplereport_date_as_settlementAdditional information
errorobject | nullError object; null on success