Skip to main content
Conduit exposes two complementary views of dated, official events:

Economic calendar

GET /v1/economic-calendar is the scheduled macro release calendar: CPI prints, payrolls, central-bank meetings, with actual, forecast, consensus, and previous values.

Unified events

GET /v1/events merges the calendar with other official events (issuer filings, disclosures, regulator notices) into one normalized shape.
Use the calendar when you want classic macro-release rows with surprise inputs. Use the unified events feed when you want a single stream across event classes (macro releases plus issuer and regulatory events) with one schema.

​
Economic calendar

/v1/economic-calendar returns scheduled and released macro events, each with the release time, the period it covers, and the value series consumers expect on a calendar: actual, forecast, consensus, previous, and (where applicable) revised.

​
Filters

The calendar accepts the standard list filters plus the observation filters relevant to events.
​
country
string
ISO 3 country code, e.g. USA, GBR, EUR (euro area).
​
indicator
string
Canonical indicator slug or id, e.g. cpi_inflation_yoy.
​
importance
string
low, medium, or high.
​
start_date
string
Knowledge-time lower bound (ISO timestamp).
​
end_date
string
Knowledge-time upper bound (ISO timestamp).
​
period
string
The period a value describes: YYYY, YYYY-MM, or YYYY-Qn.
​
limit
integer
default:"100"
Page size, 1 to 500.
​
cursor
string
Opaque pagination cursor.
​
sort
string
Endpoint-supported sort field.
​
order
string
default:"asc"
asc or desc.
curl "https://data.quantoraresearch.com/v1/economic-calendar?country=USA&importance=high&limit=5&order=desc" \
  -H "x-api-key: $CONDUIT_API_KEY"
Response
{
  "data": [
    {
      "id": "ecal_us_cpi_2026_05",
      "providerEventId": "...",
      "sourceId": "bls",
      "providerId": "bls",
      "entityId": "country_usa",
      "countryIso3": "USA",
      "indicatorId": "cpi_inflation_yoy",
      "eventName": "CPI (YoY)",
      "eventType": "economic_release",
      "importance": "high",
      "status": "released",
      "releaseTime": "2026-06-11T12:30:00Z",
      "releaseTimeZone": "America/New_York",
      "period": "2026-05",
      "periodStart": "2026-05-01",
      "periodEnd": "2026-05-31",
      "actualValue": 3.1,
      "forecastValue": 3.2,
      "consensusValue": 3.2,
      "previousValue": 3.3,
      "revisedValue": null,
      "unit": "percent",
      "currency": null,
      "sourceUrl": "https://www.bls.gov/...",
      "attribution": "U.S. Bureau of Labor Statistics",
      "observationId": "obs_...",
      "exposure": "public"
    }
  ],
  "meta": {
    "api_version": "v1",
    "pagination": { "limit": 5, "cursor": null, "next_cursor": null, "has_more": false }
  },
  "requestId": "..."
}

​
Calendar event fields

​
id
string
Calendar event id. Use it with GET /v1/economic-calendar/{eventId}.
​
countryIso3
string
ISO 3 country code (null for non-country events).
​
indicatorId
string
Canonical indicator the event releases (may be null).
​
eventName
string
Human-readable event name.
​
eventType
string
One of economic_release, central_bank, auction, earnings, holiday, other.
​
importance
string
low, medium, high, or unknown.
​
status
string
scheduled, released, revised, canceled, or tentative.
​
releaseTime
string
Scheduled or actual release timestamp (ISO).
​
releaseTimeZone
string
IANA timezone of the release.
​
period
string
The period the value describes (e.g. 2026-05).
​
actualValue
number
Released value. Null until released.
​
forecastValue
number
Conduit/provider forecast where available.
​
consensusValue
number
Street consensus where available.
​
previousValue
number
Prior period value as known at this release (first-release basis).
​
revisedValue
number
Revised value when the event carries a revision; otherwise null.
​
observationId
string
Linked observation the event released, if any. Follow it for provenance.
​
exposure
string
Rights class: public, internal_only, restricted, or blocked.

​
Get a single calendar event

curl "https://data.quantoraresearch.com/v1/economic-calendar/ecal_us_cpi_2026_05" \
  -H "x-api-key: $CONDUIT_API_KEY"

​
First-release vs revised

Macro series are revised after their first print. Conduit keeps both, and the calendar exposes the distinction so you can model surprises honestly.

previousValue is first-release basis

previousValue carries the prior period value as it was known at this release, not the latest revised figure. This is what a forecast was measured against at the time, so it is the correct base for surprise and momentum calculations.
When an event reports a revision, revisedValue is populated and the calendar status is revised. The original actualValue is preserved. Revisions are retained, never overwritten in place.
To see the value set as known on a given date, use the knowledge-time filters (start_date / end_date) and as_of on the observations API. Honest caveat: as_of currently approximates the ingestion timestamp, not full provider-vintage reconstruction. Full vintage reconstruction is future work.

