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, USD value, 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 |
Billing
Pricing key: short.public. Successful calls consume Dataflow credits per your contract. See Credits & pricing.