{"uid":"cap_DuUKotK5RB57WB7WdaNse","slug":"gapup-fx-rate-lookup-8c877f30","name":"Gapup FX Rate Lookup","description":"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.","url":"https://mcp.gapup.io/api/v1/call/fx_rate","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":{"type":"json","example":{"tool":"fx_rate","result":{},"source":"rest-api"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UsoZGxwxTBHvyMrx7CkEC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the foreign exchange rate between two ISO-4217 currencies, optionally for a specific historical date","exampleAgentPrompt":"What's the exchange rate from EUR to USD today, and what was it on 2024-01-15?","exampleUseCases":[{"title":"Multi-currency invoice reconciliation","prompt":"I need to reconcile invoices in different currencies from last quarter. Can you get me the historical FX rates for EUR to USD, GBP to USD, and JPY to USD for March 15th, 2024?"},{"title":"Real-time payment conversion pricing","prompt":"A customer just asked about paying their invoice in CAD instead of USD. What's today's exchange rate from CAD to USD so I can quote them an accurate amount?"},{"title":"Historical financial statement analysis","prompt":"We're auditing our financial records from six months ago. Pull the exchange rates for CHF to EUR and AUD to USD from September 1st, 2024 to verify our currency conversion entries."}],"resultDescription":"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'.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T13:01:38.485Z","isFirstParty":false}