---
title: "Get the current or historical foreign-exchange rate for any currency pair — the exact exchange rate, FX rate or conversi"
method: POST
path: "/api/v1/call/fx_rate"
tags: ["data"]
---

# Get the current or historical foreign-exchange rate for any currency pair — the exact exchange rate, FX rate or conversi

`POST /api/v1/call/fx_rate`

## Request

- Base URL: `https://mcp.gapup.io`
- URL: `https://mcp.gapup.io/api/v1/call/fx_rate`
- Auth: HTTP bearer

Get the current or historical foreign-exchange rate for any currency pair — the exact exchange rate, FX rate or conversion rate an agent needs to convert a currency amount or feed a finance, trading, invoicing or pricing workflow. Covers EUR/USD, USD/JPY, GBP/EUR and every ISO-4217 currency pair. Returns the latest spot rate, or a historical rate by date. Use when a workflow needs a precise live or past currency exchange rate, or to convert money between two currencies. Source: European Central Bank reference rates via Frankfurter. Inputs: from/to ISO-4217 currency codes, optional date (YYYY-MM-DD).

## Request body

- object
  - `from` string, required: Base currency, ISO-4217 (e.g. EUR)
  - `to` string, required: Quote currency, ISO-4217 (e.g. USD)
  - `date` string: Optional YYYY-MM-DD for a historical rate
  - `async` boolean: 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 `200`

Tool result

- object
  - `tool` string
  - `result` object
    - `from` string, required
    - `to` string, required
    - `rate` unknown, required
    - `as_of` unknown, required
    - `source` string, required
    - `source_url` string
  - `request_id` string
  - `source` 'rest-api'
  - `ms` number

## Other responses

- `400`: Invalid arguments
- `401`: Unauthorized
- `402`: Payment Required — pay via x402 (USDC on Base) then retry with X-Payment header
- `404`: Tool not found
- `429`: Rate limited
- `500`: Internal error

---

[API](https://skmtc.dev/gapup/apis/gapup-mcp-rest-api.md) · [All operations](https://skmtc.dev/gapup/apis/gapup-mcp-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gapup/apis/gapup-mcp-rest-api/revisions/afb9da3b98f4?raw)