Companies & stocks

Dataflow distinguishes between the legal entity and its tradable instruments.

Companies

A company is the listed legal entity: Volvo AB, not VOLV B. Ownership, free float, short interest and buybacks are tracked at company level. Companies carry a company_id, an LEI where one exists, a country, sector/industry classification and their market listings.

Two things to know about company_id:

• It's Modular Finance's internal identifier and the join key across every domain and both interfaces; REST and MCP use the same IDs.
• The numbers carry no meaning. Negative IDs are normal and are not a flag for unlisted, private or anything else. Pass them through verbatim.

Stocks (share classes)

A stock is one share class of a company: Volvo AB has VOLV A and VOLV B. Stocks carry a stock_id, ISIN, ticker symbol, listing currency and market segments. Companies with multi-class structures have several stocks with different voting power, which is why a position's capital fraction and votes fraction can differ. See Changes & deltas for how both are reported.

Looking things up

• REST: the /entities/company and /entities/stock endpoints serve reference data, filterable by country, symbol or company-ids.
• MCP: search_securities resolves free text (a name, ticker, ISIN or LEI) to companies with their share classes.