Twin Ask API
Twin Ask answers a plain-English question about a name by routing intent across the read, the Knowledge Graph, Institution Memory, and, for action questions, the Readiness gate. It never gives buy or sell advice.
What it returns
The response returns the symbol, the classified intent, a natural-language answer, the used engines behind it, the trust envelope, and the disclaimer.
Intents span read, risks, peers, suppliers, ETFs, sector, macro, track_record, verification, act, and advice. Routing is deterministic keyword matching, so it is offline-safe with no LLM required.
When to use it
Use Twin Ask as a conversational surface over a name: users type a question and get a grounded answer drawn from the right engine. Graph, memory, and read intents are ledger-neutral. An act question runs the Readiness gate and records a verdict; an advice question is redirected to that verdict rather than answered.
Send symbol and question in the body.
Notes and honesty
The router is deterministic keyword intent-routing; an LLM answerer can plug in behind the same contract later. Compliance is load-bearing: a buy, sell, or hold question is never answered as advice, it is redirected to the data-readiness verdict and the read, with a nudge to use your own judgment or a licensed advisor.
- intent: the classified question type
- answer: grounded natural-language response
- used: which engines produced the answer
- advice questions redirected to the readiness verdict
- act questions run and record a readiness check
- trust envelope and disclaimer on every answer
curl -s https://api.lyramindos.com/v1/twin/ask -H 'Content-Type: application/json' -H 'x-api-key: YOUR_KEY' -d '{"symbol":"NVDA","question":"Who does it compete with?"}'Questions
Does Twin Ask use an LLM?
No. Intent routing is deterministic keyword matching, so it is offline-safe. An LLM answerer can plug in behind the same ask contract later without changing the interface.
What happens if I ask whether to buy?
It is not answered as advice. The advice intent redirects to the data-readiness verdict and the read, with a note to decide with your own judgment or a licensed advisor.
Which questions record to the ledger?
Only act questions, which run the Readiness gate and record a verdict. Read, graph, and memory questions are ledger-neutral.