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 |
```