Quarterly Summary

Quarterly market regime summary for strategic planning

GET /api/quarterly

Quarterly Summary

cURL

curl --request GET \
  --url https://api.example.com/api/quarterly

200

{
  "summary": {
    "copy": "<string>",
    "provenance": {},
    "recordDateLabel": "<string>"
  },
  "copy": "<string>",
  "provenance": {
    "source": "<string>",
    "recordDate": "<string>",
    "fetchedAt": "<string>",
    "isLive": true
  },
  "recordDateLabel": "<string>",
  "generatedAt": "<string>",
  "version": "<string>"
}

Endpoint

GET /api/quarterly

Returns a quarterly summary of market regime assessment, aggregating trends over a 3-month period. Useful for strategic planning cycles and board presentations.

Response

summary · object · required

Complete quarterly summary object

Show summary properties

copy · string

Human-readable narrative summary of quarterly regime trends

provenance · object

Data source and freshness metadata

recordDateLabel · string

Original record date label (e.g., “March 2, 2026”)

copy · string · required

Human-readable summary (convenience field, duplicates summary.copy)

provenance · object · required

Data lineage information

Show provenance properties

source · string

Data source identifier

recordDate · string

Date of the underlying data

fetchedAt · string

When data was retrieved

isLive · boolean

Whether data is live or from fallback

recordDateLabel · string · required

Original record date label (convenience field)

generatedAt · string · required

ISO 8601 timestamp when summary was generated

version · string · required

API version (e.g., “v1”)

Example Request

curl https://your-domain.com/api/quarterly

Example Response

{
  "summary": {
    "copy": "Q1 2026 shows sustained expansion regime with stable interest rates. Treasury base rate averaged 4.2% with minimal volatility. Yield curve remained normalized throughout the quarter, suggesting continued accommodative conditions. Strategic initiatives can proceed with standard risk parameters.",
    "provenance": {
      "source": "US_TREASURY",
      "recordDate": "2026-03-02",
      "fetchedAt": "2026-03-03T10:30:00Z",
      "isLive": true
    },
    "recordDateLabel": "March 2, 2026"
  },
  "copy": "Q1 2026 shows sustained expansion regime...",
  "provenance": {
    "source": "US_TREASURY",
    "recordDate": "2026-03-02",
    "fetchedAt": "2026-03-03T10:30:00Z",
    "isLive": true
  },
  "recordDateLabel": "March 2, 2026",
  "generatedAt": "2026-03-03T10:00:00Z",
  "version": "v1"
}

Caching Behavior

• Cache Duration: 1 hour (3600 seconds)
• Runtime: Edge
• Revalidation: 3600 seconds

Quarter Labels

The endpoint automatically determines the quarter label from the Treasury record date:

• Q1: January - March
• Q2: April - June
• Q3: July - September
• Q4: October - December

The recordDateLabel reflects the specific data point date, while the summary copy references the broader quarter (“Q1 2026”).

Use Cases

• Quarterly business reviews (QBRs)
• Board presentations on market conditions
• Strategic planning cycles
• Annual/multi-year planning context
• Investor communications

Related Endpoints

• Monthly Summary - More granular monthly analysis
• Yearly Summary - Annual regime overview
• Cadence Alignment - Cross-timeframe consistency