{"uid":"cap_AUPPpu-foqBpx8GSsBOb8","slug":"vibesprings-net-48972932","name":"Vibesprings Forex Historical Time-Series","description":"Historical foreign exchange (Forex) time-series database. Retrieve daily historical rates for any currency pair over a custom date range up to 365 days. Automatically computes complete summary statistics including minimum rate, maximum rate, time-weighted average rate, opening/closing rates, and total percentage change.","url":"https://vibesprings.net/api/exchange/history","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":["start","end"],"properties":{"to":{"type":"string","description":"Target currency ISO code (e.g. EUR, GBP)"},"end":{"type":"string","description":"End date for time-series query in YYYY-MM-DD format (maximum range: 365 days)"},"base":{"type":"string","description":"Base currency ISO code (e.g. USD, EUR)"},"start":{"type":"string","description":"Start date for time-series query in YYYY-MM-DD format"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"base":"USD","period":{"end":"2024-12-31","start":"2024-01-01","tradingDays":252},"target":"EUR","summary":{"avg":0.9215,"max":0.9432,"min":0.8975,"changePercent":-1.23},"timeSeries":[{"date":"2024-01-02","rate":0.9185}]}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"to":"EUR","end":"2024-03-31","base":"USD","start":"2024-01-01"}}},"response":{"base":"USD","period":{"end":"2024-03-31","start":"2024-01-01","tradingDays":64},"source":"European Central Bank via Frankfurter","target":"EUR","summary":{"avg":0.920771,"max":0.93345,"min":0.90498,"open":0.90498,"close":0.92498,"changePercent":2.21},"timeSeries":[{"date":"2023-12-29","rate":0.90498},{"date":"2024-01-02","rate":0.91274},{"date":"2024-01-03","rate":0.91583},{"date":"2024-01-04","rate":0.91299},{"date":"2024-01-05","rate":0.91567},{"date":"2024-01-08","rate":0.91358},{"date":"2024-01-09","rate":0.91408},{"date":"2024-01-10","rate":0.91358},{"date":"2024-01-11","rate":0.91017},{"date":"2024-01-12","rate":0.91391},{"date":"2024-01-15","rate":0.91366},{"date":"2024-01-16","rate":0.91895},{"date":"2024-01-17","rate":0.91937},{"date":"2024-01-18","rate":0.91954},{"date":"2024-01-19","rate":0.91853},{"date":"2024-01-22","rate":0.91827},{"date":"2024-01-23","rate":0.91979},{"date":"2024-01-24","rate":0.91701},{"date":"2024-01-25","rate":0.91802},{"date":"2024-01-26","rate":0.91988},{"date":"2024-01-29","rate":0.92396},{"date":"2024-01-30","rate":0.922},{"date":"2024-01-31","rate":0.92276},{"date":"2024-02-01","rate":0.92473},{"date":"2024-02-02","rate":0.91886},{"date":"2024-02-05","rate":0.93058},{"date":"2024-02-06","rate":0.93084},{"date":"2024-02-07","rate":0.92799},{"date":"2024-02-08","rate":0.92954},{"date":"2024-02-09","rate":0.92833},{"date":"2024-02-12","rate":0.92825},{"date":"2024-02-13","rate":0.92653},{"date":"2024-02-14","rate":0.93345},{"date":"2024-02-15","rate":0.93084},{"date":"2024-02-16","rate":0.92868},{"date":"2024-02-19","rate":0.92799},{"date":"2024-02-20","rate":0.92575},{"date":"2024-02-21","rate":0.92515},{"date":"2024-02-22","rate":0.92217},{"date":"2024-02-23","rate":0.92302},{"date":"2024-02-26","rate":0.92149},{"date":"2024-02-27","rate":0.92115},{"date":"2024-02-28","rate":0.92524},{"date":"2024-02-29","rate":0.9237},{"date":"2024-03-01","rate":0.92481},{"date":"2024-03-04","rate":0.922},{"date":"2024-03-05","rate":0.92174},{"date":"2024-03-06","rate":0.91962},{"date":"2024-03-07","rate":0.91785},{"date":"2024-03-08","rate":0.91475},{"date":"2024-03-11","rate":0.91525},{"date":"2024-03-12","rate":0.91609},{"date":"2024-03-13","rate":0.91416},{"date":"2024-03-14","rate":0.91533},{"date":"2024-03-15","rate":0.91811},{"date":"2024-03-18","rate":0.91811},{"date":"2024-03-19","rate":0.92132},{"date":"2024-03-20","rate":0.92217},{"date":"2024-03-21","rate":0.91684},{"date":"2024-03-22","rate":0.92396},{"date":"2024-03-25","rate":0.92293},{"date":"2024-03-26","rate":0.92123},{"date":"2024-03-27","rate":0.92456},{"date":"2024-03-28","rate":0.92498}],"processingTime":"312ms"}},"exampleRequest":{"to":"EUR","end":"2024-03-31","base":"USD","start":"2024-01-01"},"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_3I3lFoH_Ta9nIAzh_Nq6P","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":"Retrieves daily historical exchange rates for a currency pair over a custom date range and returns summary statistics including min, max, average, open/close, and percent change.","exampleAgentPrompt":"Can you pull the daily USD to EUR exchange rates from January 1, 2024 to March 31, 2024, including the average, min, max, and total percent change over that period?","exampleUseCases":[{"title":"Analyze quarterly currency volatility","prompt":"I need to understand how volatile the pound-to-dollar exchange rate was during Q4 2023. Can you pull the daily rates for that quarter and tell me the min, max, and average, plus what percent it changed overall?"},{"title":"Track international payroll cost trends","prompt":"Our company pays contractors in GBP and CAD. Can you get me the daily exchange rates for both pairs against USD over the last six months so I can see how our payroll expenses have fluctuated?"},{"title":"Evaluate historical deal pricing accuracy","prompt":"We closed a deal in June 2024 where we locked in EUR to JPY rates. Pull the daily historical rates for that month and show me the min, max, average, and percent change so I can assess whether we got a fair price at closing."}],"resultDescription":"Returns an object with the base and target currency, the date range and number of trading days, a summary object with avg/min/max/open/close rates and percent change, and a full time-series array of date-rate pairs for every trading day in the range.","failureModes":["Date range exceeds 365 days — API returns an error; split into smaller ranges","Invalid ISO currency code — API returns an error about unsupported currency","Start date after end date — API returns a validation error","Unsupported currency pair not covered by ECB data — returns empty or error","Missing required start or end query parameter — returns 400-level error"],"whenToPreferThis":"Use this endpoint when you need historical daily forex rates with pre-computed statistics (min, max, average, open/close, percent change) for a specific currency pair over a custom date range up to 365 days. Prefer it over a live-rate endpoint when historical trend analysis or summary statistics are the goal rather than a current spot price.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:45:57.015Z","isFirstParty":false}