list_market_transactions
TOOLList market transactionsscope: dataflow:ownership.read · read-only
Tool description, as exposed to the agent
Returns the largest recent ownership changes across a whole market, not a single company. This is a discovery feed: use it to answer "who made the biggest moves in a market lately" rather than to inspect one entity (for that, use list_owner_changes or list_portfolio_changes). Filter by countries (always limited to your entitlement) and by min_delta_value to see only material moves (a floor on the change value, expressed in your organization's configured display currency). Each row reports the change date, the company and owner (both as navigable ids), the share class, the signed change in shares and capital, the resulting stake, and the value of the change in the currency the shares trade in (the row's currency field; unlike min_delta_value this one is not converted). mode selects the beneficial-owner or manager perspective. 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. 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 | ISO2 country codes to include, e.g. ['SE','NO']. Intersected with your entitlement. Omit to use your full entitlement. |
| min_delta_value | number | optional | Minimum absolute value of the ownership change to include, expressed in your organization's configured display currency (FX-converted). Filter to material moves, e.g. 10000000 for changes worth at least 10 million.min 0 |
| mode | 'beneficial' | 'manager' | optional | Ownership perspective. 'beneficial' aggregates to the beneficial owner; 'manager' shows the managing entity. Market convention differs by market: for UK (GB) companies the standard perspective is 'manager', for Nordic companies (SE, NO, DK, FI, IS) it is 'beneficial'. Defaults to your organisation's configured perspective ('beneficial' unless configured otherwise).default "beneficial" |
| limit | integer | optional | Maximum number of transactions per page, ordered most-recent 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. |
Billing
Pricing key: ownership.market_transactions. Successful calls consume Dataflow credits per your contract. See Credits & pricing.
