Digital Twin Profile API
Twin returns a name's at-a-glance profile card, assembled from the market read, the Knowledge Graph, and Institution Memory. The profile view is ledger-neutral: it records no readiness verdict.
What it returns
The response returns headline, a read block (what, why, risks), connections from the graph, a memory brief (known, times_seen, signal, weak_track_record), confidence, a list of suggested_questions, the trust envelope, and available.
The suggested questions are ready-made prompts you can feed straight into the Twin Ask endpoint.
When to use it
Use Twin to render a company's conversational card: a single call that gives you the read, its neighborhood, and its track record together, plus the questions a user is likely to ask next. It is the entry point to the conversational surface built on the graph, memory, and ledger.
Because the profile is ledger-neutral, loading a card never writes a verdict; only act or advice questions to Twin Ask do.
Notes and honesty
Twin composes existing engines, so it inherits their sample-versus-live data mode and deterministic behavior. It is a conversational surface, not an advisor. Buy, sell, and hold questions are redirected to the readiness verdict rather than answered as advice.
- headline and read: what, why, and risks
- connections: peers, sector, ETFs, macro from the graph
- memory: the name's track-record brief
- confidence and available flags
- suggested_questions: ready prompts for Twin Ask
- trust envelope inherited from the read
curl -s 'https://api.lyramindos.com/v1/twin?symbol=AAPL' -H 'x-api-key: YOUR_KEY'
Questions
Does loading a twin profile record a verdict?
No. The profile view is deliberately ledger-neutral. Only act or advice questions sent to POST /v1/twin/ask trigger a recorded readiness check.
What are the suggested questions for?
They are ready-made prompts (how is it doing, who does it compete with, have you been right about it, is my agent clear to act) that you can send directly to the Twin Ask endpoint.
Will the twin tell me whether to buy?
No. Buy, sell, and hold questions are redirected to the data-readiness verdict and the read, never answered as advice.