{"uid":"cap_lwibfaC9PaCUM7ZHAq8vk","slug":"fx-reference-rates-api-full-dataset-csv-bulk-download-2b3a1d8c","name":"FX Reference Rates API – Full Dataset CSV Bulk Download","description":"Bulk download: every publication day in coverage as CSV (date + one column per currency) in the requested base (default EUR). One payment, whole dataset.","url":"https://fx-reference-rates.regnotes.workers.dev/v1/dataset/csv?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"type":"json","example":"date,AUD,BRL,...\n2026-10-23,1.7891,6.2204,..."},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4H9zLtaee7RIzsTOp2JqO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Historical FX analysis for backtesting","prompt":"I need the complete ECB FX reference rate history as a CSV with USD as the base — every single publication day, all 30 currencies, so I can backtest a currency strategy."},{"title":"Seeding a local currency database","prompt":"Pull down the entire ECB foreign exchange dataset as a CSV in EUR base so I can load all historical rates into our internal database in one shot."},{"title":"Spreadsheet model with full FX history","prompt":"Get me a bulk CSV download of all ECB FX reference rates ever published, using GBP as the base currency, so I can drop it into a spreadsheet model."}],"resultDescription":"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.","failureModes":["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)"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:04:57.044Z","isFirstParty":false,"canonicalSlug":"fx-reference-rates-api-full-dataset-csv-bulk-download-2b3a1d8c"}