Marketplace Run API
Marketplace Run executes one agent persona over a symbol and returns its study. Same engine underneath, one opinionated voice on top, tuned for one job.
What it returns
The response returns agent, symbol, a headline, a findings array, the used engines, the trust envelope, a compliance note, and the disclaimer. Investor findings surface the readiness verdict, the LyraMind Score, and the track record; Compliance surfaces grounding, ledger integrity, and auditable history; Macro surfaces sector, exposures, cohort, and the read; Catalyst surfaces risks, changes, and interpreted events.
An unknown persona id returns an error plus the list of available ids.
When to use it
Use Marketplace Run when you want a persona's focused study rather than a raw primitive. Pass agent (one of investor, compliance, macro, catalyst) and symbol. The GET form takes ?agent=&symbol=.
The Investor persona records a readiness verdict to the Trust Ledger; the other three are ledger-neutral.
Notes and honesty
Personas compose deterministic, compliance-safe engines. The Investor persona leans on the readiness verdict and committee score (already compliance-safe) and never says buy. The Catalyst study is technical, flow, and event based; fundamental inputs are a stated planned addition. Considerations, never a recommendation.
- agent and headline: the persona and its one-line read
- findings: the persona's specific study points
- used: which engines the persona composed
- investor records a verdict; others are ledger-neutral
- trust envelope and compliance note
- error plus available ids for an unknown persona
curl -s 'https://api.lyramindos.com/v1/marketplace/run?agent=compliance&symbol=AAPL' -H 'x-api-key: YOUR_KEY'
Questions
Which personas can I run?
investor, compliance, macro, and catalyst. Passing any other id returns an error object listing the available ids.
Does running a persona record to the ledger?
Only the Investor persona, which runs a readiness check and records a verdict. Compliance, Macro, and Catalyst are ledger-neutral reads.
Is a persona study advice?
No. Each study is a set of considerations and factors carrying the Trust Layer, never a buy or sell recommendation.