Reach macro and market context — FRED economic series and the release calendar, US market status and holidays, CFTC futures positioning, and CBOE put/call and VIX. Every series is sourced from the Federal Reserve (FRED), the CFTC, or CBOE.
GetEconomicIndicator
The full observation history for one FRED economic series — one row per period with its value — plus the series title, units, frequency, and seasonal-adjustment flag.
Parameters: seriesId (required — e.g. CPIAUCSL, UNRATE), startDate, endDate, maxResults.
Ask: "Show me the recent CPI readings."
Returns (trimmed):
Consumer Price Index for All Urban Consumers: All Items in U.S. City Average (CPIAUCSL)
Units: Index 1982-1984=100 | Frequency: M | Seasonal Adj: SA
| Date | Value |
|------------|---------|
| 2026-03-01 | 330.293 |
| 2026-04-01 | 332.407 |
| 2026-05-01 | 333.979 |
GetLatestEconomicData
The latest reading for every tracked FRED series, grouped by category (interest rates, yield spreads, inflation, employment, and more) — a one-glance macro dashboard.
Parameters: category (optional — filter to one group).
Ask: "What are the latest interest rates and macro readings?"
Returns (trimmed):
Latest Economic Indicators:
| Series | Title | Latest Date | Value | Units |
|----------|------------------------------------------|-------------|-------|---------|
| DFEDTARU | Federal Funds Target Range - Upper Limit | 2026-07-13 | 3.75 | Percent |
| EFFR | Effective Federal Funds Rate | 2026-07-10 | 3.62 | Percent |
| T10Y2Y | 10-Year minus 2-Year Treasury | 2026-07-13 | 0.36 | Percent |
SearchEconomicIndicators
Find a FRED series by name or topic — returns the series ID, title, category, frequency, and units so you can feed the ID to GetEconomicIndicator.
Parameters: query (required), maxResults.
Ask: "What's the FRED series for the unemployment rate?"
Returns:
Economic indicators matching 'unemployment rate':
| Series ID | Title | Category | Frequency | Units |
|-----------|-------------------|------------|-----------|---------|
| UNRATE | Unemployment Rate | Employment | M | Percent |
GetEconomicCalendar
The upcoming economic-release calendar with an importance tier per release and the FRED series each one updates — so you know when the market-moving prints land.
Parameters: startDate, endDate, minImportance, maxResults.
Ask: "What economic releases are coming up this month?"
Returns (trimmed):
Economic release calendar (2026-07-14 to 2026-08-13):
| Date | Release | Importance | Series Updated |
|------------|------------------------|------------|-------------------|
| 2026-07-14 | Consumer Price Index | High | CPIAUCSL, CPILFESL|
| 2026-07-14 | Federal Funds Data | Low | EFFR |
GetMarketStatus
Whether the US equity market is open right now, the current session, and the next open and close — computed from the exchange's curated holiday and early-close calendar, in Eastern Time.
Parameters: none.
Ask: "Is the US stock market open right now?"
Returns:
# US equity market status: closed
- As of: 2026-07-13 21:07 ET (Monday)
- Session: closed
- Regular hours today: 09:30–16:00 ET
- Next open: 2026-07-14 09:30 ET
- Next close: 2026-07-14 16:00 ET
GetMarketCalendar
The US market's holidays and early-close half days for a year (NYSE/Nasdaq), with the date, weekday, type, and holiday name.
Parameters: year.
Ask: "When is the US market closed in 2026?"
Returns (trimmed):
# US equity market calendar — 2026
| Date | Day | Type | Name |
|------------|----------|------------------|-------------------------------|
| 2026-01-01 | Thursday | Holiday (closed) | New Year's Day |
| 2026-01-19 | Monday | Holiday (closed) | Martin Luther King Jr. Day |
| 2026-04-03 | Friday | Holiday (closed) | Good Friday |
GetCftcPositioning
The weekly Commitments of Traders (COT) positioning for one futures contract — open interest and commercial / non-commercial long, short, and spread positions, one row per report date.
Parameters: marketCode (required — from SearchCftcMarkets), startDate, endDate, maxResults.
Ask: "How are traders positioned in crude oil futures?"
Returns (trimmed):
Crude Oil, Light Sweet (NYMEX) (067651) — Energy
| Date | Open Interest | Comm Long | Comm Short | Non-Comm Long | Non-Comm Short |
|------------|--------------:|----------:|-----------:|--------------:|---------------:|
| 2026-06-30 | 1,914,443 | 902,424 | 1,042,572 | 340,698 | 230,167 |
| 2026-07-07 | 1,905,761 | 924,510 | 1,029,132 | 317,773 | 242,024 |
GetLatestCftcData
The latest COT snapshot across every tracked contract, grouped by category (agriculture, energy, metals, financials) — open interest and net commercial / non-commercial positioning at a glance.
Parameters: category (optional — filter to one group).
Ask: "Show me the latest futures positioning across markets."
Returns (trimmed):
Latest COT Positioning:
| Market | Date | Open Interest | Comm Net | Non-Comm Net |
|-------------------|------------|--------------:|---------:|-------------:|
| Corn (CBOT) | 2026-07-07 | 1,711,613 | -67,654 | 100,980 |
| Soybeans (CBOT) | 2026-07-07 | 975,954 | -85,585 | 112,807 |
SearchCftcMarkets
Find a CFTC futures market by name — returns the market code (needed by GetCftcPositioning), name, and category.
Parameters: query (required), maxResults.
Ask: "What's the CFTC market code for crude oil?"
Returns:
CFTC contracts matching 'crude oil':
| Market Code | Name | Category |
|-------------|--------------------------------|----------|
| 067651 | Crude Oil, Light Sweet (NYMEX) | Energy |
GetPutCallRatios
The CBOE equity put/call ratio history — daily call and put volume, total, and the P/C ratio. A rising ratio signals defensive positioning.
Parameters: type (optional), startDate, endDate, maxResults.
Ask: "What's the recent CBOE put/call ratio?"
Returns (trimmed):
CBOE Equity Put/Call Ratios:
| Date | Call Volume | Put Volume | Total | P/C Ratio |
|------------|------------:|-----------:|----------:|-----------|
| 2026-07-09 | 2,408,403 | 1,371,710 | 3,780,113 | 0.57 |
| 2026-07-10 | 3,027,527 | 1,673,293 | 4,700,820 | 0.55 |
GetVixHistory
The CBOE VIX daily OHLC series (the market's "fear gauge"), available back to 1990.
Parameters: startDate, endDate, maxResults.
Ask: "What has the VIX been doing lately?"
Returns (trimmed):
CBOE Volatility Index (VIX):
| Date | Open | High | Low | Close |
|------------|-------|-------|-------|-------|
| 2026-07-09 | 16.58 | 17.27 | 15.76 | 15.84 |
| 2026-07-10 | 16.06 | 16.16 | 14.96 | 15.03 |