Skip to main content
This page records notable, user-facing changes to the Conduit API. The contract itself always lives in openapi.json, and live breadth is reported by /v1/public/coverage.
​
v1.0.0
The first public release of the Conduit API. The surface below is stable under /v1, and every response reports meta.api_version = "v1".Data surface
  • Macro observations. Point-in-time, official-source macro readings. Redistribution-safe data on GET /v1/public/observations and GET /v1/public/observations/latest; the full observation surface with attribution, freshness, and rights metadata on GET /v1/observations, /v1/observations/latest, and /v1/observations/changes.
  • Screener. GET /v1/public/screener filters countries and entities by latest canonical-indicator values, with the filter DSL fields discoverable at GET /v1/public/screener/filters.
  • Coverage. GET /v1/public/coverage returns a live breadth summary: catalog totals, public indicator categories, and covered countries.
  • SEC fundamentals. GET /v1/public/companies exposes the scored fundamentals universe (S&P 500 union Nasdaq-100) with sector and industry inline. GET /v1/companies/{idOrLookup}/financials returns structured income, balance-sheet, and cash-flow statements from SEC XBRL.
  • Derived analytics. GET /v1/derived-indicators and GET /v1/derived-observations serve stored derived analytics, each carrying inputObservationIds and sourceRefs.
  • Calendar and events. GET /v1/economic-calendar and GET /v1/events (each with a /{eventId} detail route) cover the economic calendar and unified official events.
  • Catalog routes. GET /v1/canonical-indicators, /v1/entities (plus /resolve, /{idOrSlug}, and /{entityId}/observations), /v1/countries (plus /{idOrIso} and /available-indicators), and /v1/indicators (plus /series and /entities).
Trust and operations
  • Provenance. GET /v1/provenance/observations/{observationId} returns an auditable chain from official release to API response: named source, source URL, raw payload reference metadata, and the ingestion run.
  • Sync and manifest. GET /v1/manifest, /v1/snapshot, and /v1/source-health support sync workflows and report source and connector freshness.
  • Liveness. GET /v1/ops/liveness runs a per-series cadence check to flag silently-frozen feeds.
Platform
  • Response envelope. One shape for every response, with data, meta, and a request_id on success, and stable machine-readable error.code values on failure. Unknown query parameters fail closed.
  • Bi-temporal time model. Period filters describe the period a value covers; knowledge-time bounds and as_of describe when a value became known, with revisions retained, never overwritten.
  • Authentication and scopes. API keys via x-api-key or Authorization: Bearer, with data:read, ops:read, and admin scopes and per-scope rate limits.
  • MCP server. A native Model Context Protocol server with read-only tools (for example screen_macro, get_latest_observations, cross_country, rates_analytics, and observation_provenance) for Claude Code, Claude Desktop, and Cursor.
  • TypeScript SDK. The official @conduit/client package with cursor auto-pagination and a buildScreenerFilter helper.
  • Agent-readable index. GET /llms.txt and GET /llms-full.txt publish a key-free API index for agents.
This changelog starts at the first public release. Future entries will be added here, newest first, as the public surface changes.