data

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

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).

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

Request body

fromstring required

Base currency, ISO-4217 (e.g. EUR)

tostring required

Quote currency, ISO-4217 (e.g. USD)

datestring

Optional YYYY-MM-DD for a historical rate

asyncboolean

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

Tool result

toolstring
request_idstring
source'rest-api'
msnumber

Changes

No recorded changes to this operation across all 1 revision of this API.