# Fathom Macroeconomic Data API — Release Dates

> Fathom Macroeconomic Data API — Release Dates is a paid API for AI agents from fathom-opal.vercel.app, paid per call via x402, $0.06/call, status unknown (last checked 2026-09-13).

Returns the scheduled or historical release dates for a specific FRED economic data release, identified by release ID.

## Facts

- Endpoint: POST https://fathom-opal.vercel.app/api/release-dates
- Price: $0.06/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fathom-macroeconomic-data-api-release-dates-2348182a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rbDbhCwgKJbkDWbn34nRw

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 fathom-macroeconomic-data-api-release-dates-2348182a -d '<json body>'
```

Example prompt: Can you pull up the release dates for FRED release ID 21 — show me the last 5 scheduled publication dates for that economic data series?

## When to prefer this

Use this endpoint when you need to know the publication schedule or history for a specific FRED economic data release — for example, to track when GDP, CPI, unemployment, or interest rate reports are issued. Prefer this over general economic data endpoints when the question is specifically about *when* data is released rather than *what* the data values are.

## Known failure modes

- Invalid or nonexistent releaseId returns an error or empty dates array
- Missing required releaseId field results in a validation error
- Limit parameter out of range may return default or error
- Upstream FRED API unavailability causes failure or stale data
- Payment failure (x402 protocol) prevents request from completing

## How this service works

Free macroeconomic data API powered by FRED. 816,000+ economic time series. GDP, inflation, unemployment, interest rates, and more.

## Output

An array of release date objects for the specified FRED release, along with the release ID and source attribution string. Each item in the dates array contains date metadata indicating when that release was or will be published.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "releaseId"
 ],
 "properties": {
  "limit": {
   "type": "string",
   "description": "Max results (default: 10)"
  },
  "releaseId": {
   "type": "string",
   "description": "FRED release ID"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "source"
 ],
 "properties": {
  "dates": {
   "type": "array",
   "items": {
    "type": "object"
   }
  },
  "source": {
   "type": "string"
  },
  "release_id": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fathom-macroeconomic-data-api-release-dates-2348182a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fathom-opal.vercel.app](https://www.zero.xyz/host/fathom-opal.vercel.app/llms.txt)