# ETF & Macro Calendar

> ETF & Macro Calendar is a paid API for AI agents from x402-sand.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-18).

Returns a date-range-filtered calendar of US macroeconomic events relevant to crypto ETF flows and institutional fund activity

## Facts

- Endpoint: GET https://x402-sand.vercel.app/api/macro/calendar?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/etf-macro-calendar-134bfa17
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_t9-lfVXTqmQnuYqj-GwXn

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 etf-macro-calendar-134bfa17
```

Example prompt: Pull the US macro economic calendar for January 2026 — I want to see all the scheduled events between January 1 and January 31 that could affect crypto ETF flows.

## When to prefer this

Use this endpoint when you need a structured calendar view of upcoming US macroeconomic events filtered by date range, especially when the use case involves crypto ETF flows or institutional fund timing. Prefer this over general financial news APIs when you need event scheduling data (not narrative news) and when you want events scoped to crypto-relevant macro catalysts.

## Known failure modes

- Missing required 'from' date parameter returns an error or empty result
- Invalid date format (non-ISO 8601) may cause a parse error or empty data array
- Date range with no events returns {success: true, data: []} — not an error but may mislead if misinterpreted
- Very wide date ranges may return large payloads or be throttled
- Payment failure (402) if USDC payment is not correctly submitted before the request

## How this service works

Crypto ETF flows, institutional fund data, and US macroeconomic events.

## Output

A JSON object containing a success flag, the endpoint path, and a data array of macroeconomic calendar events filtered to the specified date range. Each event may include event name, date, and relevance to crypto ETF or institutional fund activity.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input",
  "output"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "from"
     ],
     "properties": {
      "to": {
       "type": "string",
       "description": "Example value: 2026-01-31"
      },
      "from": {
       "type": "string",
       "description": "Example value: 2026-01-01"
      }
     },
     "additionalProperties": {
      "type": "string"
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "json"
    },
    "example": {}
   },
   "additionalProperties": false
  }
 },
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [],
  "success": true,
  "endpoint": "/api/macro/calendar"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/etf-macro-calendar-134bfa17/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-sand.vercel.app](https://www.zero.xyz/host/x402-sand.vercel.app/llms.txt)