# GET /api/mcp/data/economic-calendar

> When are CPI, FOMC and the jobs report over the next two weeks?

Returns scheduled macro events with date, time, impact level, estimate, previous and actual once released, grouped by date and as a flat list.

- **Family:** Events and calendars (https://apexvol.com/developers/events-calendar-api)
- **Plan:** Basic and above. Every call needs `Authorization: Bearer avmcp_<token>`; tokens are issued to paid and trial accounts under Account, then API Access.
- **Units:** Values in the event's own unit (unit field); times are US Eastern.
- **Basis:** Economic calendar feed; country defaults to US.
- **MCP tools:** `get_economic_calendar`
- **Background:** https://apexvol.com/learn/volatility-trading

## Parameters

| Name | In | Default | Range | Meaning |
|---|---|---|---|---|
| `from_date` | query | today | YYYY-MM-DD | Start. |
| `to_date` | query | +14 days | YYYY-MM-DD | End. |
| `country` | query | US | ISO country | Which calendar. |

## Request

```bash
curl -H "Authorization: Bearer avmcp_YOUR_TOKEN" \
     "https://apexvol.com/api/mcp/data/economic-calendar"
```

## Response (captured 2026-09-08)

Real response, lists cut to the rows nearest the money. The envelope is `{"success": true, "data": ...}`.

```json
{
  "success": true,
  "data": {
    "events": [
      {
        "actual": null,
        "change": null,
        "change_pct": 0,
        "country": "US",
        "currency": "USD",
        "date": "2026-09-09",
        "datetime": "Wed, 09 Sep 2026 16:30:00 GMT",
        "estimate": null,
        "event": "API Crude Oil Stock Change (Sep/04)",
        "impact": "Medium",
        "previous": -2.6,
        "time": "4:30 PM",
        "unit": null
      },
      {
        "actual": null,
        "change": null,
        "change_pct": 0,
        "country": "US",
        "currency": "USD",
        "date": "2026-09-09",
        "datetime": "Wed, 09 Sep 2026 07:00:00 GMT",
        "estimate": null,
        "event": "MBA 30-Year Mortgage Rate (Sep/04)",
        "impact": "Medium",
        "previous": 6.79,
        "time": "7:00 AM",
        "unit": "%"
      },
      {
        "actual": null,
        "change": null,
        "change_pct": 0,
        "country": "US",
        "currency": "USD",
        "date": "2026-09-10",
        "datetime": "Thu, 10 Sep 2026 10:00:00 GMT",
        "estimate": 3.99,
        "event": "Existing Home Sales (Aug)",
        "impact": "High",
        "previous": 4.06,
        "time": "10:00 AM",
        "unit": "M"
      }
    ],
    "high_count": 14,
    "medium_count": 38,
    "success": true,
    "total_count": 52
  }
}
```

## Fields

- `events[].event, date, time, impact`: What and when.
- `events[].estimate, previous, actual, unit`: The numbers.
- `high_count, medium_count`: How busy the window is.
- `by_date`: Events grouped per day.

## Errors

- `401`: no or revoked token
- `429`: Retry-After seconds
- `424`: data feed unavailable, retry
- Full list: https://apexvol.com/developers/errors

## Ask it in an MCP client

- When is the next FOMC and CPI?
- What high-impact macro events are scheduled this week?
- Is there a jobs report before SPY's Friday expiration?

Conventions for units, bases and timestamps: https://apexvol.com/developers/conventions