---
title: "Building an event pack"
description: "Market print, media coverage, and macro backdrop in one client-side event pack."
slug: compose-event-stack
status: published
published_at: 2026-07-17
author: Arman Obosyan
author_url: https://sugra.systems/about
section: composition
series_order: 11
primary_keyword: sugra event pack composition
hero_image: /blog/images/posts/compose-event-stack-hero.jpg
hero_alt: "Building an event pack - Sugra API blog"
og_image: /blog/images/posts/compose-event-stack-hero.jpg
tags:
  - composition
  - finance
  - news
  - macro
---

# Composition: event stack (Finance + News + Macro)

**Series:** compositions (4 of 4)  
**Prerequisites:** [Platform intro](/blog/platform-intro), [Finance](/blog/sugra-finance), [News](/blog/sugra-news), [Macro](/blog/sugra-macro)  
**Directions:** Finance + News + Macro  
**Auth:** `x-api-key`  

Build a **single-name or single-theme event pack**: market print, media coverage, and official macro backdrop. Client-side join only. Not investment advice.

---

## Goal

For symbol `AAPL` (example) and optional theme query:

1. Finance: quote, short history, earnings-history hook  
2. News: curated search + GDELT articles / themes  
3. Macro: 1-2 official series that frame the tape (CPI, policy rate, or curve spread)  

Output one `event_pack` for agents or research UIs.

---

## Call sequence

```text
[Finance] GET /api/v2/quotes/{symbol}/price
[Finance] GET /api/v2/quotes/{symbol}/historical?range=1mo&interval=1d
[Finance] GET /api/v2/quotes/{symbol}/earnings-history?limit=4   (optional)
[News]    GET /api/v1/news/search?q={symbol_or_name}&limit=10
[News]    GET /api/v1/gdelt/articles?q={company_name}&max_records=10
[News]    GET /api/v1/gdelt/themes/trending?period=6h&limit=8    (optional)
[Macro]   GET /api/v1/fred/series/CPIAUCSL?limit=2&units=pc1
[Macro]   GET /api/v1/fred/series/T10Y2Y?limit=2
         -> event_pack
```

```bash
H="x-api-key: $SUGRA_API_KEY"
B=https://sugra.ai
SYM=AAPL

curl -H "$H" "$B/api/v2/quotes/$SYM/price"
curl -H "$H" "$B/api/v2/quotes/$SYM/historical?range=1mo&interval=1d"
curl -H "$H" "$B/api/v1/news/search?q=$SYM&limit=10"
curl -H "$H" "$B/api/v1/gdelt/articles?q=Apple&max_records=10"
curl -H "$H" "$B/api/v1/fred/series/CPIAUCSL?limit=2&units=pc1"
curl -H "$H" "$B/api/v1/fred/series/T10Y2Y?limit=2"
```

Budget: about **6-9 calls** per pack. Cache Macro aggressively (monthly/daily series).

---

## Client package (example)

```python
event_pack = {
    "symbol": symbol,
    "market": {
        "price": quote["regularMarketPrice"],
        "change_pct": quote["regularMarketChangePercent"],
        "market_state": quote.get("marketState"),
        "history_bars": len(history_bars),
        "source": finance_meta.get("source"),
    },
    "media": {
        "curated": curated_items,
        "gdelt": gdelt_items,
        "gdelt_ok": gdelt_ok,
    },
    "macro_backdrop": {
        "cpi_yoy": cpi_yoy,
        "t10y2y": t10y2y,
        "sources": ["fred"],
    },
    "disclaimer": "Composition of market data, media signals, and official series. Not investment advice.",
}
```

Agents should cite each leg's `meta.source` when answering.

---

## Why three directions

| Direction | Role in the pack |
|---|---|
| Finance | What the name is doing (price / path / earnings history) |
| News | What is being published and covered |
| Macro | Official backdrop (inflation, curve) without conflating it with the stock |

Do not merge these into one fake "sentiment score" without documenting your formula.

---

## Variants

| Variant | Change |
|---|---|
| Earnings week | Add earnings-history + calendar; tighten news query to company name |
| Policy day | Emphasize Macro (FRED + BIS) + News policy themes; lighter Finance |
| Multi-name | Batch quotes; share one Macro backdrop across names |

---

## Failure modes

| Failure | Handling |
|---|---|
| GDELT 503 | Curated news only |
| Earnings history empty | Omit section |
| Macro lag | Show observation dates clearly |
| 429 | Partial pack with `truncated: true` |

---

## Read next

- Direction articles: [Finance](/blog/sugra-finance) · [News](/blog/sugra-news) · [Macro](/blog/sugra-macro)  
- Previous composition: [Earth ops](/blog/compose-earth-ops)  
- **Next:** [Conclusion](/blog/series-conclusion)  
- [Series TOC](/blog/platform-intro)