{"uid":"cap_yFKHDuFHr3qBtWNPvQj8t","slug":"fxrate-history-by-youraitools-d08eb003","name":"FXRate History by YourAITools","description":"Historical exchange rate API for AI agents. Daily ECB reference rates for one currency pair between two dates (up to 366 days, back to 1999), with first, last, min, max and percent change. Search intents: historical exchange rates api, fx time series, currency history, eur usd chart data, forex history.","url":"https://api.youraitools.co/fx/v1/history?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","quote","start"],"properties":{"end":{"type":"string","description":"YYYY-MM-DD end date (default: today); max 366 days after start"},"base":{"type":"string","description":"Base currency: ISO 4217 code, e.g. USD, EUR, GBP, JPY (31 supported)"},"quote":{"type":"string","description":"Quote currency: ISO 4217 code, e.g. USD, EUR, GBP, JPY (31 supported)"},"start":{"type":"string","description":"YYYY-MM-DD start date"}},"description":"Search intents: historical exchange rates api, fx time series, currency history, eur usd history, forex history"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["base","quote","points"],"properties":{"end":{"type":"string"},"base":{"type":"string"},"quote":{"type":"string"},"start":{"type":"string"},"stats":{"type":"object","properties":{"max":{"type":"number"},"min":{"type":"number"},"last":{"type":"number"},"first":{"type":"number"},"change_pct":{"type":"number"}}},"points":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"rate":{"type":"number"}}}},"source":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"end":"2026-10-23","base":"EUR","count":17,"quote":"USD","start":"2026-10-01","stats":{"max":1.1298,"min":1.1172,"last":1.1193,"first":1.1298,"change_pct":-0.93},"points":[{"date":"2026-10-01","rate":1.1298},{"date":"2026-10-02","rate":1.1225},{"date":"2026-10-23","rate":1.1193}],"source":"Source: ECB statistics (euro foreign exchange reference rates), via the open-source Frankfurter API."}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VtDTJOCrSZSkzRYTVJlWQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns daily ECB reference rates for a currency pair over a date range (up to 366 days, back to 1999), including time-series data points and summary statistics.","exampleAgentPrompt":"Can you pull the daily EUR/USD exchange rates from January 1 to March 31 2024 using ECB reference data, and tell me the first rate, last rate, min, max, and total percent change over that period?","exampleUseCases":[{"title":"Quarterly FX performance report","prompt":"Get me the daily GBP to USD exchange rates for all of Q3 2024 — from July 1 to September 30 — and give me the high, low, opening and closing rates plus how much it moved in percent."},{"title":"Year-over-year currency comparison","prompt":"What were the daily JPY to EUR rates throughout 2023? I need the full time series from January 1 2023 to December 31 2023, along with the min, max, and overall percent change."},{"title":"Recent currency volatility check","prompt":"Show me the USD to CHF exchange rate history for the past 30 days — roughly from June 1 to July 1 2025 — and tell me how much the rate swung between the high and the low."}],"resultDescription":"A JSON object containing the base and quote currency codes, the requested date range, an array of daily {date, rate} data points (business days only per ECB), and a stats block with first, last, min, max, and change_pct (percent change from first to last). Also includes the data source attribution (ECB via Frankfurter).","failureModes":["Missing required parameters (base, quote, start) returns a 4xx error","Date range exceeding 366 days returns an error","Unsupported currency codes (outside the 31 ECB-supported currencies) return an error","Start date before 1999 (ECB data inception) may return empty or error","Weekend/holiday dates return no data points for those days (ECB only publishes on business days)","Network or upstream Frankfurter API outage may cause 5xx responses"],"whenToPreferThis":"Choose this endpoint when you need historical ECB daily reference rates for a specific currency pair over a defined date window, especially when you also need summary statistics (first, last, min, max, percent change) computed server-side. It is ideal for trend analysis, reporting, or charting up to a year of FX history. Prefer alternatives if you need real-time live rates, intraday tick data, rates for currencies outside the 31 ECB-supported ones, or multi-pair batch queries in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-25T12:31:17.752Z","isFirstParty":false,"canonicalSlug":"fxrate-history-by-youraitools-d08eb003"}