AI Readiness History API
History is the continuous-monitoring view: a name's AI Readiness over time, turning a one-off report into a continuously updated signal. It reads straight off the Trust Ledger.
What it returns
The response returns tracked (how many snapshots), the latest entry, delta_since_last, a trend (improving, declining, steady, or insufficient), and a points array of up to fifty prior scores newest-first, each with timestamp, verdict, and score.
Trend reads improving when the newest score is at least 5 points above the oldest tracked and declining when at least 5 below.
When to use it
Use History to track how a name's filing clarity is moving over time, for a monitoring dashboard or an alert on a declining trend. It tracks AI Readiness Report snapshots specifically and falls back to all readiness kinds only when no dedicated reports exist yet.
Nothing new is recorded; it is a read over the ledger.
Notes and honesty
The signal is only as deep as the reports on record. Offline the ledger is in-memory and resets on restart unless Supabase persistence is configured, so history accumulates as you run reports. This is machine-legibility analysis over time, never advice.
- tracked: number of snapshots on record
- latest: the most recent readiness entry
- delta_since_last: change from the prior snapshot
- trend: improving, declining, steady, or insufficient
- points: up to fifty prior scores newest-first
- reads report snapshots, falling back to all readiness kinds
curl -s 'https://api.lyramindos.com/v1/ai-readiness/history?symbol=AAPL' -H 'x-api-key: YOUR_KEY'
Questions
How is the trend computed?
By comparing the newest and oldest tracked scores: improving at 5 or more points up, declining at 5 or more down, otherwise steady, and insufficient with fewer than two points.
What does it track?
AI Readiness Report snapshots for the name, newest-first, up to fifty points. It falls back to all readiness kinds only when no dedicated reports exist yet.
Why is my history empty?
Offline the ledger is in-memory and resets on restart. History accumulates as you run AI Readiness reports; configure Supabase persistence to keep it across restarts.