# FX Reference Rates API – Full Dataset CSV Bulk Download

> FX Reference Rates API – Full Dataset CSV Bulk Download is a paid API for AI agents from fx-reference-rates.regnotes.workers.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-30).

Downloads the complete historical ECB foreign exchange reference rate dataset as a CSV file, with one row per publication day and one column per currency, in any supported base currency.

## Facts

- Endpoint: GET https://fx-reference-rates.regnotes.workers.dev/v1/dataset/csv?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fx-reference-rates-api-full-dataset-csv-bulk-download-2b3a1d8c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lwibfaC9PaCUM7ZHAq8vk

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 fx-reference-rates-api-full-dataset-csv-bulk-download-2b3a1d8c
```

Example prompt: Download the full historical ECB FX reference rate dataset as a CSV with USD as the base currency — I want every publication day from the entire coverage period in one file.

## When to prefer this

Choose this endpoint when you need the entire historical FX dataset in a single call rather than querying day by day or range by range. It is ideal for seeding databases, running backtests, building spreadsheet models, or any offline analysis that requires the full time series. Prefer the single-date or range endpoints if you only need a narrow slice of data.

## Known failure modes

- Invalid base currency code (not matching ^[A-Z]{3}$ pattern or not in the supported 30-currency list) returns an error
- Payment failure or missing x402 payment header results in 402 Payment Required
- Network timeout if the dataset file is very large
- Non-publication days are not included as rows (only ECB publication days appear)

## How this service works

Bulk download: every publication day in coverage as CSV (date + one column per currency) in the requested base (default EUR). One payment, whole dataset.

## Output

A CSV file where the first column is 'date' (YYYY-MM-DD) and each subsequent column is a 3-letter currency code (e.g. AUD, USD, JPY). Each row represents one ECB publication day. Rates are expressed relative to the requested base currency (default EUR). The file covers every available publication day in the dataset's full historical range.

## 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",
     "properties": {
      "base": {
       "type": "string",
       "pattern": "^[A-Z]{3}$",
       "description": "One of: AUD, BRL, CAD, CHF, CNY, CZK, DKK, EUR, GBP, HKD, HUF, IDR, ILS, INR, ISK, JPY, KRW, MXN, MYR, NOK, NZD, PHP, PLN, RON, SEK, SGD, THB, TRY, USD, ZAR"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "string"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": "date,AUD,BRL,...\n2026-10-23,1.7891,6.2204,..."
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fx-reference-rates-api-full-dataset-csv-bulk-download-2b3a1d8c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fx-reference-rates.regnotes.workers.dev](https://www.zero.xyz/host/fx-reference-rates.regnotes.workers.dev/llms.txt)