# meld402 FX Quote

> meld402 FX Quote is a paid API for AI agents from meld402.vercel.app, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Converts a given amount between any fiat currency or crypto pair by aggregating rates from multiple sources (Coinpaprika, ECB via Frankfurter) into a single stable response

## Facts

- Endpoint: POST https://meld402.vercel.app/api/fx/quote
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/meld402-fx-quote-522473bd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wOnKZc1KUTil9KJhsjqZ0

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 meld402-fx-quote-522473bd -d '<json body>'
```

Example prompt: What's the current exchange rate to convert 1 BTC into EUR, pulling from multiple market sources so I get a reliable quote?

## When to prefer this

Choose this endpoint when you need a single stable conversion quote that aggregates both crypto (Coinpaprika) and fiat (ECB via Frankfurter) rates in one call with a consistent schema. It is especially useful when converting between crypto and fiat, or cross-fiat pairs that route through USD. Prefer it over raw exchange APIs when you want source attribution and degradation tracking in the response, and when you are already operating in the x402 micropayment ecosystem on Base.

## Known failure modes

- Unsupported currency code returns an error — currency symbols must be valid ISO 4217 fiat codes or recognized crypto tickers
- Amount of 0 or negative is rejected by schema (exclusiveMinimum: 0)
- Source degradation: one or more underlying sources may be unavailable, reflected in the 'degraded' metadata array but response may still succeed with partial data
- Payment failure over x402 on Base results in 402 response before data is returned
- Invalid JSON body or missing required fields returns a 400-level error

## How this service works

14 paid data endpoints for autonomous agents and developers. Covers crypto intelligence (token, chain, Solana, gas), markets (FX, market pulse), location (weather), and research (news, brief). Each route aggregates multiple public sources into one stable schema with a single USDC payment over x402 on Base.

## Output

A JSON object containing the exchange rate between the two currencies, the converted result for the requested amount, USD reference prices for both currencies, the routing method used (e.g. via_usd), the date the rates are as of, and metadata including which data sources contributed (e.g. Coinpaprika, Frankfurter) and any degraded sources.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "to": {
   "type": "string",
   "maxLength": 20,
   "minLength": 2,
   "description": "Currency to convert to. Same formats as `from`."
  },
  "from": {
   "type": "string",
   "maxLength": 20,
   "minLength": 2,
   "description": "Currency to convert from. ISO 4217 fiat code (\"USD\") or crypto symbol (\"BTC\")."
  },
  "amount": {
   "type": "number",
   "default": 1,
   "maximum": 1000000000,
   "description": "Quantity of `from` to convert.",
   "exclusiveMinimum": 0
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "to": {
    "code": "EUR",
    "kind": "fiat",
    "usd_price": 1.1699
   },
   "from": {
    "code": "BTC",
    "kind": "crypto",
    "usd_price": 77554
   },
   "rate": 66291.14,
   "as_of": "2026-08-21",
   "route": "via_usd",
   "amount": 1,
   "result": 66291.14
  },
  "meta": {
   "as_of": "2026-08-24T00:00:00.000Z",
   "sources": [
    "coinpaprika",
    "frankfurter"
   ],
   "degraded": [],
   "attribution": [
    "Market data by Coinpaprika (coinpaprika.com)",
    "Fiat reference rates by Frankfurter, sourced from the ECB"
   ]
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/meld402-fx-quote-522473bd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from meld402.vercel.app](https://www.zero.xyz/host/meld402.vercel.app/llms.txt)