# Alphagbm Macro View

> >

- **Type:** Skill
- **Install:** `agentstack add skill-alphagbm-skills-alphagbm-macro-view`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [AlphaGBM](https://agentstack.voostack.com/s/alphagbm)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [AlphaGBM](https://github.com/AlphaGBM)
- **Source:** https://github.com/AlphaGBM/skills/tree/main/skills/alphagbm-macro-view
- **Website:** https://www.alphagbm.com/skills

## Install

```sh
agentstack add skill-alphagbm-skills-alphagbm-macro-view
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# AlphaGBM Macro View

Track key macro indicators — VIX, US10Y, DXY, gold, oil, BTC, etc. — in the user's knowledge base. Each indicator comes with auto-computed impact analysis linked to the user's actual holdings.

## When to use

- User wants to start tracking a macro variable (VIX, yields, USD, gold…)
- User asks for current macro dashboard / snapshot
- User asks how a macro change affects their portfolio
- User wants to stop tracking an indicator
- User mentions "宏观" / "VIX" / "美债" / "美元" / "macro" / "yield"

## Prerequisites

- **API Key**: env `ALPHAGBM_API_KEY` (format `agbm_xxxx…`).
- **Base URL**: default `https://alphagbm.zeabur.app`. Override via `ALPHAGBM_BASE_URL`.
- No profile requirement — macro tracking is independent of the company profile list.

## API Endpoints

All endpoints require `Authorization: Bearer $ALPHAGBM_API_KEY`.

### 1. List tracked indicators (also returns supported catalog)

```
GET /api/research/macro
```

**Response:**
```json
{
  "success": true,
  "indicators": [
    {
      "indicator_key": "VIX",
      "display_name": "CBOE Volatility Index",
      "current_value": 18.2,
      "previous_value": 16.8,
      "change_pct": 8.3,
      "impact_analysis": "Rising VIX — elevated uncertainty. Your NVDA & TSLA positions are high-beta; consider…",
      "last_updated_at": "2026-04-13T10:15:00Z"
    }
  ],
  "supported": {
    "VIX":    {"name": "CBOE Volatility Index",   "category": "volatility"},
    "US10Y":  {"name": "US 10-Year Treasury",     "category": "yields"},
    "DXY":    {"name": "US Dollar Index",         "category": "currency"},
    "GOLD":   {"name": "Gold Spot",               "category": "commodity"},
    ...
  }
}
```

The `supported` field is the catalog of valid `indicator_key` values. Use it to present options when the user asks "what can I track".

### 2. Add indicator

```
POST /api/research/macro
Content-Type: application/json

{"indicator_key": "VIX"}
```

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `indicator_key` | string | yes | Must be in the `supported` catalog |

**400 response for unsupported keys:**
```json
{
  "success": false,
  "error": "Unsupported indicator. Supported: ['VIX', 'US10Y', 'DXY', ...]"
}
```

### 3. Remove indicator

```
DELETE /api/research/macro/
```

Uses the key (`VIX`, not an id). 404 if not tracked.

## Response schema — indicator

```
{
  id, indicator_key,
  display_name,              // human-readable name
  current_value,             // most recent reading
  previous_value,            // for change_pct computation
  change_pct,                // % change
  impact_analysis,           // AI-generated, references user's holdings
  last_updated_at
}
```

## Common indicator keys

| Key | Meaning | Why it matters |
|-----|---------|---------------|
| `VIX` | CBOE Volatility Index | Risk sentiment, option pricing |
| `US10Y` | US 10-Year Treasury Yield | Discount rate, bond-equity rotation |
| `US2Y` | US 2-Year Yield | Rate-hike expectations |
| `DXY` | US Dollar Index | EM / commodity / multinational earnings |
| `GOLD` | Gold spot | Hedge, real-yield inverse |
| `OIL` | WTI crude | Inflation / energy sector |
| `BTC` | Bitcoin | Risk appetite, crypto-adjacent stocks |
| `HKD` | HKD liquidity | HK market liquidity signal |

Always call `GET /api/research/macro` first to fetch the live `supported` catalog — keys may be added/retired.

## Typical Workflow

```
1. User: "Track VIX and the 10-year yield"
   → POST /api/research/macro {"indicator_key": "VIX"}
   → POST /api/research/macro {"indicator_key": "US10Y"}
   → Confirm both added with their current values

2. User: "What's the macro picture?"
   → GET /api/research/macro
   → Present each indicator: value, change, impact on their holdings

3. User: "Stop tracking DXY"
   → DELETE /api/research/macro/DXY

4. User: "Is high VIX hurting my positions?"
   → GET /api/research/macro → read VIX's impact_analysis field
   → The impact_analysis already references the user's specific holdings
```

## Output Formatting Tips

When presenting macro indicators:
1. **Table-first** for multi-indicator views: key · value · change% · one-line impact
2. **Highlight change direction** with arrow/color (↑ red for VIX/yields up, ↓ green etc.)
3. **Lead with impact_analysis** when user asks "how does X affect my portfolio" — it's pre-computed with their holdings in mind
4. **Stale data** — if `last_updated_at` > 1d old, note "data may be stale, refresh coming"
5. When user asks "what can I track", show the `supported` catalog grouped by category

## Related Skills

- **alphagbm-company-profile** — Macro impact analysis references the user's profiles
- **alphagbm-market-sentiment** — Broader cross-asset sentiment read
- **alphagbm-iv-rank** — Options-specific volatility context

---

*Powered by [AlphaGBM](https://alphagbm.com) — Real-data options & research intelligence for traders and AI agents. 10K+ users.*

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [AlphaGBM](https://github.com/AlphaGBM)
- **Source:** [AlphaGBM/skills](https://github.com/AlphaGBM/skills)
- **License:** MIT
- **Homepage:** https://www.alphagbm.com/skills

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-alphagbm-skills-alphagbm-macro-view
- Seller: https://agentstack.voostack.com/s/alphagbm
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.