canonical: https://jentic.com/apis/freecurrencyapi.com/freecurrencyapi # FreeCurrencyAPI FreeCurrencyAPI provides exchange-rate data for world currencies. Fetch the latest rates for a base currency against any set of target currencies, or request historical rates for a past date or date range to power back-tested conversions and charts. A currencies endpoint lists every supported currency with its code, name, and symbol, and a status endpoint reports your remaining request quota. Responses return plain rate values keyed by currency code, so converting an amount is a single multiplication once you have the rate. ## For AI agents Fetch latest and historical exchange rates for world currencies, list supported currencies with codes and symbols, and check remaining request quota. ## Scope Covers latest rates, historical rates, the supported-currency list, and quota status. It does not execute currency trades, move money, or provide central-bank reference feeds. ## Capabilities - Fetch the latest exchange rates for a base currency against chosen targets - Request historical exchange rates for a past date or date range - List every supported currency with its code, name, and symbol - Check the remaining request quota on your account - Convert an amount by applying a returned rate to the source value ## Use cases ### AI Agent That Converts Currencies An agent handling quotes, expenses, or pricing needs to convert between currencies on the fly. Through Jentic it calls FreeCurrencyAPI for the latest rate between a base and target currency, then applies it to the amount. The agent discovers the latest-rates operation by intent, so it returns an accurate converted figure without a developer wiring the HTTP call or hardcoding stale rates. Example prompt: Fetch the latest rate from the source to the target currency and multiply the amount to return the converted value with the rate used ### Historical Rate Charts and Back-Testing A finance dashboard shows how a currency pair moved over time. It requests historical rates for a date range from FreeCurrencyAPI and plots the series, and it can back-test conversions against past dates. Because rates are keyed by currency code, the app builds a clean time series without extra parsing. Example prompt: Request historical rates for a currency pair across a date range and return the daily rate series for charting ### Multi-Currency Price Display An e-commerce or travel app shows prices in the user's home currency. It reads the list of supported currencies to build a selector, fetches the latest rates for the store's base currency against the chosen one, and converts each price. The status endpoint lets it monitor remaining quota so it can cache rates when usage is high. Example prompt: List supported currencies for a selector, fetch the latest rates against the store currency, and convert the catalog prices for display ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/latest` | Latest exchange rates for a base currency | | GET | `/historical` | Historical exchange rates for a date or range | | GET | `/currencies` | List supported currencies with codes and symbols | | GET | `/status` | Remaining request quota for the account | ## Key resources - **Latest rates** — Current exchange rates for a base currency against chosen targets - **Historical rates** — Exchange rates for a past date or date range - **Currencies** — The list of supported currencies with codes, names, and symbols - **Status** — Remaining request quota for the account ## Why Jentic - **Setup:** Using FreeCurrencyAPI by hand means passing the key as a query parameter, tracking your quota through the status endpoint, and turning rates into conversions yourself. Through Jentic you install once, import the API from the Directory, and your agent fetches the rate and converts. - **Permission scoping:** FreeCurrencyAPI is read-only, so you allow only the operations a task needs, such as GET /latest, and leave historical or status out of the allowed set. Rules run on your own instance and every call the agent makes is logged. - **Credential handling:** Your FreeCurrencyAPI key is stored once, encrypted, by your own Jentic One instance and injected at execution time, so it never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'get the latest exchange rate' or 'list supported currencies', and Jentic returns the matching FreeCurrencyAPI operation with its input schema so the agent calls the right endpoint without reading reference docs. ## Related APIs - **CurrencyAPI** — Exchange-rate API with latest and historical rates for many currencies - **ExchangeRate-API** — Simple exchange-rate feed with latest and historical conversions - **currencylayer** — Real-time and historical foreign-exchange rates for global currencies ## FAQ ### What authentication does FreeCurrencyAPI use? Per its OpenAPI spec it uses an API key passed as the apikey query parameter, which can also be sent as an apikey header. Through Jentic that key is stored encrypted on your own instance and injected at call time, so it never appears in the agent's prompt or logs. ### How do I convert one currency to another with FreeCurrencyAPI? Call GET /latest with the base currency and the target currencies, then multiply your amount by the returned rate. Through Jentic you search for the intent 'get the latest exchange rate' and the agent gets the operation and its input schema, so the conversion is a single call plus a multiplication. ### Can I get historical exchange rates from FreeCurrencyAPI? Yes. GET /historical returns rates for a past date or date range, which you can use to back-test conversions or plot how a currency pair moved over time. Rates come keyed by currency code so building a time series is straightforward. ### What are the rate limits for FreeCurrencyAPI? The OpenAPI spec does not define numeric rate limits; your monthly request allowance depends on your plan, and GET /status reports how many requests you have left. Cache rates that change slowly and check https://freecurrencyapi.com for current plan limits. ### Which currencies does FreeCurrencyAPI support? Call GET /currencies to list every supported currency with its code, name, and symbol. Agents use this to build a currency selector or to validate that a requested conversion uses supported codes before calling the rates endpoint. ### Can I limit what my agent is allowed to do with FreeCurrencyAPI through Jentic? Yes. The API is read-only, so you allow only the operations a task needs, such as GET /latest and GET /currencies, and leave the rest out of the allowed set. Every call runs through your own instance and is logged, so the agent's access stays under your control. ### Is there a FreeCurrencyAPI MCP server? You don't need a separate MCP server to give your agent FreeCurrencyAPI. Jentic connects it directly from the API Directory: import the API and your agent fetches rates and converts amounts on demand without loading another server's tool definitions into its context.