# Lumi Trades Crypto & Macro Events Calendar

> Lumi Trades Crypto & Macro Events Calendar is a paid API for AI agents from api.lumitrades.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-28).

Returns a scheduled calendar of macro events (Fed, CPI, BOJ, etc.) and per-coin crypto catalysts (network upgrades, votes) that could move crypto markets, with UTC and US Central timestamps and sourced explanations.

## Facts

- Endpoint: GET https://api.lumitrades.io/v1/events?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lumi-trades-crypto-macro-events-calendar-ba8dc8ea
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9RziDhI7SI9wKmkKRo0Op

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 lumi-trades-crypto-macro-events-calendar-ba8dc8ea
```

Example prompt: What upcoming macro events and crypto catalysts should I be watching that could move the market — things like Fed rate decisions, CPI releases, or any scheduled coin upgrades?

## When to prefer this

Choose this endpoint when you need a comprehensive, sourced calendar of both macro (Fed, CPI, BOJ) and per-coin (network upgrades, protocol votes) events that could move crypto markets, with explicit timestamps in UTC, explanations of market relevance, and reliable freshness metadata. Prefer it over the 48-hour window sibling endpoint when you need a longer-horizon view rather than just the next two days.

## Known failure modes

- Bad or malformed input returns no charge and an error response
- Stale data state returns no charge and indicates data staleness
- Network or upstream source unavailability may delay or prevent event data retrieval
- If no events are scheduled in the near term, the upcoming arrays may be empty

## How this service works

Calendar of scheduled macro and crypto events: timed releases and policy decisions in UTC and US Central time with a note on relevance, plus dated per-coin catalysts such as network upgrades and conferences. Every row cites a source. Use when an agent needs to know which scheduled events in the coming days could affect crypto markets. For only the next 48 hours, /v1/events/next48h is lower cost. Not charged on stale data.

## Output

Returns a JSON object with: a list of upcoming timed macro events (title, UTC timestamp, URL source, and why it matters), a list of upcoming dated per-coin catalysts (coin, date, title), a 'next' highlight event, and freshness metadata including as_of, data_age_seconds, next_update, stale_after, and a payment receipt with USDC amount, payer address, network, and transaction hash.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "kind": "events",
  "next": {
   "why": "Last national CPI before the BOJ meeting.",
   "title": "Japan September CPI",
   "at_utc": "2026-10-22T23:30:00Z"
  },
  "as_of": "2026-10-22T11:05:00Z",
  "payment": {
   "asset": "USDC",
   "payer": "0x12ab...89cd",
   "amount": "0.005",
   "network": "eip155:8453",
   "transaction": "0x5f0c...e41a"
  },
  "next_update": "2026-10-22T17:05:00Z",
  "stale_after": "2026-10-24T11:05:00Z",
  "upcoming_timed": [
   {
    "url": "https://www.federalreserve.gov/",
    "title": "FOMC rate decision",
    "at_utc": "2026-10-28T18:00:00Z"
   }
  ],
  "data_age_seconds": 600,
  "upcoming_by_date": [
   {
    "coin": "XLM",
    "date": "2026-11-03",
    "title": "Protocol 30 validator vote"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lumi-trades-crypto-macro-events-calendar-ba8dc8ea/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.lumitrades.io](https://www.zero.xyz/host/api.lumitrades.io/llms.txt)