list_market_block_trades
TOOLList market block tradesscope: dataflow:trading.read · read-only
Tool description, as exposed to the agent
Returns the latest off-order-book "block" trades across a whole market, newest first - the market-wide counterpart of list_block_trades, which covers one company. A block trade is a large transaction negotiated away from the public order book (typically arranged between brokers) and reported to the exchange afterwards, so this feed answers "what large trades printed today" without naming a company first: no company_id, no search step. Scope it with countries, which selects by the country of the MARKET the trade printed on rather than where the company is incorporated or primarily listed - a London print of a Stockholm-primary company is a GB row. Omitted, it covers every market your organization is entitled to. Narrow further with min_value, a floor on the trade's value read in USD unless you pass the currency argument (either way the response echoes the unit used as min_value_currency). The rows themselves are never converted: each print is priced in the currency its own stock trades in, named by the row's currency field. The feed already excludes prints below 0.05% of the company's share capital so that it reports blocks rather than every reported trade. Each row names its own company (company_id, ready for the ownership, insider, buyback, short and calendar tools) and 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), the venue it printed on (execution_venue, a MIC), 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. The feed covers the last 30 days (echoed as days) and takes no window parameter; page 1 is always the most recent trades. When next_cursor is present in the response, pass it back as cursor on the next call, keeping every other parameter identical, to receive the next page. Use list_block_trades instead when you have one company in mind. Successful calls may consume Dataflow credits per trade actually returned; an empty result costs zero credits. Basis note: this tool's capital fractions are always computed on total issued shares, including any treasury shares the company holds itself. It does not accept adjust_treasury and cannot report the treasury-adjusted basis (shares outstanding) that the ownership tools offer.Parameters
| Parameter | Type | Description | |
|---|---|---|---|
| countries | string[] | optional | ISO 3166-1 alpha-2 codes of the MARKETS to cover, e.g. ['SE','NO'] for the Swedish and Norwegian markets. This is where the trade printed, not where the company is incorporated: a London print of a Stockholm-primary company is a 'GB' row. Intersected with your entitlement. Omit to cover your full entitlement.max items 20 |
| min_value | number | optional | Minimum trade value to include, expressed in USD unless the currency argument names another code (FX-converted; the returned rows themselves are not converted). Filter to material blocks, e.g. 10000000 for trades worth at least 10 million.min 0 |
| limit | integer | optional | Maximum number of trades per page, newest first. Hard cap 50.default 20 · min 1 · max 50 |
| cursor | string | optional | Opaque pagination token from a prior call's next_cursor. Omit for the first page.max length 512 |
| currency | string | optional | Optional ISO 4217 currency code (e.g. 'GBP', 'USD', 'SEK') giving the unit min_value is expressed in; defaults to USD, and min_value_currency echoes what was used. It does NOT convert the rows: this feed spans a whole market and each print is priced in the currency its own stock trades in (the row's currency field). |
Billing
Pricing key: trading.market_block_trades. Successful calls consume Dataflow credits per your contract. See Credits & pricing.
