Convert one bounded fiat amount using the latest successfully fetched European C
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. Base mainnet USDC
Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.
Endpoint
POST https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/fx/reference
| Category | Code and developer |
|---|---|
| Provider host | http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run |
| Networks | eip155:8453 |
| Payment schemes | exact |
| Self-reported calls, 30 days | 0 from 0 payers (the provider's figure, not ours) |
Our checks, last 30 days
| Day | Result | HTTP | Asked | Time |
|---|---|---|---|---|
| 2026-10-21 | valid payment request | 402 | $0.001 | 1218 ms |
Example input (from the provider)
{
"body": {
"amount": "100.00",
"from": "USD",
"to": "CZK"
},
"bodyType": "json",
"method": "POST",
"type": "http"
}
Promised output schema (from the provider)
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"body": {
"additionalProperties": false,
"properties": {
"amount": {
"description": "Public amount value used to scope this lookup.",
"type": [
"number",
"string"
]
},
"from": {
"description": "Public from value used to scope this lookup.",
"pattern": "^[A-Za-z]{3}$",
"type": "string"
},
"to": {
"description": "Public to value used to scope this lookup.",
"pattern": "^[A-Za-z]{3}$",
"type": "string"
}
},
"required": [
"from",
"to",
"amount"
],
"type": "object"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
},
"method": {
"enum": [
"POST"
],
"type": "string"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method",
"bodyType",
"body"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"additionalProperties": false,
"properties": {
"capability": {
"const": "fx.reference",
"description": "Public capability value used to scope this lookup."
},
"data": {
"additionalProperties": false,
"description": "Public data value used to scope this lookup.",
"properties": {
"amount": {
"description": "Public amount value used to scope this lookup.",
"pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$",
"type": "string"
},
"amount_rounding_decimals": {
"const": 6,
"description": "Public amount rounding decimals value used to scope this lookup."
},
"base_source_currency": {
"const": "EUR",
"description": "Public base source currency value used to scope this lookup."
},
"cache_age_ms": {
"description": "Public cache age ms value used to scope this lookup.",
"maximum": 604800000,
"minimum": 0,
"type": "integer"
},
"converted_amount": {
"description": "Public amount value used to scope this lookup.",
"pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$",
"type": "string"
},
"freshness": {
"description": "Public freshness value used to scope this lookup.",
"enum": [
"latest_published_working_day",
"cached_official_observation"
],
"type": "string"
},
"from": {
"description": "Public from value used to scope this lookup.",
"pattern": "^[A-Z]{3}$",
"type": "string"
},
"observation_date": {
"description": "Public observation date value used to scope this lookup.",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"reference_rate": {
"description": "Public amount value used to scope this lookup.",
"pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$",
"type": "string"
},
"source": {
"const": "European Central Bank",
"description": "Public source value used to scope this lookup."
},
"source_kind": {
"const": "daily_reference_rate",
"description": "Public source kind value used to scope this lookup."
},
"source_url": {
"const": "https://www.ecb.europa.eu/stats/eurofxref/eurofxref-daily.xml",
"description": "Public source url value used to scope this lookup."
},
"stale_cache_fallback": {
"description": "Public stale cache fallback value used to scope this lookup.",
"type": "boolean"
},
"to": {
"description": "Public to value used to scope this lookup.",
"pattern": "^[A-Z]{3}$",
"type": "string"
},
"transaction_quote": {
"const": false,
"description": "Public transaction quote value used to scope this lookup."
}
},
"required": [
"from",
"to",
"amount",
"reference_rate",
"converted_amount",
"amount_rounding_decimals",
"observation_date",
"base_source_currency",
"source",
"source_url",
"source_kind",
"freshness",
"stale_cache_fallback",
"transaction_quote",
"cache_age_ms"
],
"type": "object"
},
"meta": {
"additionalProperties": false,
"description": "Public meta value used to scope this lookup.",
"properties": {
"cache": {