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

# Interzoid Convert Currency Rate API

Jentic publishes the only available OpenAPI specification for the Interzoid Convert Currency Rate API, keeping it validated and agent-ready. The single GET endpoint converts an amount from one currency into another at the current foreign-exchange rate, returning the converted amount, the rate applied, and the remaining licence credits. Authentication is an Interzoid licence key passed as the 'license' query parameter alongside the source currency, target currency, and amount.

## For AI agents

Convert an amount from one currency to another at the current FX rate via a single Interzoid GET call.

## Scope

Does not handle historical FX rates, currency forecasting, money movement, or trade execution - use for current-rate amount conversion between two currencies only.

## Capabilities

- Convert a numeric amount from a source currency code to a target currency code at the live rate
- Return the rate used in the conversion alongside the converted amount for audit
- Surface remaining licence credits in every response for budget tracking
- Authenticate with an Interzoid licence key passed as a query parameter

## Use cases

### Multi-Currency Invoice Generation

Finance teams generating invoices for international customers convert the home-currency price into the customer's local currency at issue time using GET /convertcurrency. The response includes the rate used so the invoice can document the exchange explicitly. The single-endpoint surface keeps the integration small enough for an embedded billing module.

Example prompt: Convert 1,250.00 USD to EUR via GET /convertcurrency and return the converted amount and rate used

### E-Commerce Storefront Localisation

Online stores display prices in the visitor's local currency by converting from a base currency at page-render time. The Interzoid endpoint returns the converted amount and the applied rate so the store can show a 'rate as of...' note. Caching the rate per currency pair on a short TTL keeps API usage low.

Example prompt: For each visitor session, convert the catalog's USD prices into the visitor's locale currency once per hour and cache the rate

### Treasury Pre-Trade Quote

A treasury function checks Interzoid's converted rate as one input among several before executing a real currency trade. The endpoint provides a quick read of the prevailing rate without the overhead of a market-data subscription. Combining the Interzoid quote with the executed broker rate creates a simple slippage audit.

Example prompt: Convert 100,000 EUR to USD via GET /convertcurrency, log the rate and timestamp, and pass to the trading desk

### Agent-Driven Expense Conversion

An AI expense-report agent converts non-home-currency receipts into the corporate base currency at submission time using Interzoid. Jentic stores the licence key in your Jentic One instance and injects it as the query parameter so the agent never sees the raw key. Expense reports that previously required a manual lookup against an FX site now finalise in one step.

Example prompt: Given a receipt of 8,500 JPY, call /convertcurrency to convert to USD and store the converted amount with the rate used

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/convertcurrency` | Convert an amount from a source currency to a target currency at the current rate |

## Key resources

- **Currency Conversion** — Single GET endpoint that converts an amount from one currency to another at the current rate

## Why Jentic

- **Setup:** Wiring the Interzoid Convert Currency Rate API by hand means passing your licence key as a query parameter on every call and remembering the single /convertcurrency endpoint. Through Jentic you install once, import the Interzoid Convert Currency Rate API from the API Directory, store the licence key once, and your agent calls it.
- **Permission scoping:** This API exposes one read-only operation, GET /convertcurrency, with the currencies and amount in the query, so limit the agent to that operation. It moves no money and performs no writes, so there is nothing destructive to add.
- **Credential handling:** Your Interzoid licence key is stored once, encrypted, by your own Jentic One instance and injected as the license query parameter at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'convert 100 USD to EUR', and Jentic returns the GET /convertcurrency operation with its currency and amount query parameters so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Interzoid Get Currency Rate API** — Returns the raw FX rate without performing a conversion, where this API does both
- **ExchangeRate-API** — Dedicated FX-rate API with multi-pair tables versus Interzoid's single-conversion endpoint
- **CurrencyBeacon API** — FX-rate API with historical data versus Interzoid's current-rate conversion

## FAQ

### Why is there no official OpenAPI spec for the Interzoid Convert Currency Rate API?

Interzoid does not publish OpenAPI specifications for its endpoints. Jentic generates and maintains this spec so that AI agents and developers can call the Interzoid Convert Currency Rate API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

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

Authentication is a licence key passed as the 'license' query parameter on GET /convertcurrency. Register at www.interzoid.com/register to obtain a key. Through Jentic, the key is stored in your Jentic One instance and injected at execution time so it never enters the agent's prompt.

### What does the response include?

The response returns the converted amount, the FX rate used in the conversion, a result code, and a 'Credits' field showing the remaining balance on the licence. The rate field is what makes the call auditable for finance and accounting use cases.

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

Interzoid runs on a credit-per-call model rather than a hard rate limit. Each successful response includes a 'Credits' field, and HTTP 402 is returned when credits are exhausted. Higher tiers carry larger credit pools.

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

Search Jentic for 'convert a currency'. The SDK returns the GET /convertcurrency operation with source-currency, target-currency, and amount query parameters. Run pip install jentic, await client.search('convert a currency'), then await client.execute(...) with the inputs.

### How fresh are the FX rates returned by the API?

Interzoid sources current foreign-exchange rates and updates them throughout the day. The exact refresh cadence is not declared in the spec; for high-frequency or trade-execution use cases prefer a dedicated market-data feed and use Interzoid for general-purpose conversion in finance and ecommerce flows.

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

Yes. Because you run Jentic One yourself, your own rules decide which operations and credentials your agent may use. This API exposes a single read-only operation, GET /convertcurrency, so you can restrict the agent to just that call, passing only the source currency, target currency, and amount. Since the endpoint moves no money and performs no writes, scoping the agent to this one operation gives it exactly the currency-conversion access it needs and nothing more.