{"uid":"cap_TT3Qsbel9AjF8xJf_naFo","slug":"celerapi-fx-historical-rate-lookup-20eb160a","name":"CelerAPI FX Historical Rate Lookup","description":"Resolve companies, legal entities and financial reference data using authoritative sources. Machine-native, pay per request, no subscription.","url":"https://www.celerapi.com/v1/fx/rate/%7Bdate%7D","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"},"pathParams":{"type":"object","required":["date"],"properties":{"date":{"type":"string","example":"2025-01-15","pattern":"^\\d{4}-\\d{2}-\\d{2}$","examples":["2025-01-15"]}}},"queryParams":{"type":"object","required":["base_currency","quote_currency"],"properties":{"base_currency":{"type":"string","example":"EUR","pattern":"^[A-Z]{3}$","examples":["EUR"]},"quote_currency":{"type":"string","example":"USD","pattern":"^[A-Z]{3}$","examples":["USD"]}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["success","complete","data","warnings","provenance"],"properties":{"data":{"type":"object","required":["date","base_currency","quote_currency","rate","provider_code"],"properties":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"rate":{"type":"number","exclusiveMinimum":0},"base_currency":{"type":"string","pattern":"^[A-Z]{3}$"},"provider_code":{"type":"string"},"quote_currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"additionalProperties":false},"success":{"const":true},"complete":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"provenance":{"type":"object","required":["source","provider","source_url","retrieved_at","freshness","license"],"properties":{"source":{"type":"string"},"license":{"type":"string"},"provider":{"type":"string"},"freshness":{"enum":["live","reference"]},"source_url":{"type":"string"},"attribution":{"type":"string"},"retrieved_at":{"type":"string"}}}}}}}}},"responseSchema":{"type":"json","example":{"data":{},"success":true,"complete":true,"warnings":[],"provenance":{"source":"European Central Bank reference rates via Frankfurter","license":"Frankfurter MIT; underlying ECB terms apply","provider":"frankfurter","freshness":"reference","source_url":"https://api.frankfurter.dev"}}},"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_eSvpvLZG_kuyVmB5xl3sp","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 the foreign exchange rate between two currencies for a specific historical date, sourced from the European Central Bank via Frankfurter.","exampleAgentPrompt":"What was the EUR to USD exchange rate on January 15, 2025? Look it up using a structured historical FX rate source.","exampleUseCases":[{"title":"Invoice reconciliation for past transactions","prompt":"I need to know the official EUR to GBP exchange rate on March 10, 2025 — I'm reconciling some invoices from that date and need the ECB reference rate."},{"title":"Historical portfolio valuation","prompt":"What was the USD to JPY exchange rate on December 31, 2024? I need it to calculate the year-end value of a yen-denominated asset in dollar terms."},{"title":"Expense report currency conversion","prompt":"Can you find the CHF to USD rate for February 5, 2025? I have some Swiss franc expenses from a business trip that I need to convert for my expense report."}],"resultDescription":"A JSON object containing the exact exchange rate (as a positive number) between the requested base and quote currencies on the specified date, along with the date, currency codes, provider code, and full provenance metadata including source, license, provider name, source URL, freshness indicator, and retrieval timestamp.","failureModes":["Date not available — ECB does not publish rates for weekends or public holidays; response may be incomplete or return nearest available date","Invalid currency code — non-ISO 4217 three-letter uppercase codes will fail validation","Future dates — rates are not available for dates beyond today","Unsupported currency pair — not all currency pairs are covered by ECB reference rates","Network or upstream provider error from Frankfurter API"],"whenToPreferThis":"Choose this endpoint when you need a reliable, sourced historical FX rate for a specific past date between two currencies, especially for financial reporting, accounting reconciliation, or audit-trail purposes. It is ideal when you need provenance metadata (source, license, freshness) alongside the rate. Prefer this over generic FX APIs when you need ECB reference rates specifically, or when a micropayment-per-request model (no subscription or API key) fits your architecture.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:33:43.162Z","isFirstParty":false}