Exchangeratesapi.io API

Name: Exchangeratesapi.io API
Brand: exchangeratesapi.io
Availability: InStock

✓ Official Vendor SpecFinanceBankingapiKey6 EndpointsREST

For Agents

Look up live and historical FX rates, convert between currencies, and pull time-series data for 168+ currencies and precious metals.

Install Jentic One Beta

Connect the Exchangeratesapi.io API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Exchangeratesapi.io 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://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic 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 Exchangeratesapi.io API.

Fetch the latest exchange rates against a chosen base currency

List the full set of supported currency and metal symbols

Convert an amount from one currency to another in a single call

GET STARTED

Start building with Exchangeratesapi.io API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Exchangeratesapi.io API for, with concrete tasks.

★ Historical rate reporting for accounting

An accounting agent reconciles a foreign-currency invoice from last year. It calls /{date} with the invoice's issue date and the base currency, retrieves the historical rate, and books the corresponding domestic-currency value into the ledger - no manual rate hunting required.

Call GET /2024-03-15 with base USD and symbols=GBP, then book the GBP-to-USD rate against the corresponding invoice.

Quarter-over-quarter FX trend chart

A finance dashboard renders a chart of EUR-to-USD movements over the previous quarter. The agent calls /timeseries with start and end dates, returns the daily rate series, and feeds it into a chart component for the FX commentary section of a board pack.

Call GET /timeseries with start_date=2026-01-01, end_date=2026-03-31, base=EUR, and symbols=USD, then return the daily rate series.

Currency conversion in a price-display widget

A SaaS pricing page lets visitors switch the displayed price into their local currency. The frontend calls a backend agent that uses /convert to compute the local amount once per session and caches the result for the rest of the visit, keeping the widget snappy.

Call GET /convert?from=USD&to=EUR&amount=49.99, return the converted amount, and cache it for 5 minutes per user session.

AI agent FX lookup via Jentic

An AI assistant integrated through Jentic answers natural-language FX questions like 'what was 1 USD in JPY on the 4th of July?' by calling the historical endpoint. Jentic isolates the API key in your Jentic One instance and exposes only the operation schema to the agent.

Use Jentic to search for 'historical exchange rate', load the GET /{date} operation, and return the USD-to-JPY rate for 2024-07-04.

Key Endpoints

6 endpoints — exchangeratesapi.

METHOD

PATH

DESCRIPTION

GET

/latest

Fetch the latest exchange rates

GET

/symbols

List supported currency and metal symbols

GET

/convert

Convert an amount between two currencies

GET

/{date}

Fetch historical rates for a specific date

GET

/timeseries

Fetch daily rates across a date range

GET

/fluctuation

Fetch rate fluctuation over a window

GET

/latest

Fetch the latest exchange rates

GET

/symbols

List supported currency and metal symbols

GET

/convert

Convert an amount between two currencies

GET

/{date}

Fetch historical rates for a specific date

GET

/timeseries

Fetch daily rates across a date range

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Your exchangeratesapi.io 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 'get a historical exchange rate', and Jentic returns the matching exchangeratesapi.io operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

Time to first call

FAQs

Specific to using Exchangeratesapi.io API through Jentic.

What authentication does the exchangeratesapi.io API use?

exchangeratesapi.io uses API key authentication. Through Jentic, the key is stored encrypted in your Jentic One instance and replaced with a scoped token at call time, so the raw key never enters the agent's context.

Can I get historical exchange rates from this API?

Yes. GET /{date} returns rates for a specific past date, GET /timeseries returns daily rates across a range, and GET /fluctuation returns change and percentage change over a window - covering both point-in-time and trend queries.

How do I convert one currency to another in a single call?

Use GET /convert with from, to, and amount query parameters. The response includes the converted amount and the rate used, removing the need to call /latest and compute the multiplication client-side.

What are the rate limits for exchangeratesapi.io?

Rate limits depend on the subscription tier and are enforced at the gateway. The OpenAPI spec does not pin specific numbers, so agents should handle 429 responses with backoff and respect any Retry-After header returned by the service.

How do I fetch a time-series of rates through Jentic?

Run pip install jentic, search for 'fx rate timeseries', load the GET /timeseries operation, and execute with start_date, end_date, base, and symbols. Jentic returns the parsed payload so the agent can chart or report on it.

Does exchangeratesapi.io support precious metals?

Yes. The /symbols endpoint includes metal symbols such as XAU (gold) and XAG (silver). They can be used as base or target in /latest, /{date}, and /timeseries calls just like a regular currency code.

Can I limit what my agent is allowed to do with the exchangeratesapi.io API?

Yes. Because you run Jentic One yourself, your own rules decide which operations and credentials the agent may use, so you can scope it to only the endpoints it needs, such as GET /latest, GET /convert, or GET /timeseries, and withhold the rest. Every exchangeratesapi.io operation is a read-only GET that takes its parameters in the query string rather than resource paths, so a scoped agent can fetch rate data and perform no writes. Your API key stays with your Jentic One instance and is injected only when an allowed operation runs.