# Mekler AI Currency Reference Converter

> Mekler AI Currency Reference Converter is a paid API for AI agents from api.mekler.ai, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-30).

Converts a currency amount between two ISO 4217 currency codes using dated public reference rates with explicit rounding, rate age, and source attribution.

## Facts

- Endpoint: POST https://api.mekler.ai/v1/finance/currencies/convert-reference-amount?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mekler-ai-currency-reference-converter-b672a752
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_R4CnXKqv3LiTFDxQHBWMU

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 mekler-ai-currency-reference-converter-b672a752 -d '<json body>'
```

Example prompt: Convert 500 USD to EUR using today's public reference rate and show me the rate date, source, and how the result was rounded.

## When to prefer this

Choose this endpoint when you need a traceable, dated reference-rate currency conversion with explicit source attribution and rounding disclosure — especially for accounting, reporting, or compliance contexts where an audit trail matters. It supports historical rates back to 1999-01-04, making it suitable for retrospective financial calculations. Do not use it for live trading prices, payment execution, or intraday FX quotes.

## Known failure modes

- Unsupported or unknown currency code returns an error
- Historical date before 1999-01-04 is out of range
- Holiday or missing date falls back to the nearest prior observation; inspect rate_date and age_days
- Network or upstream Frankfurter API unavailability
- Malformed amount string not matching the required pattern
- Invalid date format not conforming to ISO 8601

## How this service works

Convert an amount between two currency codes using dated public reference rates and decimal arithmetic. Return the rate date, age, source and explicit rounding. Optional historical date from 1999-01-04; holidays may use earlier observations. No executable payment quote, intraday market feed or trading execution.

## Output

A JSON object containing: the converted amount (8 decimal places, ROUND_HALF_EVEN), the exchange rate used, the rate date and age in days, the source name and URL, the rate type ('reference'), rounding description, requested date, observed timestamp, and a limitations array clarifying this is not an executable payment quote or intraday price.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "base": {
   "type": "string",
   "pattern": "^[A-Z]{3}$"
  },
  "date": {
   "type": "string",
   "format": "date"
  },
  "quote": {
   "type": "string",
   "pattern": "^[A-Z]{3}$"
  },
  "amount": {
   "type": "string",
   "pattern": "^[0-9]{1,13}(?:\\.[0-9]{1,8})?$"
  },
  "request_id": {
   "type": "string",
   "pattern": "^[A-Za-z0-9_-]{16,64}$"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "base": "USD",
  "rate": "0.9",
  "quote": "EUR",
  "amount": "100.00",
  "source": "Frankfurter daily blended reference rates",
  "status": "ok",
  "age_days": 1,
  "rounding": "8 decimal places, ROUND_HALF_EVEN; not currency minor-unit rounding",
  "rate_date": "2026-10-19",
  "rate_type": "reference",
  "source_url": "https://api.frankfurter.dev/v2/rate/usd/eur",
  "limitations": [
   "Reference conversion only; not an executable quote, payment or intraday trading price.",
   "Historical requests may use an earlier observation for holidays or missing dates; inspect rate_date and age_days.",
   "Source coverage and rates may change; conversion uses the dated retrieved observation."
  ],
  "observed_at": "2026-10-20T00:00:00Z",
  "requested_date": null,
  "converted_amount": "90.00000000"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mekler-ai-currency-reference-converter-b672a752/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.mekler.ai](https://www.zero.xyz/host/api.mekler.ai/llms.txt)