# Forest FX Reference Rate Converter

> Forest FX Reference Rate Converter is a paid API for AI agents from http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-27).

Converts a bounded fiat currency amount using the latest European Central Bank daily foreign-exchange reference rates, returning deterministic cross-rates through EUR.

## Facts

- Endpoint: POST https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/fx/reference?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-27
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forest-fx-reference-rate-converter-40ab81b1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_J3eBV-N7ukzGieSD2mBHt

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability forest-fx-reference-rate-converter-40ab81b1 -d '<json body>'
```

Example prompt: Using Forest's ECB reference rate, convert 750 US dollars to Japanese yen and tell me the official ECB observation date that rate is from.

## When to prefer this

Choose this endpoint when you need a deterministic, authoritative, non-commercial exchange rate sourced from the European Central Bank — ideal for accounting, compliance, invoicing, or any context where an official reference rate is required rather than a live market bid/ask quote. Not suitable for trading, real-time market pricing, or intraday arbitrage decisions.

## Known failure modes

- Unsupported or invalid 3-letter currency code returns an error
- ECB data unavailable beyond fallback window may result in stale or error response
- Non-numeric or out-of-range amount input may be rejected
- Payment not included or invalid results in HTTP 402 with payment requirement

## How this service works

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

## Output

Returns the converted amount in the target currency, the ECB observation date the rate was sourced from, and an indication of whether the data is live or a bounded cached fallback explicitly labeled as official cached data. Rates are cross-calculated through EUR as the base currency.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "to": {
   "type": "string",
   "pattern": "^[A-Za-z]{3}$",
   "description": "Public to value used to scope this lookup."
  },
  "from": {
   "type": "string",
   "pattern": "^[A-Za-z]{3}$",
   "description": "Public from value used to scope this lookup."
  },
  "amount": {
   "type": [
    "number",
    "string"
   ],
   "description": "Public amount value used to scope this lookup."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forest-fx-reference-rate-converter-40ab81b1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run](https://www.zero.xyz/host/http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/llms.txt)