canonical: https://jentic.com/apis/rate-api.com/rate-api # Rate-API The Rate-API API returns latest and historical foreign-exchange rates for more than 160 currencies and converts amounts between any two of them. Beyond fiat rates it serves daily time series and fluctuation reports over ranges of up to 366 days, top cryptocurrency prices, closing prices for tracked equities, and gold, silver, platinum and palladium per troy ounce. Account endpoints report the key's plan, request counts, and remaining quota, so a caller can check its own headroom before a batch of lookups. ## For AI agents Look up live and historical exchange rates, convert amounts between currencies, pull daily time series and fluctuation reports, and read crypto, stock, and precious-metal prices. ## Scope Does not move money, execute currency trades, or hold balances. Use for reading exchange rates, conversions, and asset prices only. ## Capabilities - Fetch the latest exchange rates for a base currency, filtered to chosen targets with the symbols parameter - Convert an amount from one currency to another with the from, to, and amount parameters - Read the current rate for a single currency pair addressed in the URL path, such as `/pair/USD/EUR` - Pull rates for a past date, or a daily series between start_date and end_date spanning at most 366 days - Report how each currency moved over a date range, with start and end rate plus absolute and percentage change - Price top cryptocurrencies, tracked equities, and precious metals such as XAU and XAG in USD - Check the key's plan, request usage, and remaining quota before running a batch of lookups ## Use cases ### Currency conversion inside an AI agent through Jentic An agent that prices invoices, quotes, or travel budgets in several currencies needs an exchange rate at the moment it answers. Through Jentic the agent searches for 'convert currency', receives the Rate-API convert operation with its from, to, and amount inputs, and calls it with the key injected by your self-hosted Jentic One instance. The result is a converted figure the agent can drop straight into its reply. Example prompt: Call GET /convert with from 'GBP', to 'JPY', and amount 250, then report the converted amount in yen ### Historical rate lookups for bookkeeping Accounting and expense tools need the rate that applied on the day a transaction happened, not today's rate. The historical operation takes a date in YYYY-MM-DD format plus optional base and symbols, so a reconciliation script can price each foreign-currency line at its booking date. Historical rates are available on the Pro plan and up. Example prompt: Call GET /historical with date '2025-12-31', base 'EUR', and symbols 'USD,GBP', then return both rates ### Currency movement reports Treasury dashboards and newsletters often summarise how a currency moved over a month or a quarter. The timeseries operation returns daily rates keyed by date for a range of up to 366 days, and the fluctuation operation returns the start rate, end rate, absolute change, and percentage change for each currency over the same kind of range. Both are Business plan and up. Example prompt: Call GET /fluctuation with start_date '2026-01-01', end_date '2026-03-31', base 'USD', and symbols 'EUR,CHF', then summarise the percentage change for each ### Multi-asset price snapshot Portfolio summaries that mix cash, crypto, equities, and bullion can pull every price from one provider. The crypto operation returns top cryptocurrency prices in USD, the stocks operation returns latest closing prices for tracked tickers such as AAPL and MSFT, and the metals operation prices XAU, XAG, platinum, and palladium per troy ounce. Example prompt: Call GET /metals with symbols 'XAU,XAG' and GET /crypto with symbols 'BTC,ETH', then list the four USD prices ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/latest` | Latest rates for a base currency | | GET | `/convert` | Convert an amount between currencies | | GET | `/pair/{from}/{to}` | Latest rate for a currency pair | | GET | `/historical` | Rates for a past date | | GET | `/timeseries` | Daily rates over a date range | | GET | `/fluctuation` | Currency movement over a date range | | GET | `/metals` | Precious metal prices per troy ounce | | GET | `/quota` | Plan quota and remaining requests | ## Key resources - **Exchange rates** — Latest, historical, pair, time series, and fluctuation views of fiat currency rates - **Conversion** — Convert an amount between a source and a target currency - **Asset prices** — Cryptocurrency, equity closing, and precious-metal prices in USD - **Account** — Key status, request usage, and plan quota ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 64 / 100 - **Maturity:** AI-Aware - **Dimensions:** - Foundational Compliance: 93 / 100 - Developer Experience & Jentic Compatibility: 65 / 100 - AI-Readiness & Agent Experience: 47 / 100 - Agent Usability: 94 / 100 - Security: 50 / 100 - AI Discoverability: 71 / 100 - **View full report:** https://jentic.com/apis/rate-api.com/rate-api/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring the Rate-API by hand means attaching the `X-API-Key` header to every call, knowing which operations sit behind the Pro and Business plans, and tracking quota yourself. Through Jentic you install once, import the Rate-API from the API Directory, store the key once, and your agent calls it. - **Permission scoping:** The Rate-API takes currencies as query parameters on most operations, so rules bound which operations your agent may call, such as latest rates and conversion. The pair operation is the exception: it carries both currencies in the URL path, so a rule can fix the agent to one pair like `/pair/USD/EUR.` - **Credential handling:** Your Rate-API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'convert currency' or 'historical exchange rate', and Jentic returns the matching Rate-API operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **ExchangeRate-API** — Exchange rate and conversion API focused on fiat currencies - **Open Exchange Rates** — Latest and historical currency rates with a USD base - **Frankfurter** — Open-source exchange rate API based on central bank reference rates - **Stripe** — Payments API for charging customers in many currencies ## FAQ ### What authentication does the Rate-API use? Per its OpenAPI spec, the Rate-API authenticates with an API key sent in the `X-API-Key` header, issued from the Rate-API dashboard. The GET /status operation confirms a key works and reports the plan it belongs to. Through Jentic, the key is stored encrypted by your own Jentic One instance and injected when the call runs, so it never enters the agent's context. ### Is there a Rate-API MCP server? You don't need an MCP server to give your agent the Rate-API. Jentic connects it directly from the API Directory: import it, store your key once, and your agent calls it. Operations are discovered on demand, so no extra tool definitions sit in the agent's context. ### Can I limit what my agent is allowed to do with the Rate-API? Yes. For example, write a rule that allows only GET /latest and GET /convert, so the agent can quote today's rates and convert amounts but cannot run time series or fluctuation reports that draw on your Business plan allowance. For a single-pair widget, allow GET `/pair/{from}/{to}` with the pair fixed, such as `/pair/USD/EUR.` Every call the agent makes is logged. ### What are the rate limits for the Rate-API? The OpenAPI spec does not state a numeric rate limit. Limits are tied to your plan, and the GET /quota operation reports the plan quota and remaining requests for your key while GET /usage reports request counts. Check https://rate-api.com for current plan allowances. ### Which Rate-API operations need a paid plan? The spec marks GET /convert, GET /historical, GET /crypto, GET /stocks, and GET /metals as Pro plan and up, and GET /timeseries and GET /fluctuation as Business plan and up. GET /latest, GET `/pair/{from}/{to}`, GET /currencies, and the account operations carry no plan note in the spec. ### How do I convert a currency amount with the Rate-API through Jentic? Install Jentic One with `curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh`, import the Rate-API from the API Directory, and store your key. Your agent then searches for 'convert currency', gets the GET /convert operation with its from, to, and amount inputs, and calls it. To run it on your own infrastructure, install Jentic One from its GitHub repo.