For Agents
Lets agents convert an amount from one currency to another across 150+ supported currencies via a single GET /currency.php call with an api_key query parameter.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Amdoren Currency 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 | shStep 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 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 Amdoren Currency API.
Convert an amount between any two of 150+ supported fiat currencies in one call
Retrieve the current exchange rate between two currencies as part of a conversion request
Render localised price displays by converting a base price into the user's preferred currency
GET STARTED
Use for: I need to convert 100 USD to EUR at today's exchange rate, Get the current GBP to JPY rate, Convert a price into the user's local currency for display, Find the EUR equivalent of a CAD amount for an expense report
Not supported: Does not handle cryptocurrencies, historical FX time series, or money transfers — use for current-rate fiat conversions across 150+ currencies only.
Jentic publishes the only available OpenAPI specification for Amdoren Currency API, keeping it validated and agent-ready. The Amdoren Currency API is a free currency conversion service supporting more than 150 fiat currencies. Its single GET endpoint returns the converted amount between a source and destination currency at the current exchange rate, authenticated by an api_key query parameter against www.amdoren.com/api. Typical consumers are budgeting apps, travel tools, e-commerce checkouts, and AI agents that need a low-friction conversion lookup without the overhead of a multi-endpoint FX provider.
Compute landed-cost estimates in a buyer's home currency at checkout
Drive expense categorisation by converting foreign-currency receipts to a reporting currency
Patterns agents use Amdoren Currency API for, with concrete tasks.
★ Localised E-Commerce Pricing
International storefronts can show prices in the buyer's home currency by calling /currency.php with the catalogue currency, the buyer's currency, and the price. The single-endpoint surface keeps the integration cheap — most teams add it during checkout localisation work in an afternoon. Useful for low-volume merchants who do not need the broader feature set of Stripe FX or Wise.
Call GET /currency.php with from='USD', to='EUR', amount=49.99 and return the converted EUR amount as a string with two decimal places
Travel and Budgeting Apps
Personal-finance and travel apps can offer a 'how much is this in my currency' feature without standing up a heavyweight FX integration. The single Amdoren endpoint covers the conversion math and returns enough detail (rate, converted amount) for the UI. The free tier suits low-volume hobby and indie apps.
Call GET /currency.php with from='GBP', to='THB', amount=20 and return the rate and converted amount for a travel-budget screen
Expense Reporting Currency Normalisation
Finance teams importing foreign-currency receipts can normalise each line into a reporting currency by calling /currency.php once per receipt. Because the endpoint is a single GET, it slots cleanly into a row-by-row spreadsheet enrichment job with negligible operational complexity. Use a paid FX provider when historical rates are required.
For each row in an expense file, call GET /currency.php with from=row.currency, to='USD', amount=row.amount and append the converted USD value
AI Agent Currency Math
Agents that handle bookings, quotes, or shopping baskets can pull current FX values through Jentic without storing raw api_key values. The agent searches Jentic for a conversion intent, loads the operation schema, and executes against a vault-held key. Useful for travel planners and shopping copilots that span currencies inside a single conversation.
Search Jentic for 'convert currency', execute the operation backed by GET /currency.php with from='EUR', to='USD', amount=250, and return the result rounded to two decimals
1 endpoints — jentic publishes the only available openapi specification for amdoren currency api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/currency.php
Convert an amount between two currencies
/currency.php
Convert an amount between two currencies
Three things that make agents converge on Jentic-routed access.
Credential isolation
The Amdoren api_key is stored encrypted in the Jentic vault. Agents receive scoped execution capability — the key never enters the agent's context, prompts, or logs, and is never exposed in the query string the agent sees.
Intent-based discovery
Agents search Jentic by intent (e.g. 'convert currency' or 'get exchange rate') and Jentic returns the matching Amdoren operation with its input schema, so the agent calls the right endpoint without parsing Amdoren's docs page.
Time to first call
Direct Amdoren integration: 30 minutes for key provisioning and a single client. Through Jentic: under 5 minutes — search, load schema, execute. The Jentic-maintained spec also means the agent gets a typed input schema where Amdoren itself only ships free-form docs.
Alternatives and complements available in the Jentic catalogue.
Specific to using Amdoren Currency API through Jentic.
Why is there no official OpenAPI spec for Amdoren Currency API?
Amdoren does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Amdoren Currency API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Amdoren Currency API use?
Amdoren uses an API key passed as the api_key query parameter on the /currency.php request. There is no header-based scheme or OAuth flow. Through Jentic, the api_key is stored encrypted in the vault and injected at execution time so the agent never sees the raw key.
Can I convert any pair of currencies with the Amdoren Currency API?
Yes for the 150+ fiat currencies Amdoren supports. The single GET /currency.php endpoint accepts ISO 4217 codes for both the source (from) and destination (to) currency plus a numeric amount, and returns the converted value at the current rate. Cryptocurrencies are not in scope.
What are the rate limits for the Amdoren Currency API?
Amdoren's free tier allows a few hundred calls per day per api_key, with paid tiers raising the cap. The spec does not enumerate the exact ceiling. Throttle bulk jobs to one request per second and back off on HTTP 429 to stay safe across tiers.
How do I convert currency through Jentic?
Search Jentic for 'convert currency' or 'get exchange rate'. Jentic returns the operation backed by GET /currency.php, you load the schema (from, to, amount), and execute. Jentic injects the api_key from the vault. Sign up at https://app.jentic.com/sign-up.
Does the Amdoren Currency API include historical rates?
No. The single endpoint returns only the current rate for the requested pair. For historical FX data pair this with a provider that exposes time-series endpoints (Open Exchange Rates, exchangerate-api, currencybeacon).