{"uid":"cap_nRHqEd6KMmO1ZcDwmKvjY","slug":"1gateway-fx-rates-ecb-reference-a8f34bda","name":"1gateway FX Rates (ECB Reference)","description":"Use when you need an official daily FX rate or currency conversion (USD, EUR, KRW, JPY, CNY, GBP + 24 more). Input: base (default EUR), optional symbols (comma list), date (YYYY-MM-DD, last ~90 days; weekends use the prior fixing), amount. Output: JSON rates for the fixing date, % change vs prior fixing, converted amounts, raw ECB EUR rates. Source: ECB statistics, updated each TARGET day ~16:00 CET; reference only. Example: ?base=USD&symbols=KRW,JPY&amount=100","url":"https://1gateway.dev/v1/fx/rates?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":[],"properties":{"base":{"enum":["EUR","USD","JPY","KRW","CNY","GBP","AUD","BRL","CAD","CHF","CZK","DKK","HKD","HUF","IDR","ILS","INR","ISK","MXN","MYR","NOK","NZD","PHP","PLN","RON","SEK","SGD","THB","TRY","ZAR"],"type":"string","default":"EUR","examples":["USD"],"description":"Base currency, ISO 4217 (one of the 30 ECB reference currencies; default EUR)"},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","examples":["2026-10-09"],"description":"Fixing date YYYY-MM-DD within the last ~90 days (default latest)"},"amount":{"type":"number","minimum":0,"examples":[100],"description":"Amount in base currency to convert"},"symbols":{"type":"string","pattern":"^[A-Za-z]{3}(,[A-Za-z]{3})*$","examples":["KRW,JPY,EUR"],"description":"Comma-separated target currencies (default: all). Supported: EUR,USD,JPY,KRW,CNY,GBP,AUD,BRL,CAD,CHF,CZK,DKK,HKD,HUF,IDR,ILS,INR,ISK,MXN,MYR,NOK,NZD,PHP,PLN,RON,SEK,SGD,THB,TRY,ZAR"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["base","date","requestedDate","previousDate","rates","changePctVsPrevious","derived","ecbEurRates","names","notes","attribution"],"properties":{"base":{"type":"string"},"date":{"type":"string"},"names":{"type":"object","properties":{"EUR":{"type":"string"},"JPY":{"type":"string"},"KRW":{"type":"string"},"USD":{"type":"string"}}},"notes":{"type":"array","items":{"type":"string"}},"rates":{"type":"object","additionalProperties":{"type":"number"}},"amount":{"type":"integer"},"derived":{"type":"boolean"},"converted":{"type":"object","additionalProperties":{"type":"number"}},"attribution":{"type":"string"},"ecbEurRates":{"type":"object","additionalProperties":{"type":"number"}},"previousDate":{"type":"string"},"requestedDate":{"type":["string","null"]},"changePctVsPrevious":{"type":"object","additionalProperties":{"type":"number"}}}}}}}},"responseSchema":null,"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_4XecUpAnw6v9We5ScQEKk","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 official ECB daily FX fixing rates for up to 30 currencies, with percentage change vs prior fixing and optional currency conversion for a specified amount.","exampleAgentPrompt":"Can you get me the official ECB fixing rate for USD against KRW and JPY for today, and show me how much 100 USD converts to in each currency?","exampleUseCases":[{"title":"Invoice currency conversion for finance team","prompt":"I need to convert 25000 EUR to USD and GBP using today's official ECB rate — can you pull those rates and show me the converted amounts so I can fill out the invoice?"},{"title":"FX rate change tracking for macro research","prompt":"What was the ECB official fixing rate for CNY and KRW against EUR on 2025-04-10, and how much did each change compared to the prior fixing day?"},{"title":"Historical rate lookup for audit compliance","prompt":"I need the official ECB reference rate for USD, GBP, and JPY on 2025-01-15 — this is for a financial audit and must be an official source, not a market rate."}],"resultDescription":"JSON object containing the actual fixing date used, requested currencies and their rates relative to the base, percentage change versus the prior TARGET day fixing, converted amounts if an amount was provided, raw ECB EUR reference rates, full currency names, and attribution notes indicating the ECB as the source.","failureModes":["Date out of range (beyond ~90 days history) returns an error","Weekend or holiday dates are silently shifted to the prior TARGET day fixing","Unsupported currency code in symbols or base returns an error","Future dates are not supported","Service unavailable before ~16:00 CET on a TARGET day (rates not yet published)"],"whenToPreferThis":"Use this endpoint when you need official, authoritative ECB reference rates — e.g. for financial reporting, audit trails, invoicing, or compliance where a market-rate provider would not be acceptable. It covers 30 major currencies with guaranteed daily ECB fixings and includes percent-change metadata and conversion in a single call, making it more convenient than querying the ECB directly. Not suitable for real-time intraday rates or currencies outside the ECB's 30-currency basket.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:36:49.661Z","isFirstParty":false,"canonicalSlug":"1gateway-fx-rates-ecb-reference-a8f34bda"}