# Futures Expiry Roll Calendar API

> Futures Expiry Roll Calendar API is a paid API for AI agents from futures-expiry-api.onrender.com, paid per call via x402, $0.02/call, status down (last checked 2026-10-31).

Returns all four quarterly expiration and roll dates for a specified CME or Eurex index futures product for a given calendar year, with holiday adjustments.

## Facts

- Endpoint: GET https://futures-expiry-api.onrender.com/v1/roll-calendar?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: down
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/futures-expiry-roll-calendar-api-36d21202
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YiEIhfdwhaZeNQaR0gdyw

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 futures-expiry-roll-calendar-api-36d21202
```

Example prompt: Can you pull the full quarterly expiration and roll calendar for ES futures for 2026, including any holiday adjustments?

## When to prefer this

Use this endpoint when you need a full annual roll calendar — all four quarterly expirations and roll dates — for a specific CME or Eurex index futures product. It is preferable to sibling endpoints when you need to plan ahead for an entire year rather than just the next contract or current front month. It is ideal for strategy backtesting setup, risk management scheduling, or building trading calendars.

## Known failure modes

- Unsupported product code returns an error or empty response
- Invalid or out-of-range year causes a 400 or validation error
- Holiday data not available for far-future years may reduce adjustment accuracy
- Missing required query parameters (product or year) return a 422 or 400 error
- Service may be temporarily unavailable on the free-tier render host (cold start delay)

## How this service works

Returns all four quarterly expirations and roll dates of a CME or Eurex index future for one calendar year, with holiday adjustments.

## Output

An array or structured object containing the four quarterly expiration dates, corresponding roll dates, and any holiday-adjusted settlement dates for the specified futures product and calendar year.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "product",
      "year"
     ],
     "properties": {
      "year": {
       "type": "string",
       "description": "Calendar year, e.g. 2027"
      },
      "product": {
       "type": "string",
       "description": "Futures product: ES, MES, NQ, MNQ, YM, MYM, RTY, M2K, FDAX, FDXM, FESX, FSMI"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/futures-expiry-roll-calendar-api-36d21202/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from futures-expiry-api.onrender.com](https://www.zero.xyz/host/futures-expiry-api.onrender.com/llms.txt)
