l0grisk intelligence · english

// api

Public API

This page inventories the bilingual l0g machine surface: Agent Surface 1.18.0, per-producer freshness, fused signal history, evidence graph, Risk Diff, Black Box Recorder, and named, dated, versioned signal series. CORS is open. No key, no authentication, no tracking.

Version française →

// endpoints

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

GET/en/agent-surface/HTMLEnglish documentation for Agent Surface v1.18.0.GET/agents.jsonJSONDiscovery manifest for agents: capabilities, endpoints, usage rules and proof policy.GET/openapi.jsonOPENAPIOpenAPI 3.1 contract for l0g machine-to-machine endpoints.GET/api/v1/claims.jsonJSONAt most three structural claims per article, typed as fact, estimate, inference or scenario.GET/api/v1/evidence-graph.jsonJSONEvidence graph: articles, claims, references, hosts, primary sources and datasets.GET/api/v1/catalog.ndjsonNDJSONFull line-by-line catalog for streaming ingestion, RAG or incremental indexing.GET/api/v1/search-index.jsonJSONCanonical bilingual search index shared by Agent Surface, MCP and WebMCP.GET/llms-full-en.txtTEXTFull English analysis and guide corpus, separate from the French context.GET/api/v1/claims.ndjsonNDJSONTyped claims in line-delimited form, with embedded references.GET/api/v1/sources.jsonJSONPrimary sources and cited hosts actually used by the corpus.GET/api/v1/freshness.jsonJSONCorpus and signal freshness: useful dates, expiration policy and coverage.GET/api/v1/integrity.jsonJSONCanonical SHA-256 fingerprints for verifying a snapshot.GET/api/v1/changes.jsonJSONMachine changefeed: versions, hashes, diff status and semantic changes.GET/api/v1/black-box.jsonJSONBlack Box Recorder: hashed point-in-time frames for replaying public risk states.GET/api/v1/risk-diff.jsonJSONWhat changed in signals, sources, claims, models, articles and confidence.GET/api/v1/catalog.jsonJSONComplete machine catalog: articles, guides, sources, glossary atlas and protocol.GET/api/v1/risk.jsonJSONCurrent historical dashboard state and confluence synthesis.GET/api/v1/debt-risk.jsonJSONCanonical Debt Risk Radar snapshot imported from latest.json.GET/api/v1/risk.xmlAtomLevel-change feed for alerting bots and SIEM-like watchers.GET/api/v1/signals/current.jsonJSONLatest point-in-time observations by instrument.GET/series/HTMLNamed signal-series registry with stable identifiers, methodology versions and dedicated downloads.GET/en/press-resources/HTMLReusable SVG charts, embed code, citation guidance and download links for journalists.GET/api/v1/history.ndjsonNDJSONRaw operational journal at every assembly: fine continuity, server append-only, no individual CI attestation.GET/api/v1/signals/history.jsonJSONCanonical fused history: daily operational journal, attested Black Box frames, current snapshot, coverage and evidence tiers.GET/api/v1/signals/history.ndjsonNDJSONSignal history line-by-line: meta, observations and level-change events.GET/api/v1/signals/history.csvCSVFlat observations for pandas, R, DuckDB or spreadsheets.GET/api/v1/signals/schema.jsonJSONMachine 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

signals/history fuses the operational journal and Black Box without interpolation. seriesDate dates the l0g publication, while observedAt dates the upstream economic observation when available. evidenceTier distinguishes operational-archive, attested-archive and current-snapshot. The raw journal keeps every assembly; the canonical surface samples its last point per UTC day.

import pandas as pd

df = pd.read_csv("https://l0g.fr/api/v1/signals/thermometre-stress-dette/history.csv", parse_dates=["seriesDate"])
df = df.set_index("seriesDate").sort_index()

// fields and guardrails

  • Agent Surface 1.18.0: bilingual M2M contract, with /agents.json for discovery, /openapi.json for schema and /api/v1/integrity.json for snapshot verification.
  • sourceStatus, qualityStatus, fallbackUsed, sourceUpdatedAt, lastAttemptAt and lastSuccessAt prevent a retained best-effort value from looking fresh.
  • language, canonicalId, translationOf, alternateUrl and translationStatus link each translation to its French source.
  • /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: assembled every 15 minutes, with no strict real-time promise. snapshot/generated date the assembly; useful freshness is per signal.
  • Versioning: /v1/ remains stable. Breaking changes will move to /v2/.
  • License: CC BY 4.0. Free reuse with attribution to l0g.fr.