# FRED Release Bulk Observations Fetcher

> FRED Release Bulk Observations Fetcher is a paid API for AI agents from agent402.tools, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Bulk-fetches all time-series observations for every series in a given FRED economic release (e.g. CPI, GDP, Jobs Report) in a single paginated API call.

## Facts

- Endpoint: GET https://agent402.tools/api/fred-release-observations
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fred-release-bulk-observations-fetcher-7788fc06
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nYgOfzpAgVbyXyEYfZXUI

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 fred-release-bulk-observations-fetcher-7788fc06
```

Example prompt: Pull all the observations for every series in the FRED CPI release (release ID 10) from January 2020 to December 2024 — I want the full report in one go without having to look up individual series IDs.

## When to prefer this

Use this endpoint when you need all observations across every series within a specific FRED economic release (CPI, GDP, Employment Situation, H.15) without first enumerating individual series IDs. It is ideal for bulk ingestion of entire economic reports in one workflow. Prefer this over single-series FRED endpoints when you need comprehensive release coverage rather than targeted series lookups.

## Known failure modes

- Invalid or unknown releaseId returns an error or empty result
- Date range with no matching data returns empty observations
- Missing required releaseId parameter causes a 400-level error
- Pagination cursors from a different release ID may produce unexpected results
- Large releases may require many pagination calls to retrieve all data
- FRED API upstream downtime or rate limiting may cause failures

## How this service works

Bulk-fetch observations for every series in a FRED release in one call. Use it to grab an entire economic report (jobs report, CPI report, GDP release) without enumerating constituent series IDs first. Returns paginated; pass lastSeriesId + lastObservationDate back to fetch the next page. ?releaseId=18 for H.15 (Selected Interest Rates), 10 for CPI, 50 for Employment Situation, 53 for GDP. Source: FRED API v2 /release/observations endpoint.

## Output

A paginated response containing all time-series observations for every series belonging to the specified FRED release, including series IDs, observation dates, and values. To retrieve the next page, pass the returned lastSeriesId and lastObservationDate as cursor parameters in the next call.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "releaseId"
     ],
     "properties": {
      "endDate": {
       "type": "string",
       "description": "ISO end date (YYYY-MM-DD), optional"
      },
      "releaseId": {
       "type": "number",
       "description": "FRED release ID (e.g. 18 for H.15, 10 for CPI, 50 for jobs, 53 for GDP)"
      },
      "startDate": {
       "type": "string",
       "description": "ISO start date (YYYY-MM-DD), optional"
      },
      "lastSeriesId": {
       "type": "string",
       "description": "Pagination cursor: lastSeriesId from previous response (optional)"
      },
      "lastObservationDate": {
       "type": "string",
       "description": "Pagination cursor: lastObservationDate from previous response (optional)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "releaseId",
      "releaseName",
      "count",
      "series",
      "cursor",
      "source"
     ],
     "properties": {
      "count": {
       "type": "integer"
      },
      "cursor": {
       "type": "object",
       "properties": {
        "hasMore": {
         "type": "boolean"
        }
       }
      },
      "series": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "title": {
          "type": "string"
         },
         "units": {
          "type": "string"
         },
         "seriesId": {
          "type": "string"
         },
         "observations": {
          "type": "array",
          "items": {
           "type": "object"
          }
         }
        }
       }
      },
      "source": {
       "type": "string"
      },
      "releaseId": {
       "type": "integer"
      },
      "releaseName": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 16,
  "cursor": {
   "hasMore": false
  },
  "series": [
   {
    "title": "10-Year Treasury Constant Maturity Rate",
    "units": "Percent",
    "seriesId": "DGS10",
    "observations": [
     {
      "date": "2026-06-17",
      "value": 4.49
     }
    ]
   }
  ],
  "source": "FRED API v2",
  "releaseId": 18,
  "releaseName": "H.15 Selected Interest Rates"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fred-release-bulk-observations-fetcher-7788fc06/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)