Skip to main content
GET
/
api
/
quarterly
Quarterly Summary
curl --request GET \
  --url https://api.example.com/api/quarterly
{
  "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
​
copy
string
required
Human-readable summary (convenience field, duplicates summary.copy)
​
provenance
object
required
Data lineage information
​
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

Build docs developers (and LLMs) love

Get started for freeTalk to us