list_public_short_positions
TOOLList public short positionsscope: dataflow:short.read · read-only
Tool description, as exposed to the agent
Returns the named public short positions in a company, or held by a single short-seller, on a given date. Public short positions are individual short positions large enough to require regulatory disclosure — the holder is named, and the position size is reported. Pass exactly one of company_id (from search_securities — "who is short Apple?") or owner_id (from search_owners of an asset manager — "what is Citadel short?"). Each row reports the short-seller, the company shorted, the share class (if available), the shares and capital fraction held, days-to-cover, position value in your organization's configured display currency (value_currency names it), and the return on the position. Ordered by capital descending. Use get_short_interest on the same company for the aggregated snapshot view. Successful calls may consume Dataflow credits.Parameters
| Parameter | Type | Description | |
|---|---|---|---|
| company_id | integer | optional | Company whose public short-sellers to list, from search_securities. Mutually exclusive with owner_id — pass exactly one. Nonzero integer; the sign of the ID has NO meaning; negative IDs are normal and are NOT a flag for 'unlisted', 'private', or anything else. Pass it through verbatim. |
| owner_id | integer | optional | Short-seller whose public positions to list, from search_owners. Mutually exclusive with company_id — pass exactly one. Nonzero integer; the sign of the ID has NO meaning; negative IDs are normal and are NOT a flag for 'unlisted', 'private', or anything else. Pass it through verbatim. |
| at | string | optional | Optional snapshot date in YYYY-MM-DD. Defaults to today UTC. Maximum 2 years in the past. |
| limit | integer | optional | Maximum number of positions, ordered by capital descending. Hard cap 50.default 25 · min 1 · max 50 |
| adjust_treasury | boolean | optional | Denominator behind every capital fraction in the response. false computes them on total issued shares, including any treasury shares the company holds itself, which is the Nordic standard. true computes them on shares outstanding, excluding treasury shares, which is the UK standard and makes the same holding read slightly higher. Defaults to your organisation's configured basis (unadjusted unless configured otherwise). get_shares_outstanding reports both share counts whatever you pass here.default false |
Billing
Pricing key: short.public. Successful calls consume Dataflow credits per your contract. See Credits & pricing.