Skip to content

Macroeconomic Intelligence ​

Read selected US government economic series via FRED, preserved observations and revisions, original reports, and source-linked AI/ADES interpretation.

Authentication ​

Send your TNL API key as Authorization: Bearer YOUR_TNL_KEY. Existing email-verification and plan quota rules apply. Do not send a FRED credential to these endpoints.

EndpointResult
GET /v1/intel/macroLatest retained series metadata
GET /v1/intel/macro/:idSeries definition and digestion status
GET /v1/intel/macro/:id/versionsImmutable metadata versions
GET /v1/intel/macro/:id/observationsLatest retained value for each reporting period
GET /v1/intel/macro/:id/revisionsSubsequent observed changes with previous revision/value links
GET /v1/intel/macro/:id/releasesTNL-observed change batches, not an official release calendar
GET /v1/intel/macro/:id/reportsOriginal evidence-grounded analyses

IDs: CPIAUCSL, UNRATE, PAYEMS, GDPC1, FEDFUNDS. Collection uses the direct FRED API and requires a configured application credential. Empty collections are possible before initial ingestion.

List responses contain data, nextCursor and schemaVersion: 1. Pass limit (1–100, default 25), cursor (returned positive integer), since (inclusive ISO date/time), or before (exclusive). Time filters refer to TNL observation time, or report publication time for reports. Observations/revisions also accept an exact period=YYYY-MM-DD. Invalid or unknown filters return 400. Unknown series return 404. Results are ordered by archive insertion, newest first, not by economic period. Metadata/report collections reject the period filter.

bash
curl 'https://theneuralledger.com/v1/intel/macro/UNRATE/observations?limit=12' \
  -H 'Authorization: Bearer YOUR_TNL_KEY'

Temporal and numeric meaning ​

  • period: economic reporting period, not an announcement timestamp.
  • value: exact source decimal string; null means FRED supplied missing data, never zero.
  • units, frequency, seasonalAdjustment: native series basis. CPI levels are not inflation rates; GDP levels are not growth rates.
  • realtimeStart / realtimeEnd: FRED real-time validity dates from the retrieved response, not proof that TNL possesses all vintages.
  • sourceUpdatedAt: FRED's source metadata timestamp, retained with its original timezone.
  • observedAt: when TNL collected the data.
  • previousRevision, previousValue, previousUnits, change: retained prior observation and whether this is initial history, a newly seen period, or an observed revision.

Collection refreshes a rolling five-year window every six hours. Accepted history is never deleted. The initial import records values currently available from FRED, not the values originally released years ago. Later changes are appended, including reversions. Historical ALFRED vintage reconstruction and official release calendars are not included in this version. The source set is curated, not comprehensive global coverage.

Analysis and content ​

Each accepted metadata version and observation batch is registered for the shared AI/ADES pipeline. /releases includes batch coverage; metadata includes its own status. The shared /v1/intel/digests?kind=macro_series and ?kind=macro_event endpoints expose coverage. Pending registration/processing is not completed analysis. Reports require complete source digestion and a separate grounding review. A collection with no meaningful evidence may produce no report.

Potential effects on entities, assets and sectors remain conditional and source-linked. No sourced forecast-consensus dataset is included; reports must not claim a release beat/miss or surprise. TNL does not infer an observed market reaction from economic data alone.

Public original reports: /intelligence/macro, /api/macro/reports, /api/macro/reports/:id. Coverage: /api/intelligence/coverage/macro-report/:id. Source revisions preserve existing publications with a visible notice. Internal raw response envelopes and model receipts are not returned by these endpoints.

Sources ​

FRED observations, series definitions, API credentials. Series attribution is retained; adding non-government sources requires a source-specific rights review.

The Neural Ledger API