{"uid":"cap_My1xpzkzrC3L7v4_9q7ok","slug":"fx-reference-rates-timeseries-api-723fed53","name":"FX Reference Rates Timeseries API","description":"Daily reference rate series for base/symbol between start and end (max 366 days), with min/max/mean and change.","url":"https://fx-reference-rates.regnotes.workers.dev/v1/rates/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":["base","symbol","start","end"],"properties":{"end":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"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"},"start":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"symbol":{"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":"object"}}}}},"responseSchema":{"type":"json","example":{"end":"2026-09-30","base":"USD","start":"2026-09-01","stats":{"max":160.1639,"min":153.2698,"mean":156.388,"change_pct":-1.9773},"points":22,"series":[{"date":"2026-09-01","rate":160.1639}],"symbol":"JPY"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Zs3ls3bkP5LAWb5Flsxkc","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a daily exchange rate time series for a currency pair over a date range (up to 366 days), including per-day rates plus summary stats (min, max, mean, change%).","exampleAgentPrompt":"Can you pull the daily USD to JPY exchange rates from September 1 to September 30, 2026, and tell me the min, max, and average rate over that period?","exampleUseCases":[{"title":"Quarterly FX exposure report","prompt":"Pull the daily EUR to USD exchange rates for the entire third quarter of 2025 — July 1 through September 30 — and give me the min, max, mean, and how much it changed over that period."},{"title":"Travel budget planning check","prompt":"What were the GBP to EUR daily rates between January 1 and January 31, 2026? I want to see the trend and the average rate for that month."},{"title":"Currency volatility analysis","prompt":"Get me the daily BRL to USD rates from March 1 to June 30, 2025 — I need the full time series plus the percentage change over those four months to assess volatility."}],"resultDescription":"A JSON object containing the base and symbol currency codes, start and end dates, the total number of data points, an array of daily {date, rate} objects for each trading/publication day in the range, and a stats object with min, max, mean, and change_pct values across the period.","failureModes":["Date range exceeds 366 days — returns an error; split into multiple requests","Invalid currency code (not in the supported 30-currency list) — returns validation error","Start date after end date — invalid range error","Non-trading days (weekends, ECB non-publication days) are skipped or fall back to prior publication day","Future dates beyond available data return partial or empty series","Missing required query parameters (base, symbol, start, end) return 400-level errors"],"whenToPreferThis":"Choose this endpoint when you need a time series of daily historical FX rates over a defined multi-day or multi-month window, along with aggregate statistics (min/max/mean/change). Prefer it over a single-date lookup when you need trend analysis, charting data, or period-level summaries. It covers 30 major currencies using authoritative ECB reference rates, making it suitable for financial reporting, compliance, and analytics. It is not suitable for real-time intraday rates or currencies outside the ECB's published set.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:05:15.946Z","isFirstParty":false,"canonicalSlug":"fx-reference-rates-timeseries-api-723fed53"}