​
Unified events

/v1/events merges the economic calendar with other official events into one normalized response shape. It covers macro releases plus issuer filings (for example SEC filings), issuer disclosures, regulator notices, and corporate actions. Use it when you want a single stream and one schema across event classes.

​
Filters

​
country
string
ISO 3 country code.
​
event_class
string
High-level class: macro_release, central_bank, issuer_filing, issuer_disclosure, regulator_notice, corporate_action, or other.
​
event_type
string
Finer event type within a class (e.g. economic_release, annual_report_filed, earnings_release_filed).
​
status
string
scheduled, released, filed, effective, canceled, tentative, historical, or unknown.
​
exposure
string
Rights class filter: public, internal_only, restricted, or blocked.
​
start_date
string
Time lower bound, matched against the event time (ISO).
​
end_date
string
Time upper bound, matched against the event time (ISO).
​
limit
integer
default:"100"
Page size, 1 to 500.
​
cursor
string
Opaque pagination cursor.
​
sort
string
One of observed_at (default), released_at, effective_at, event_label, event_class, event_type, or status.
​
order
string
default:"desc"
asc or desc. The unified feed defaults to desc.
curl "https://data.quantoraresearch.com/v1/events?event_class=macro_release&country=USA&status=released&limit=5" \
  -H "x-api-key: $CONDUIT_API_KEY"
Response
{
  "data": [
    {
      "id": "obs_or_ecal_id",
      "canonicalEventId": "...",
      "eventClass": "macro_release",
      "eventType": "economic_release",
      "eventLabel": "CPI (YoY)",
      "eventStatus": "released",
      "entityId": "country_usa",
      "countryIso3": "USA",
      "indicatorId": "cpi_inflation_yoy",
      "observedAt": "2026-06-11T12:30:00Z",
      "releasedAt": "2026-06-11T12:30:00Z",
      "effectiveAt": null,
      "periodStart": "2026-05-01",
      "periodEnd": "2026-05-31",
      "title": "CPI (YoY)",
      "summary": null,
      "tags": ["economic_release", "USA", "cpi_inflation_yoy"],
      "sourceId": "bls",
      "providerId": "bls",
      "sourceUrl": "https://www.bls.gov/...",
      "attribution": "U.S. Bureau of Labor Statistics",
      "exposure": "public",
      "linkedObservationId": "obs_...",
      "metadata": {
        "importance": "high",
        "actualValue": 3.1,
        "forecastValue": 3.2,
        "previousValue": 3.3,
        "revisedValue": null
      }
    }
  ],
  "meta": {
    "api_version": "v1",
    "pagination": { "limit": 5, "cursor": null, "next_cursor": null, "has_more": false }
  },
  "requestId": "..."
}

​
Unified event fields

​
id
string
Event id. Use it with GET /v1/events/{eventId}.
​
eventClass
string
High-level class (see the filter list above).
​
eventType
string
Finer event type within the class.
​
eventLabel
string
Short label for the event.
​
eventStatus
string
Lifecycle status (see the status filter list).
​
entityId
string
Subject entity (country, issuer). May be null.
​
countryIso3
string
ISO 3 country code. May be null.
​
indicatorId
string
Linked indicator. May be null.
​
observedAt
string
When the event became known. The default sort field.
​
releasedAt
string
Release timestamp. May be null.
​
effectiveAt
string
Effective timestamp (for effective-dated events). May be null.
​
title
string
Event title.
​
summary
string
Optional summary text. May be null.
​
tags
array
Free-form tags (event type, country, indicator).
​
sourceUrl
string
Link to the official source release.
​
attribution
string
Required source attribution string.
​
exposure
string
Rights class.
​
linkedObservationId
string
Observation linked to the event, if any.
​
metadata
object
Class-specific extras. For macro releases this carries importance, actualValue, forecastValue, consensusValue, previousValue, revisedValue, unit, and currency.

​
Get a single event

curl "https://data.quantoraresearch.com/v1/events/obs_or_ecal_id" \
  -H "x-api-key: $CONDUIT_API_KEY"

​
Calendar vs unified events: which to use

Use the economic calendar

You want macro-release rows with surprise inputs (actual / forecast / consensus / previous / revised) and release-time semantics. Filter by country, indicator, importance, and period.

Use unified events

You want one stream across event classes (macro plus issuer filings, disclosures, regulator notices) with a single schema. Filter by event_class, event_type, status, and time.
Both feeds are rights-aware. Every event carries an exposure class, and only redistribution-safe events appear where the public surface applies. Licensed vendor data never appears on the public surface.

SEC fundamentals

Issuer filings surface here as issuer_filing events; the statements live in the fundamentals endpoint.

Derived analytics

Surprise indices and other analytics are computed from calendar inputs and stored as derived observations.