Modular Finance Dataflow

list_block_trades

TOOLList block tradesscope: dataflow:trading.read · read-only
Tool description, as exposed to the agent
Returns the off-order-book "block" trades executed on a company's shares over a lookback window. A block trade is a large transaction negotiated away from the public order book (typically arranged manually between brokers) and reported to the exchange afterwards. Use search_securities first to obtain the company_id. Each row reports the execution date, the share class (stock_id, symbol), the number of shares and the fraction of company capital it represents (delta_capital), the per-share price and notional value, the price relative to the prevailing market (rel_price — a premium or discount), and the buying and selling BROKERS (buyer_broker / seller_broker with their names). Note: buyer and seller are the intermediating brokers/dealers, NOT the beneficial owners of the shares — do not treat them as owners. Cancelled or corrected reports are flagged with is_cancelled rather than removed. Results are ordered most-recent first; when next_cursor is present in the response, pass it back as cursor on the next call to receive the next page. Successful calls may consume Dataflow credits.

Parameters

ParameterTypeDescription
company_idintegerrequiredCompany whose block trades to list, 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.
daysintegeroptionalLookback window in calendar days, counted back from today (UTC). Default 30.default 30 · min 1 · max 365
limitintegeroptionalMaximum number of trades per page, ordered by execution time descending. Hard cap 50.default 20 · min 1 · max 50
cursorstringoptionalOpaque pagination token from a prior call's next_cursor. Omit for the first page.

Billing

Pricing key: trading.block_trades. Successful calls consume Dataflow credits per your contract. See Credits & pricing.