# ioswarm Economic & Earnings Calendar

> ioswarm Economic & Earnings Calendar is a paid API for AI agents from ioswarm.io, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-11).

Returns upcoming economic releases (8-day forecast) across 11 major economies and US earnings due or recently reported, with estimates and surprise data, rebuilt hourly.

## Facts

- Endpoint: POST https://ioswarm.io/api/v1/feeds/calendar?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ioswarm-economic-earnings-calendar-a6d5f6d9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dxprqu5B9k2K60ewkIxWi

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability ioswarm-economic-earnings-calendar-a6d5f6d9 -d '<json body>'
```

Example prompt: Pull the economic and earnings calendar for the next 8 days — show me all sections including upcoming economic releases across major economies and US earnings for companies over $2B, filtered to just tomorrow's date.

## When to prefer this

Choose this endpoint when you need a combined macro economic calendar and US earnings schedule in a single call, with actuals printing in near-real-time and hourly refresh. Prefer it over scraped or delayed sources when you need forecast vs actual comparisons and earnings surprise data for $2B+ companies without requiring an account or subscription.

## Known failure modes

- Invalid date format returns an error — must use YYYY-MM-DD or RFC 3339
- Unknown ticker returns empty results rather than an error
- Section enum typo returns validation error
- Limit exceeding 200 is rejected
- Payment not included or insufficient USDC causes 402 response
- Stale data possible within the hourly rebuild window

## How this service works

Economic releases for the next eight days across 11 major economies (forecast, previous, actual as it prints), US earnings due in the next eight days for companies over $2B (EPS and revenue estimates), and the last three days of reported earnings with the surprise. Filter by date. Rebuilt every hour. $0.01 per call, no account. Free 24h-delayed sample: GET https://ioswarm.io/api/v1/feeds/calendar/sample.

## Output

A structured response with up to three sections: (1) 'economic' — upcoming macro releases over the next 8 days with country, event name, forecast, previous, and actual values as they become available; (2) 'earnings_upcoming' — US companies over $2B reporting in the next 8 days with EPS and revenue estimates; (3) 'earnings_reported' — last 3 days of reported earnings including EPS and revenue surprise. Rebuilt hourly. Filterable by date, ticker, or text query.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "q": {
   "type": "string",
   "maxLength": 80,
   "description": "Text filter."
  },
  "at": {
   "type": "string",
   "description": "Past edition: RFC 3339 or YYYY-MM-DD."
  },
  "date": {
   "type": "string",
   "description": "YYYY-MM-DD (UTC)."
  },
  "limit": {
   "type": "integer",
   "maximum": 200,
   "minimum": 1,
   "description": "Items per section."
  },
  "ticker": {
   "type": "string",
   "description": "Ticker/symbol filter."
  },
  "section": {
   "enum": [
    "economic",
    "earnings_upcoming",
    "earnings_reported"
   ],
   "type": "string",
   "description": "One section (default: all)."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ioswarm-economic-earnings-calendar-a6d5f6d9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ioswarm.io](https://www.zero.xyz/host/ioswarm.io/llms.txt)