> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gdeltcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Macro Finance Workflow

> Resolving symbols and using the ~120-tool macro-finance category effectively

## When to use

Any question that touches markets, exposure, transmission, fundamentals, sentiment, or US macro indicators.

The macro-finance category is much larger than typical "quotes + indicators" — call `macro_finance_tool_list` once per session to see the \~120-tool catalog (analytics, fundamentals, options chains, sentiment, transcripts, technical indicators, sliding-window analytics, FX, crypto, commodities).

## First: always resolve the symbol

Provider symbols are not interchangeable across vendors. Yahoo or TradingView aliases will fail silently or return the wrong instrument.

```python theme={null}
# Resolve a company → provider-supported symbol
macro_finance_tool_call(
    tool_name="SYMBOL_SEARCH",
    tool_arguments={"keywords": "NVIDIA"}
)
# Returns ranked candidates with venue, currency, type — pick by venue + currency.
```

If a quote/timeseries call returns a symbol error, fall back to `SYMBOL_SEARCH` rather than retrying with variants.

## Common patterns

### Did the market price in this event?

```python theme={null}
# 1. Resolve
SYMBOL_SEARCH(keywords="<related company / index>")

# 2. Get OHLCV around the event date
TIME_SERIES_DAILY_ADJUSTED(symbol="<resolved>", outputsize="full")

# 3. Optional: confirm direction
NEWS_SENTIMENT(tickers="<resolved>")
```

### Earnings transcript with sentiment

```python theme={null}
EARNINGS_CALL_TRANSCRIPT(symbol="<resolved>", fiscal_year=2026, quarter=1)
# Returns full transcript with LLM-derived sentiment signals — 15+ year history.
```

### Volatility evolution

```python theme={null}
ANALYTICS_SLIDING_WINDOW(
    symbols="<resolved>",
    metric="variance",
    window_size=100,
    interval="DAILY",
)
```

### Macro snapshot

```python theme={null}
TREASURY_YIELD(maturity="10year")
FEDERAL_FUNDS_RATE()
CPI()
UNEMPLOYMENT()
NONFARM_PAYROLL()
```

## What the wrapper normalizes

When a selected macro-finance tool returns a recognizable historical payload, the wrapper normalizes it into top-level chart fields:

* `symbol` / `instrument`
* `latest_value`, `latest_date`
* `series`: recent `{ label, date, value }` points
* `series_observation_count`

Brief agents should prefer real provider series from these fields over synthetic two-point lines.

## Provider quirks

* `_ADJUSTED` time series are always preferred over raw OHLCV for return analysis.
* Non-US equities work via venue-suffixed symbols (`.LON`, `.SAO`, `.DEX`, `.FRK`, `.TRT`) returned by `SYMBOL_SEARCH`.
* For options, narrow by expiration date — full chains can be large.
* Indicator tools require an `interval` (intraday for technical work; daily for swing).

## Citation

`<symbol> <metric> <value>, <date> (Alpha Vantage)` — for example, `NVDA close $208.27, 2026-04-24 (Alpha Vantage)`.