{"uid":"cap_fQZwsBgqRSGrq2n7heF8f","slug":"ecb-fx-time-series-285fa6a3","name":"ECB FX Time Series","description":"Daily official ECB exchange rates for a currency pair over up to 366 days, with min, max, mean and % change. Useful for invoicing, hedging checks and reporting.","url":"https://gogeta2-u35175.vm.elestio.app/agents/v1/fx/timeseries?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","required":["from","to"],"properties":{"to":{"type":"string","description":"ISO 4217 quote currency"},"end":{"type":"string","description":"YYYY-MM-DD (default: today)"},"from":{"type":"string","description":"ISO 4217 base currency"},"start":{"type":"string","description":"YYYY-MM-DD (default: end - 30 days)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Yfr7Z2e8SmiE7MoS3p8OL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns daily official ECB exchange rates for a currency pair over up to 366 days, including min, max, mean, and percentage change statistics.","exampleAgentPrompt":"Can you pull the official ECB daily exchange rates for EUR to USD from January 1 to March 31 this year and give me the min, max, mean, and overall percentage change?","exampleUseCases":[{"title":"Monthly invoice FX reconciliation","prompt":"I need to reconcile our EUR to GBP invoices for last month — can you get the official ECB daily rates from March 1 to March 31 and give me the average rate and the range it moved in?"},{"title":"Quarterly hedging exposure check","prompt":"We're reviewing our USD/JPY hedging positions for Q1 — pull the ECB official exchange rate time series from January 1 to March 31 and tell me the min, max, mean and how much the rate changed over that period."},{"title":"Annual FX reporting for compliance","prompt":"I need to prepare an FX report for our auditors — can you get the ECB official daily rates for EUR to CHF for the full year 2024 (January 1 to December 31) including the percentage change and statistical summary?"}],"resultDescription":"A time series of official ECB daily exchange rates for the requested currency pair and date range, along with computed statistics: minimum rate, maximum rate, mean rate, and percentage change from start to end of the period.","failureModes":["Unsupported currency pair not covered by ECB (e.g. exotic currencies not published by ECB)","Date range exceeds 366 days","Invalid ISO 4217 currency codes","Future dates requested (ECB rates only available historically)","Weekend/holiday gaps where ECB does not publish rates","Network or upstream ECB data unavailability"],"whenToPreferThis":"Choose this endpoint when you need official ECB-published exchange rates specifically — for compliance, auditing, invoicing, or hedging checks that require a recognized central bank source. It is ideal when you need aggregated statistics (min/max/mean/% change) over a date range rather than a single spot rate. Prefer this over generic FX APIs when regulatory or accounting contexts require ECB-authoritative data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:36:51.547Z","isFirstParty":false,"canonicalSlug":"ecb-fx-time-series-285fa6a3"}