Economic Calendar
High-impact macro events, economic surprises, options expiry proximity, and macro sync data. Essential context for regime-aware agents before taking or closing positions.
Overview
Three data feeds covering the macro event landscape: the forward-looking calendar (what's coming today), the backward-looking surprise index (did recent releases beat or miss expectations), and options expiry proximity (when is the next major crypto options expiry).
The Layer 3 Macro Risk Score consumes this data automatically — but raw calendar access lets your agent build its own event-aware logic.
Endpoints
| Endpoint | Description | Price | Preview |
|---|---|---|---|
/oracle/econ/calendar/today | Today's high-impact macro events — CPI, NFP, Fed decisions, ECB, PMI. Impact rating (low/medium/high), scheduled time, prior value, forecast. | $0.05 | /preview ↗ |
/oracle/econ/surprises | Macro surprise index — last 20 releases with actual vs estimate deviation. US, EU, GB, JP, CN. Positive = beat, negative = miss. | $0.10 | /preview ↗ |
/oracle/econ/expiry/btc | BTC options expiry dates — next 8 Deribit expiries tagged weekly/monthly/quarterly with days remaining | $0.05 | /preview ↗ |
/oracle/econ/expiry/eth | ETH options expiry dates — same structure as BTC | $0.05 | /preview ↗ |
Response Format
{
"today_count": 3,
"high_impact_count": 2,
"today": [
{
"event": "US CPI MoM",
"time": "2026-06-11T12:30:00Z",
"impact": "high",
"currency": "USD",
"forecast": 0.3,
"prior": 0.2
},
{
"event": "ECB Rate Decision",
"time": "2026-06-11T13:15:00Z",
"impact": "high",
"currency": "EUR",
"forecast": null,
"prior": 4.25
}
],
"fetched_at": 1781100000,
"signed": true
}{
"currency": "BTC",
"next": {
"date": "2026-06-13",
"type": "weekly",
"days_away": 2,
"open_interest_usd": 840000000
},
"upcoming": [
{"date": "2026-06-13", "type": "weekly", "days_away": 2},
{"date": "2026-06-27", "type": "monthly", "days_away": 16},
{"date": "2026-09-26", "type": "quarterly", "days_away": 107}
],
"fetched_at": 1781100000,
"signed": true
}Use in Agents
The calendar endpoint is most useful when called at session start to check whether a high-impact event is scheduled within the next 4 hours. Many agents use this as a gate — if high_impact_count > 0 and next_event_hours < 2, reduce exposure or pause new entries until after the release.
The expiry endpoint is useful for options-aware agents or any agent that tracks gamma positioning — large options expiries often coincide with price pinning or post-expiry volatility.
Payment
All econ calendar endpoints are x402 only (USDC on Base). Append /preview to any endpoint for unsigned sample data — no payment required.