canonical: https://jentic.com/apis/interzoid.com/interzoid-get-currency-rate-api

# Interzoid Get Currency Rate API

The Interzoid Get Currency Rate API returns the latest exchange rate against the US Dollar for a given three-letter ISO currency code. Rates are aggregated from multiple global sources and refreshed several times per day, so the value reflects current market conditions rather than a single bank's quote. The single GET /getcurrencyrate endpoint authenticates with a license key passed as a query parameter and returns the rate as JSON.

## For AI agents

Get the latest USD exchange rate for an ISO currency code. One GET endpoint, license-key auth, refreshed several times per day.

## Scope

Does not execute currency trades, provide historical rate series, or convert directly between two non-USD currencies in one call - use for spot USD-denominated rate lookups only.

## Capabilities

- Retrieve the latest USD exchange rate for any ISO 4217 currency code
- Convert order totals stored in foreign currencies to USD for reporting
- Display real-time pricing in a customer's local currency on a checkout page
- Recompute consolidated revenue figures using fresh FX rates each day
- Detect significant FX moves by comparing successive rate responses

## Use cases

### Multi-currency order reporting

Finance teams convert order totals stored in local currencies into USD for consolidated reporting by calling the Interzoid Get Currency Rate API once per currency at the start of the reporting period. Rates are aggregated from many global sources and refreshed several times daily, so the consolidated number reflects current market conditions.

Example prompt: Call /getcurrencyrate with currency=EUR and multiply each EUR-denominated order total by the returned rate to produce USD totals.

### Local-currency pricing on checkout

E-commerce platforms use the Interzoid Get Currency Rate API to display prices in the visitor's local currency. The API returns a single rate per call, so the platform caches a small set of rates per session and refreshes on a timed interval rather than on every page view.

Example prompt: On session start, call /getcurrencyrate for each of the active store currencies and cache the rates for 30 minutes for product-page price rendering.

### Daily FX revaluation job

Accounting systems schedule a nightly batch that calls the Interzoid Get Currency Rate API for each currency held on the balance sheet, applies the returned rate, and updates the USD-equivalent valuation. Because rates are refreshed several times per day, end-of-day runs reflect current market conditions.

Example prompt: On a 23:00 UTC schedule, call /getcurrencyrate for each currency in the holdings table and write the rate into fx_rates_daily.

### AI agent currency conversion

An AI agent answering finance questions discovers the Interzoid Get Currency Rate API through Jentic and converts amounts inline during conversation. Jentic stores the Interzoid license key in the credential vault and injects it as the license query parameter at execution time, so the agent never sees the raw key.

Example prompt: Search Jentic for 'get latest currency exchange rate', load the Interzoid Get Currency Rate operation, and execute it with currency=GBP to convert a £500 quote to USD.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/getcurrencyrate` | Return the latest USD exchange rate for a currency code |

## Key resources

- **Currency rate lookup** — Single GET operation that accepts a three-letter ISO currency code and returns the latest USD exchange rate.

## Why Jentic

- **Setup:** Wiring the Interzoid Get Currency Rate API by hand means obtaining a license key, appending it as a license query parameter on each call to /getcurrencyrate, and handling the request plumbing yourself. Through Jentic you install once, import this API from the API Directory, store the license key once, and your agent calls it.
- **Permission scoping:** This API exposes a single read-only GET /getcurrencyrate operation that takes a currency code in the query, with no resource id in the URL path, so scoping is at the operation level: you limit the agent to the spot-rate lookup it needs. It only reads a rate and writes nothing, so there is no destructive operation to include.
- **Credential handling:** Your Interzoid license key is stored once, encrypted, by your own Jentic One instance and injected as the license parameter at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'get the latest USD exchange rate for a currency', and Jentic returns the Get Currency Rate operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Interzoid Convert Currency Rate API** — Performs a direct conversion between two specified currencies in a single call
- **Interzoid Get Global Time API** — Returns local time for a given country, useful alongside FX for cross-region operations dashboards
- **Interzoid Get Country Match Similarity Key API** — Resolves country aliases to a similarity key, useful before mapping country to a default currency

## FAQ

### What authentication does the Interzoid Get Currency Rate API use?

The API uses a license key passed as the license query parameter on every call to /getcurrencyrate. Through Jentic the license key is held in the credential vault and injected at execution time, so the agent never handles the raw key.

### How current are the rates returned by the Interzoid Get Currency Rate API?

Rates are aggregated from many global sources and refreshed several times per day. They are suitable for reporting, ecommerce display, and accounting revaluation, but not for high-frequency trading where sub-second freshness is required.

### What are the rate limits for the Interzoid Get Currency Rate API?

The OpenAPI spec does not publish a numeric rate limit. Interzoid enforces per-license-tier quotas on the account dashboard, so check your account page before running scheduled batch refreshes.

### How do I convert a currency through Jentic?

Install the SDK with pip install jentic, search for 'get latest currency exchange rate', load the Interzoid Get Currency Rate operation, and execute it with the three-letter ISO currency code as the currency parameter.

### Can the Interzoid Get Currency Rate API return cross-rates between two non-USD currencies?

Each call returns a single currency's rate against USD. To compute a cross-rate such as EUR to GBP, call /getcurrencyrate twice and divide the two USD-denominated rates client-side.

### Can I limit what my agent is allowed to do with the Interzoid Get Currency Rate API?

Yes. Because you run Jentic One yourself, your own rules decide which operations and credentials the agent may use. This API exposes a single read-only GET /getcurrencyrate operation, so you scope at the operation level and grant the agent only the spot USD rate lookup it needs. It reads a rate and writes nothing, so there is no destructive operation to expose, and your stored license key is injected at execution time rather than handed to the agent.