Fx Reference
Convert one bounded fiat amount using the latest successfully fetched European Central Bank daily foreign-exchange reference table. Forest returns the ECB observation date and deterministic cross-rates through EUR. Fresh reads use the latest published working-day data; bounded outage fallback is explicitly labeled as cached official data. Reference data only: not an intraday market quote, bid/ask spread, executable transaction price, forecast, or trading recommendation.
Forest exposes this capability as a deterministic machine-readable API for software agents. Discovery is free; execution uses the canonical paid endpoint below. The live x402 challenge is the source of truth for payment terms.
Typical agent tasks
This capability is intended for bounded machine decisions such as:
- convert USD to EUR using the latest ECB reference rate
- get the official daily exchange rate for an invoice
- convert USD to CZK with an ECB observation date
- get the EUR GBP daily reference rate
- normalize fiat amounts using official ECB rates
What Forest guarantees
- fixed official ECB latest daily reference XML only; callers cannot select another provider or URL
- rates are units per EUR and cross-rates are derived deterministically through EUR, including EUR identity legs
- exact ECB observation date is always returned; fresh reads are labeled latest-published-working-day while outage fallback is labeled cached-official-observation
- currency support is limited to EUR plus currencies actually present in the retained ECB table; suspended or missing currencies fail explicitly
- amounts are bounded canonical plain decimals with magnitude at most 1000000000000 and at most 6 fractional digits; converted amounts use deterministic half-up rounding to 6 decimals
- one bounded ECB fetch per process-shared 1800000 ms fresh window with single-flight refresh
- provider failures may reuse the last official snapshot for at most 604800000 ms and apply a 120000 ms retry cooldown to avoid outage hammering
- source attribution is preserved in every machine response
Boundaries
- intraday, streaming, real-time, tradable or executable FX quote
- that cached outage fallback is still the latest ECB publication; its observation date and stale flag are explicit
- bid/ask spread, broker fee, settlement amount, transaction price, hedge recommendation or forecast
- crypto conversion or currencies absent from the latest retained ECB table
- historical/time-series conversion beyond the single retained official observation
- global cross-replica cache coordination; cache, stale fallback and single-flight are process-local
Machine contract
The request and response schemas are published in the canonical OpenAPI document. This page shows a representative input from the same production manifest.