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.
| Endpoint | Result |
|---|---|
GET /v1/intel/macro | Latest retained series metadata |
GET /v1/intel/macro/:id | Series definition and digestion status |
GET /v1/intel/macro/:id/versions | Immutable metadata versions |
GET /v1/intel/macro/:id/observations | Latest retained value for each reporting period |
GET /v1/intel/macro/:id/revisions | Subsequent observed changes with previous revision/value links |
GET /v1/intel/macro/:id/releases | TNL-observed change batches, not an official release calendar |
GET /v1/intel/macro/:id/reports | Original 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.
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.