# Fathom Macroeconomic Data API — Release Dates

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

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

## Facts

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

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-06829a7a -d '<json body>'
```

Example prompt: Can you pull up the release dates for FRED release ID 53 — show me the last 20 dates when that economic data was published?

## When to prefer this

Use this endpoint when you need to know the historical or scheduled publication dates for a specific FRED economic data release — for example, to time data ingestion pipelines, align model updates with data availability, or audit when a particular macroeconomic series was last updated. Prefer this over general FRED browsing when you already know the release ID and need its date history.

## Known failure modes

- Missing or invalid releaseId returns an error or empty result
- Non-existent FRED release ID returns no data or an error
- Exceeding rate limits or payment failures result in rejection
- Limit parameter ignored or defaulted if malformed

## How this service works

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

## Output

Returns an array of release date objects for the specified FRED release, along with the release ID and source attribution. Each date entry indicates when that economic data release was published or is scheduled to 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-06829a7a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fathoms.vercel.app](https://www.zero.xyz/host/fathoms.vercel.app/llms.txt)