# Gapup FX Rate Lookup

> Gapup FX Rate Lookup is a paid API for AI agents from mcp.gapup.io, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-16).

Returns the foreign exchange rate between two ISO-4217 currencies, optionally for a specific historical date

## Facts

- Endpoint: POST https://mcp.gapup.io/api/v1/call/fx_rate
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gapup-fx-rate-lookup-8c877f30
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DuUKotK5RB57WB7WdaNse

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 gapup-fx-rate-lookup-8c877f30 -d '<json body>'
```

Example prompt: What's the exchange rate from EUR to USD today, and what was it on 2024-01-15?

## When to prefer this

Use this endpoint when you need a quick FX rate lookup for any standard ISO-4217 currency pair, especially when you want both current and historical rates via a single consistent REST interface. Prefer this over broader financial data APIs when the specific need is a point-in-time exchange rate rather than OHLC data, trade volume, or market analytics.

## Known failure modes

- Invalid ISO-4217 currency code returns an error or empty result
- Future dates may return an error or no data
- Historical data may not be available for all currency pairs or date ranges
- Missing required 'from' or 'to' fields returns a validation error
- Rate limiting or authentication failure returns 401/402 HTTP status

## How this service works

REST gateway for the Gapup MCP catalogue — 271 AI tools accessible via standard HTTP. Authentication via Authorization: Bearer <api_key>. Native MCP transport available at /mcp.

## Output

A JSON object containing the tool name ('fx_rate'), a result object with the exchange rate data for the requested currency pair (and optionally historical date), and a source field indicating 'rest-api'.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "to": {
   "type": "string",
   "description": "Quote currency, ISO-4217 (e.g. USD)"
  },
  "date": {
   "type": "string",
   "description": "Optional YYYY-MM-DD for a historical rate"
  },
  "from": {
   "type": "string",
   "description": "Base currency, ISO-4217 (e.g. EUR)"
  },
  "async": {
   "type": "boolean",
   "description": "If true, returns a job_id immediately (<200ms) instead of waiting for the result. Poll the result with job_result(job_id). Use for slow tools to avoid client timeouts."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tool": "fx_rate",
  "result": {},
  "source": "rest-api"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gapup-fx-rate-lookup-8c877f30/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mcp.gapup.io](https://www.zero.xyz/host/mcp.gapup.io/llms.txt)