API reference
API reference for LyraMind OS, the financial intelligence infrastructure for AI-first capital markets.
AI Readiness Benchmark API
GET /v1/ai-readiness/benchmark compares a name's AI Readiness against its peer cohort from the graph and ledger, with rank and percentile.
AI Readiness History API
GET /v1/ai-readiness/history returns a name's AI Readiness over time: latest score, delta since last, trend, and prior points from the ledger.
Corporate AI Readiness Report API
POST /v1/ai-readiness/report grades a draft filing across nine dimensions with an institutional simulation, predicted questions, and fixes.
Institutional AI Simulator API
POST /v1/ai-readiness/simulate runs synthetic institutional archetypes over a draft: consensus comprehension, blind spots, and predicted questions.
Institutional Alpha Feed API
GET /v1/alpha/feed returns anonymized market-confusion clusters ranked by a confusion score over the recent question window. API key required.
AI Investment Committee API
POST /v1/committee runs five lenses (growth, momentum, valuation, risk, options) over a symbol and returns per-lens scores plus a composite LyraMind Score.
Company API
POST /v1/company returns a one-call snapshot: market read, confluence score and signals, top risks, what changed, and graph connections in one object.
Disclosure Scan API
POST /v1/disclosure/scan scores how legibly AI agents parse draft filing text: AI_LEGIBLE, REVIEW_LANGUAGE, or HIGH_MISREAD_RISK, with flagged spans.
Execution Readiness API
POST /v1/execution/decide renders the go/no-go before money moves: PROCEED, READY, WAIT, REVIEW, NOT_READY, or HIGH_RISK. Orchestrates, never executes.
Execution Providers API
GET /v1/execution/providers lists connected execution providers that could execute an action, filtered by capability. LyraMind never moves funds.
Explain API
POST /v1/explain turns a ticker's price and volume into a plain-English read: headline, what, why, context, and top risks, with a trust envelope.
Financial Knowledge Graph API
GET /v1/graph returns a name's relationships: sector, ETFs, peers, suppliers, leadership, and macro exposures, plus related tickers to cross-check.
Context Graph Cascade API
GET /v1/graph/cascade walks up from a company to the macro and policy drivers that cascade through its sector, with impact paths and shared peers.
Trust Ledger API
GET /v1/ledger returns recent anonymized entries from the append-only, hash-chained record of every verdict LyraMind gave, filterable by symbol and kind.
Ledger Outcome API
POST /v1/ledger/outcome reconciles a past verdict against what actually happened: borne_out, contradicted, or unclear. Closes the calibration loop.
Ledger Stats API
GET /v1/ledger/stats returns totals by kind, verdict, and data mode, outcome coverage, per-verdict calibration, and the integrity proof.
Ledger Verify API
GET /v1/ledger/verify recomputes the Trust Ledger hash chain and proves it has not been altered, returning intact status, entry count, and the head hash.
Agent Marketplace API
GET /v1/marketplace lists the opinionated agent personas (investor, compliance, macro, catalyst) and which ones record a verdict to the ledger.
Marketplace Run API
POST /v1/marketplace/run runs an agent persona over a symbol and returns a study: headline, findings, and the Trust Layer. Never a recommendation.
Institution Memory API
GET /v1/memory reads a name's Trust Ledger history and derives its track record: times seen, verdict mix, borne-out rate, and confidence trend.
Pulse API
GET /v1/pulse scans a symbol universe for notable conditions, pairs each with news, and returns interpreted events: what happened, the risk, and the view.
Questions Insights API
GET /v1/questions/insights returns the aggregate, anonymized question stream: top symbols, top intents, sources, grounding rate, and recent events.
Agent Readiness API
POST /v1/readiness returns AGENT_READY, REVIEW_REQUIRED, or DO_NOT_EXECUTE with six factors and a 0-100 score, so agents never act on bad intelligence.
Summarize API
POST /v1/summarize condenses free text into key points, or a ticker's situation into a few bullets. Deterministic, offline-safe, with a trust envelope.
Digital Twin Profile API
GET /v1/twin returns a name's conversational profile card: the read, graph connections, and Trust Ledger track record. Ledger-neutral, no readiness write.
Twin Ask API
POST /v1/twin/ask answers a plain-English question about a ticker across the read, graph, memory, and readiness gate. Compliance-safe, never advice.
Verification API
POST /v1/verify runs an independent reasoner panel over a symbol: consensus, agreement, explicit contradictions, and evidence-weighted confidence.