Trust Ledger API
The Trust Ledger is the append-only, tamper-evident record of every material answer LyraMind gives. This endpoint returns recent anonymized entries: the 'why did the AI say this?' record.
What it returns
The response returns an entries array, newest-first, and the storage backend. Each redacted entry carries id, seq, ts, kind, symbol, verdict, confidence, data_mode, grounded, sources_count, a one-way actor_hash, reasoning, summary, any recorded outcome, and the prev_hash and hash that chain it.
Filter with ?limit=, ?symbol=, and ?kind=.
When to use it
Use the ledger to audit or display the history of verdicts: every readiness, execution, disclosure, and AI-readiness answer is recorded here at the moment it was given. It is an open endpoint with no per-call metering.
The hash chain makes the record tamper-evident; use the verify endpoint to prove it has not been altered, and stats for the calibration view.
Notes and honesty
Entries are redacted for public view: who asked is stored only as a one-way hash, so the ledger keeps signal, never raw identity. Recording never breaks an answer, so writes swallow errors. Offline the ledger is in-memory and bounded, resetting on restart unless Supabase persistence is configured.
- entries: newest-first redacted verdict records
- verdict, confidence, data_mode, grounded per entry
- actor_hash: a one-way hash, never raw identity
- outcome: the reconciled result when present
- prev_hash and hash: the tamper-evident chain
- filterable by limit, symbol, and kind
curl -s 'https://api.lyramindos.com/v1/ledger?limit=20&symbol=AAPL' -H 'x-api-key: YOUR_KEY'
Questions
Is any identity exposed?
No. Each entry stores who asked only as a one-way actor hash. The ledger keeps the signal and the proof, never raw identity.
What gets recorded?
Every material verdict: readiness, execution-readiness, disclosure, and AI-readiness answers, each captured with its trust envelope at the moment it was given and chained by hash.
How do I know it wasn't altered?
The entries are hash-chained. Call GET /v1/ledger/verify to recompute the chain and prove the record is intact, or GET /v1/ledger/stats for the integrity plus calibration view.