Short Interest

Query stock short positions and availability.

GET/api/v1/ownership/short-interest
Domain
Flows & Wallets
Level
Asset identification
MCP tool
ownership_flows_query (task=short_interest)

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

Send Authorization: Bearer YOUR_API_KEY or X-API-KEY on every request.

Query Parameters

Asset identification

Provide at least one of asset_id or query. query also requires market

asset_idstringqueryconditional

Asset identifier for stocks, crypto assets and other asset objects

querystringqueryconditional

Stock or ETF ticker/name; market is required when using query

Market

Required with query; optional with asset_id

marketstringqueryconditional

Required with query; optional when asset_id identifies the subject. HK stocks

Filters and pagination

Filter by stock and date, and choose whether to include historical records

asset_classstringqueryoptional

Asset class for disambiguation; cannot override the endpoint subject type

settlement_datedatequeryoptional

Requested date; omit for the latest period. For HK dates, check date_semantic_status

include_historybooleanqueryoptional

Request history; defaults to false

pageintegerqueryoptional

Page number, starting at 1; defaults to 1

page_sizeintegerqueryoptional

Defaults to 50, maximum 100; explicitly set 20 if preferred

Response

request_idstringExamplereq_example

Request trace ID

resolution_statusResolutionStatusExampleresolved

Object resolution status

data_statusDataStatusExamplepartial

Data status

dataobject

Business data

items[]object[]

Business records

report_datedateExample2026-10-16

Report date

settlement_datedateExample2026-10-16

Position date; the reporting date for HK stocks

date_semantic_statusstringExamplereport_date_as_settlement

Date semantics; report_date_as_settlement indicates a report-date substitution

short_interestnumberExample76657024

Short-interest shares

previous_short_interestnumberExample81361624

Previous published short-interest shares

previous_report_datedateExample2026-10-09

Previous reporting date

previous_settlement_datedateExample2026-10-09

Previous-period date; the reporting date for HK stocks

changenumberExample-4704596

Share change versus previous period

change_pctnumberExample-5.782328

Change versus previous period (%)

average_daily_volumenumberExample17891800

Average daily volume

days_to_covernumberExample4.284478

Days to cover

float_sharesnumber | null

Free-float shares

short_float_pctnumber | null

Short interest / free-float shares (%)

currencystringExampleHKD

Amount currency; HKD southbound, CNY northbound

listing_idstringExamplelisting_00700_xhkg

Listing ID

source_symbolstringExample00700

Source security code

metadataobject

Pagination, freshness and limitations

object_refs[]object[]

GateData object references

typeObjectRefTypeExampleasset

Object type

idstringExampleasset_00700_common_stock

Object ID

paginationobject

Pagination

pageintegerExample1

Current page

page_sizeintegerExample20

Page size

totalintegerExample1

Total matching records

source_refs[]object[]

Source tracking array

ref_idstringExamplesrc_opaque

Source tracking ID

observed_atdatetimeExample2026-10-30T05:00:00Z

Data observation time

updated_atdatetimeExample2026-10-30T05:00:00Z

Data update time (UTC)

limitations[]string[]Examplereport_date_as_settlement

Additional information

errorobject | null

Error object; null on success

Errors & fallback

200
The request was processed and query results are returned.
400
Missing identity, conflicting parameters, invalid enum/date/range or quarter (YYYY/Qn).
404
Object not found or ambiguous; refine identity.
422
Market or asset type not supported.
503
The requested data is temporarily unavailable.
502
Upstream error without usable cached data.