AI Readiness Benchmark API
Benchmark compares a company's AI Readiness against its peer cohort. The cohort comes from the Knowledge Graph, and every peer's score comes from the Trust Ledger of readiness reports already run.
What it returns
The response returns ai_readiness (the name's latest score), a cohort_average, rank, of, and percentile, the ranked cohort, the most_clearly_explained and most_misunderstood names, a narrative, a coverage block (cohort size and how many are scored), and the trust envelope.
When no scores exist yet for the name or its peers it returns available:false with a note to run reports across the cohort first.
When to use it
Use Benchmark to place a name's filing clarity among its peers: 'your AI Readiness is 62, cohort average 78, clearest peer MSFT at 88.' It is a read over the graph and ledger and records nothing new.
The more filings the platform scores, the sharper the benchmark, since it reads from the accumulating ledger of AI Readiness reports.
Notes and honesty
Benchmark prefers a name's dedicated AI Readiness Report snapshot and falls back to a disclosure scan only when no report exists, so ad-hoc draft scans never override an actual readiness score. It compares machine-legibility scores of public disclosures via transparent analysis, never securities, and never advice or a prediction.
- ai_readiness: the name's latest score
- cohort_average, rank, of, percentile
- cohort: ranked peer scores and verdicts
- most_clearly_explained and most_misunderstood
- coverage: cohort size and how many are scored
- trust envelope over ledger-sourced scores
curl -s 'https://api.lyramindos.com/v1/ai-readiness/benchmark?symbol=AAPL' -H 'x-api-key: YOUR_KEY'
Questions
Where do peer scores come from?
The cohort comes from the Knowledge Graph, and each peer's score is read from the Trust Ledger of AI Readiness reports already run. Nothing new is recorded.
What if no peers have been scored?
The response returns available:false with a note to run AI Readiness reports across the cohort first. It never fabricates comparison scores.
Does it compare stocks?
No. It compares machine-legibility scores of public disclosures, not securities, and it is never advice or a prediction.