{"uid":"cap_Rgb0HfuHCRClK-X0DolXu","slug":"novarithm-fx-timeseries-f174e4bd","name":"Novarithm FX Timeseries","description":"Novarithm installe l'IA dans votre entreprise : elle répond à vos clients, trouve de nouveaux clients et fait le répétitif. Payés sur vos résultats.","url":"https://api.novarithm.com/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":{"type":"json","example":{"data":{"to":"USD","end":"2026-03-31","from":"GBP","count":63,"start":"2026-01-02","stats":{"max":1.38166705,"min":1.32299575,"last":1.32415096,"mean":1.34785121,"first":1.34430554,"change_pct":-1.4993},"method":"ecb_cross_via_eur","points":[{}],"sources":[{}],"price_usd":0.005,"billing_unit":"series (≤ 366 days)","generated_at":"2026-10-23T10:03:31Z","response_time_ms":4},"service":"fx_timeseries"}},"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_JkAG2N7Vc--1_2PbXQ5NF","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 historical foreign exchange rate timeseries data between two currencies over a specified date range, with summary statistics.","exampleAgentPrompt":"Can you pull the daily GBP to USD exchange rate history from January 1 to March 31, 2026, and show me the stats like the average, min, max, and how much it changed over that period?","exampleUseCases":[{"title":"Quarterly FX report for finance team","prompt":"Get me the EUR to USD daily exchange rates for all of Q1 2026 — from January 2 to March 31 — including the average rate, the range, and the overall percentage change."},{"title":"Invoice reconciliation for international payments","prompt":"I need the GBP to EUR exchange rate history for the last 30 days so I can reconcile some international invoices. Can you fetch that timeseries with the min, max, and mean rates?"},{"title":"Currency trend analysis for travel budgeting","prompt":"What did the USD to JPY rate look like from March 1 to April 30, 2026? I want to see the daily points and how much it moved in percentage terms over that window."}],"resultDescription":"A JSON object containing the base and quote currency codes, the date range, a count of data points, an array of daily rate points with their sources, and summary statistics including max, min, mean, first, last rates, and percentage change over the period. Also includes metadata like the method used (ECB cross via EUR), generation timestamp, and response time.","failureModes":["Missing required 'from' or 'to' query parameters returns a validation error","Invalid ISO 4217 currency code returns an error indicating unrecognized currency","Date range exceeding 366 days may result in truncation or billing as multiple units","Network or upstream ECB data unavailability may cause delayed or empty response","Malformed date format (not YYYY-MM-DD) returns a parse error"],"whenToPreferThis":"Choose this endpoint when you need historical daily FX rate data between any two ISO 4217 currencies over a custom date window of up to 366 days, with precomputed statistics (min, max, mean, change %). It uses ECB cross-rates via EUR, making it well-suited for European business contexts, financial reporting, invoice reconciliation, or any agent workflow that needs reliable, low-cost FX history without building rate-fetching infrastructure.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-13T00:39:22.346Z","isFirstParty":false,"canonicalSlug":"novarithm-fx-timeseries-f174e4bd"}