list_buyback_transactions
TOOLList buyback transactionsscope: dataflow:buyback.read · read-only
Tool description, as exposed to the agent
Returns the individual on-market repurchase trades a company has executed under its buyback program(s), over a lookback window. Use search_securities first to obtain the company_id. Each row reports the trade date, the share class purchased (stock_id, symbol), the number of shares (delta_shares — always positive), the per-share price and currency, the fraction of total capital this represents (delta_capital), the cumulative treasury holding after the trade, and the trade type (e.g. on-market). Results are ordered most-recent first. Pair this tool with get_buyback_program (same company_id) for the headline authorization context. Successful calls may consume Dataflow credits.Parameters
| Parameter | Type | Description | |
|---|---|---|---|
| company_id | integer | required | Company whose buyback trades to fetch, from search_securities. 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. |
| days | integer | optional | Lookback window in calendar days. Default 90 (buybacks are low-volume; a wider default gives more useful context).default 90 · min 1 · max 365 |
| limit | integer | optional | Maximum number of trades, ordered by transaction_date descending. Hard cap 50.default 25 · min 1 · max 50 |
Billing
Pricing key: buyback.transactions. Successful calls consume Dataflow credits per your contract. See Credits & pricing.