Skip to main content

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.

​
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. 
# 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?

# 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

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

​
Volatility evolution

ANALYTICS_SLIDING_WINDOW(
    symbols="<resolved>",
    metric="variance",
    window_size=100,
    interval="DAILY",
)

​
Macro snapshot

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).