/shares/stock
GET/shares/stockapplication/json · application/xml · text/csv
Requires your access key in the X-Dataflow-Key header (or key query parameter). Which parameters and response fields are available to you depends on your contract; your personal OpenAPI spec from /resources/open-api shows your exact surface.
curl -H "X-Dataflow-Key: $DATAFLOW_KEY" \
"https://dataflow.modularfinance.com/api/shares/stock"Query parameters
| Parameter | Type | Description |
|---|---|---|
| countries | string[] | Filter to companies listed in these countries (ISO 3166-1 alpha-2, e.g. 'SE'). |
| market-segment-ids | integer[] | Filter to companies listed on these market segments. |
| date | string | Snapshot date (YYYY-MM-DD). Defaults to the most recent data. |
Response
An array of SharesStockShares rows, streamed for JSON and CSV.
| Field | Type | Description |
|---|---|---|
| company_id | integer | Modular Finance company identifier. |
| date | string | Date of this snapshot (YYYY-MM-DD). |
| isin | string | ISIN of the share class. |
| market_segment_ids | integer[] | Identifiers of those market segments. |
| market_segments | string[] | Market segments the share class trades on. |
| market_shares | integer | Tradeable shares under the market perspective, excluding the company's own holdings. |
| market_votes | number | Total votes for the share class under the market perspective. |
| market_votes_rounded | number | market_votes rounded to a whole number. |
| mic | string[] | Market Identifier Codes (ISO 10383) of the trading venues. |
| regulatory_shares | integer | Issued shares under the regulatory perspective, including the company's own holdings (the basis for disclosure thresholds). |
| regulatory_votes | number | Total votes for the share class under the regulatory perspective (voting_rights multiplied by regulatory_shares). |
| regulatory_votes_rounded | number | regulatory_votes rounded to a whole number. |
| stock_id | integer | Modular Finance stock (share class) identifier. |
| stock_name | string | Share class name. |
| stock_symbol | string | Ticker symbol of the share class. |
| treasury_shares | integer | Shares of this share class held by the company itself (its treasury owner). Subtract from regulatory_shares to get outstanding shares. |
| voting_rights | number | Number of votes each share of this class carries. |