Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Rate-API, 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.
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%2Frate-api.com%2Frate-api" | shStep 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%2Frate-api.com%2Frate-api" | 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.
What an agent can do with Rate-API.
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
GET STARTED
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
Patterns agents use Rate-API for, with concrete tasks.
★ 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.
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.
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.
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.
Call GET /metals with symbols 'XAU,XAG' and GET /crypto with symbols 'BTC,ETH', then list the four USD prices
13 endpoints — the rate-api api returns latest and historical foreign-exchange rates for more than 160 currencies and converts amounts between any two of them.
METHOD
PATH
DESCRIPTION
/latest
Latest rates for a base currency
/convert
Convert an amount between currencies
/pair/{from}/{to}
Latest rate for a currency pair
/historical
Rates for a past date
/timeseries
Daily rates over a date range
/fluctuation
Currency movement over a date range
/metals
Precious metal prices per troy ounce
/quota
Plan quota and remaining requests
/latest
Latest rates for a base currency
/convert
Convert an amount between currencies
/pair/{from}/{to}
Latest rate for a currency pair
/historical
Rates for a past date
/timeseries
Daily rates over a date range
/fluctuation
Currency movement over a date range
/metals
Precious metal prices per troy ounce
/quota
Plan quota and remaining requests
What agents get from Jentic-routed access to this vendor.
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 isolation
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.
Intent-based discovery
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.
Alternatives and complements available in the Jentic catalogue.
Specific to using Rate-API through Jentic.
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.
For 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.
Use for: I need to convert 250 GBP into Japanese yen, Get the latest USD to EUR exchange rate, Retrieve the EUR rates against USD and GBP for 2025-12-31, Find all daily USD to CHF rates for the first quarter of the year
Not supported: Does not move money, execute currency trades, or hold balances. Use for reading exchange rates, conversions, and asset prices only.
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.
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.
Base layer of spec validity and structural soundness.
Aggregated quality score from linter diagnostics, weighted by severity.
Percentage of `$ref` references that resolve successfully.
Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).
Structural correctness score based on schema issues using logarithmic dampening.
Clarity, completeness, and ingestion readiness for developers and tooling.
How richly the API is illustrated with examples.
Percentage of examples that conform to their schemas.
Percentage of operations with complete response definitions (success, client error, server error).
Health of API ingestion, bundling, and resolution within Jentic pipelines.
Semantic breadth, depth, and agent comprehension for AI systems.
Coverage of descriptions across API elements.
Coverage of RFC 9457 Problem Details for error responses.
Coverage, uniqueness, and casing consistency of operationIds for AI inference.
Coverage of summaries across operations/tags/info.
Functional utility, complexity comfort, and AI orchestration readiness.
Agent comfort level based on API operational and structural complexity.
Trust, risk posture, and security compliance.
Average quality of security schemes based on authentication method strength (weakest link for OAuth2).
Findability, semantic richness, and reasoning readiness.
Clarity and depth of descriptions across API elements.
Score it yourself
Every API in the directory is allowlisted, so you can re-score it with no key required.
npx @jentic/api-scorecard-cli score <openapi-url>