{"uid":"cap_9qVJmFEgrRNKd6vSZCXAi","slug":"agents-openwebninja-com-currency-time-series-8279502f","name":"Currency Time Series","description":"Get forex time series for the following periods: 1 day, 5 days, 1 month, 6 months, year-to-date, 1 year, 5 years and all times (max).","url":"https://agents.openwebninja.com/realtime-finance-data/currency-time-series?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["from_symbol","to_symbol"],"properties":{"period":{"type":"string","description":"Period for which to return time series and key events.  \n\n  **Periods:**  \n  `1D - 1 day`  \n  `5D - 5 days`  \n  `1M - 1 month`  \n  `6M - 6 months`  \n  `YTD - year-to-date`  \n  `1Y - 1 year`  \n  `5Y - 5 years`  \n  `MAX - all times` "},"language":{"type":"string","default":"en","description":"The language to use for the results, specified as a 2-letter language code - see ISO 639-1."},"to_symbol":{"type":"string","description":"A 3-Letter currency code / symbol (ISO 4217) to convert to."},"from_symbol":{"type":"string","description":"A 3-Letter currency code / symbol (ISO 4217) to convert."}}},"responseSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"type":{"type":"string","description":"Type of exchange rate data"},"period":{"type":"string","description":"Time period covered by the time series"},"to_symbol":{"type":"string","description":"Target currency symbol for conversion"},"from_symbol":{"type":"string","description":"Base currency symbol for conversion"},"time_series":{"type":"object","description":"Historical exchange rate data keyed by timestamp. Each value is an exchange-rate snapshot at that timestamp.","additionalProperties":{"type":"object","properties":{"change":{"type":"number","description":"Absolute change from the previous close at this timestamp."},"exchange_rate":{"type":"number","description":"Exchange rate at this timestamp."},"change_percent":{"type":"number","description":"Percent change from the previous close at this timestamp."}}}},"interval_sec":{"type":"integer","description":"Time interval between data points in seconds"},"exchange_rate":{"type":"number","description":"Current exchange rate value"},"previous_close":{"type":"number","description":"Previous closing exchange rate"},"utc_offset_sec":{"type":"integer","description":"UTC offset in seconds for time series data"},"last_update_utc":{"type":"string","description":"Timestamp of last update in UTC format"}}},"status":{"type":"string","description":"Status of the API response"},"request_id":{"type":"string","description":"Unique identifier for the API request"}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","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":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_T7FFUIvX6cceonYZJkWog","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"Returns historical forex exchange rate time series for a currency pair over configurable periods from 1 day to all-time (MAX).","exampleAgentPrompt":"Can you pull the 1-year historical exchange rate time series for EUR to USD so I can see how the euro has trended against the dollar over the past year?","exampleUseCases":[{"title":"Year-to-date currency performance review","prompt":"Show me the year-to-date exchange rate history for USD to JPY — I want to see how the yen has moved against the dollar since January."},{"title":"5-day forex monitoring for travel planning","prompt":"Pull the last 5 days of GBP to USD exchange rates for me — I'm trying to figure out if now is a good time to convert pounds before my trip."},{"title":"Long-term trend analysis for financial reporting","prompt":"Get me the 5-year historical time series for EUR to CHF so I can analyze the long-term trend between the euro and Swiss franc for a quarterly report."}],"resultDescription":"Returns a structured object containing timestamped exchange rate snapshots keyed by timestamp, each with the exchange rate, absolute change, and percent change from previous close; plus the current exchange rate, previous close, update timestamp, UTC offset, interval between data points in seconds, and the period and currency pair metadata.","failureModes":["Invalid ISO 4217 currency code returns an error or empty data","Unsupported period value causes validation error","Unavailable currency pair may return no time series data","Rate limiting or payment/credit exhaustion returns 402","Network timeout for large MAX period datasets"],"whenToPreferThis":"Choose this endpoint when you need historical forex exchange rate data over a defined period (1D to MAX) for any supported ISO 4217 currency pair, especially when you want timestamped snapshots with change metrics. Prefer this over spot-rate-only endpoints when trend analysis, charting, or monitoring over time is needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:24.352Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-currency-time-series-8279502f"}