l0g risk intelligence · english

// api

Public API

This page inventories the l0g machine surface: Agent Surface 1.10, sourced claims, evidence graph, Risk Diff, Black Box Recorder, risk snapshots, canonical debt-risk.json and signals/history for replay and backtests. CORS is open. No key, no authentication, no tracking.

Version française →

// endpoints

Public endpoints, no key and no authentication. Agent Surface 1.10 is the reading contract for agents; risk endpoints remain specialized snapshots.

GET /en/agent-surface/ HTML English documentation for Agent Surface v1.10.0. GET /agents.json JSON Discovery manifest for agents: capabilities, endpoints, usage rules and proof policy. GET /openapi.json OPENAPI OpenAPI 3.1 contract for l0g machine-to-machine endpoints. GET /api/v1/claims.json JSON Typed claim-source graph with references and dates when detectable. GET /api/v1/evidence-graph.json JSON Evidence graph: articles, claims, references, hosts, primary sources and datasets. GET /api/v1/catalog.ndjson NDJSON Full line-by-line catalog for streaming ingestion, RAG or incremental indexing. GET /api/v1/claims.ndjson NDJSON Typed claims in line-delimited form, with embedded references. GET /api/v1/sources.json JSON Primary sources and cited hosts actually used by the corpus. GET /api/v1/freshness.json JSON Corpus and signal freshness: useful dates, expiration policy and coverage. GET /api/v1/integrity.json JSON Canonical SHA-256 fingerprints for verifying a snapshot. GET /api/v1/changes.json JSON Machine changefeed: versions, hashes, diff status and semantic changes. GET /api/v1/black-box.json JSON Black Box Recorder: hashed point-in-time frames for replaying public risk states. GET /api/v1/risk-diff.json JSON What changed in signals, sources, claims, models, articles and confidence. GET /api/v1/catalog.json JSON Complete machine catalog: articles, guides, sources, glossary atlas and protocol. GET /api/v1/risk.json JSON Current historical dashboard state and confluence synthesis. GET /api/v1/debt-risk.json JSON Canonical Debt Risk Radar snapshot imported from latest.json. GET /api/v1/risk.xml Atom Level-change feed for alerting bots and SIEM-like watchers. GET /api/v1/signals/current.json JSON Latest point-in-time observations by instrument. GET /api/v1/signals/history.json JSON Complete point-in-time signal history: coverage, policy, current, observations and level changes. GET /api/v1/signals/history.ndjson NDJSON Signal history line-by-line: meta, observations and level-change events. GET /api/v1/signals/history.csv CSV Flat observations for pandas, R, DuckDB or spreadsheets. GET /api/v1/signals/schema.json JSON Machine schema for meta, observation and level-change rows.

// examples

curl -s https://l0g.fr/agents.json
curl -s https://l0g.fr/api/v1/risk.json
curl -s https://l0g.fr/api/v1/debt-risk.json
curl -s https://l0g.fr/api/v1/signals/history.ndjson | head

// point-in-time history

The signals/history surface is point-in-time: each observation keeps observedAt, sourcePublishedAt, retrievedAt, computedAt and snapshotHash. Backtests use what was actually published or collected at time T, without look-ahead bias. 

import pandas as pd

df = pd.read_csv("https://l0g.fr/api/v1/signals/history.csv", parse_dates=["observedAt", "retrievedAt"])
df = df.set_index("observedAt").sort_index()

// fields and guardrails

  • Agent Surface 1.10: M2M contract, with /agents.json for discovery, /openapi.json for schema and /api/v1/integrity.json for snapshot verification.
  • /api/v1/debt-risk.json: canonical US Debt signal, imported from https://debt.l0g.fr/latest.json, with provenance and coverage when available.
  • /api/v1/signals/history.json: complete surface for replay, with coverage, policy, current, observations and levelChanges.
  • level: human-readable state. tone: machine code such as calm, moderate, elevated or crisis.
  • scaleCaveat and precisionGuard: reading limits around display normalization, freshness, coverage, uncertainty and reproducibility.

There is no single global index. l0g only exposes the measured sub-signals from each tool; aggregating them into one derived number would add false precision.

// notes

  • CORS: Access-Control-Allow-Origin: *.
  • Cadence: regenerated with tool snapshots. Not strict real time; rely on snapshot.
  • Versioning: /v1/ remains stable. Breaking changes will move to /v2/.
  • License: CC BY 4.0. Free reuse with attribution to l0g.fr.