Company API
Company is the one-call intelligence snapshot for a name. It composes the Market Brain read, the confluence score, top risks, recent changes, and graph connections into a single stable object.
What it returns
The snapshot contains identity, a market_read (condition, plain-language phrasing, confidence, explanation), a confluence block (score, headline, signals), risks (up to three), what_changed (up to three), and connections: the graph-aware view of peers, sector, ETFs, and macro exposures.
As with every primitive, a trust envelope rides along with confidence, sources, evidence, data_mode, freshness, and compliance status.
When to use it
Use Company when you want the whole picture in one request rather than stitching Explain, graph, and signals together yourself. It is the natural backing call for a name's detail page or an agent's first look at a symbol.
Results are cached 5 minutes per symbol. When history is insufficient the call returns available:false with a null market read.
Notes and honesty
Connections come from the curated seed Knowledge Graph offline, extended by live sources (Polygon peers and sector, SEC EDGAR, congressional trades) when configured. The confluence and market read are deterministic engine outputs. Descriptive and educational only, never a buy or sell view.
- snapshot.market_read: condition, plain phrasing, confidence, explanation
- snapshot.confluence: score, headline, and signal list
- snapshot.risks and what_changed: up to three each
- snapshot.connections: peers, sector, ETFs, macro from the graph
- trust: confidence, sources, data_mode, freshness, compliance
- available flag and provider on every response
curl -s https://api.lyramindos.com/v1/company -H 'Content-Type: application/json' -H 'x-api-key: YOUR_KEY' -d '{"symbol":"NVDA"}'Questions
How is this different from Explain?
Explain returns a single narrative. Company returns a structured snapshot: the read plus confluence, risks, what changed, and graph connections in one object.
Are the peer and sector connections live?
Offline they come from a curated seed graph, clearly labeled. When Polygon, SEC EDGAR, or FMP keys are configured, live edges merge over the seed via the same contract.
Is a key required?
No, anonymous access is metered per IP. A key raises your rate limit and is reported in the X-LyraMind-Tier header.