FreeCurrencyAPI
Official vendor OpenAPI document · agent-readyFinanceBankingapiKey4 EndpointsREST
For Agents
Fetch latest and historical exchange rates for world currencies, list supported currencies with codes and symbols, and check remaining request quota.
Use for: Get the latest USD to EUR exchange rate, Convert this amount from GBP to JPY, Fetch historical exchange rates for a past date, List all currencies FreeCurrencyAPI supports
Not supported: 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.
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.
Install Jentic One Beta
Connect the FreeCurrencyAPI to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the FreeCurrencyAPI, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Ffreecurrencyapi.com%2Ffreecurrencyapi" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Ffreecurrencyapi.com%2Ffreecurrencyapi" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with FreeCurrencyAPI API.
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
Patterns agents use FreeCurrencyAPI API for, with concrete tasks.
★ 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.
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.
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.
List supported currencies for a selector, fetch the latest rates against the store currency, and convert the catalog prices for display
Key Endpoints
4 endpoints — freecurrencyapi provides exchange-rate data for world currencies.
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
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
Why Jentic?
What agents get from Jentic-routed access to this vendor.
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 isolation
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.
Intent-based discovery
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
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using FreeCurrencyAPI API through Jentic.
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.
GET STARTED