Short Flow

Query daily short-sale volume and ratios.

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

Available data

Returns
Daily short volume, total volume and short ratio
Market coverage
US and HK stocks
What each request returns
View daily short-sale volume for a stock or ETF.

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. US and HK stocks

Filters and pagination

Filter daily short-sale volume by stock or ETF and trading date

asset_classstringqueryoptional

Asset class for disambiguation; cannot override the endpoint subject type

sourcestringqueryoptional

Data routing; defaults to auto. Available routes depend on market and asset class

include_venue_breakdownbooleanqueryoptional

Whether to return reporting institution details

fromdatequeryoptional

Inclusive start date: reporting date for institutional rows, trade date for other lists

todatequeryoptional

Inclusive end date; must not precede from

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

trade_datedateExample2026-10-28

Trade date

short_volumenumberExample5519973

Daily short-sale volume

short_exempt_volumenumber | null

Short-exempt volume

total_volumenumberExample11897936

Total volume within the same coverage

short_rationumberExample0.46394375

Short volume as a share of total volume, 0–1

short_turnovernumber | null

Short-sale turnover

currencystring | null

Amount currency; HKD southbound, CNY northbound

listing_idstringExamplelisting_aapl_xnas

Listing ID

tickerstringExampleAAPL

Security ticker

source_symbolstringExampleAAPL

Source security code

metadataobject

Pagination, freshness and limitations

object_refs[]object[]

GateData object references

typeObjectRefTypeExampleasset

Object type

idstringExampleasset_aapl_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[]Examplecoverage_limitation

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.