▣ FINANCE · STANDARD DATA

Multi-Currency Converter API

Hosted on ApyHub

What it does

The Multi-Currency Converter API returns exchange rates from one source currency to several target currencies in a single request. Send a source currency code and a targets array, for example usd to ["eur", "gbp", "jpy"], and get back a flat JSON object keyed by currency pair, such as usd_eur and usd_gbp.

Add an optional date in YYYY-MM-DD format to get historical rates for that day. Leave it out to get today's rates. If a rate is unavailable for a pair, its value is false, so check each key before you use it.

Use it to fill a multi-currency pricing page in one call, convert an invoice total for customers in several regions, or build monthly reports that show revenue in every currency you sell in. One request replaces a loop of single-pair calls, which cuts latency and code.

For a single pair, the Currency Converter API returns one rate.

Pairs well with: the Currencies Dictionary API to check the codes in targets before the call, and the Global Pricing Recommendations API to set market-specific prices that you then show in each local currency. AI agents can call the multi-currency converter API through ApyHub MCP.

POST

Convert one source currency to multiple targets

https://api.eu.apyhub.com/apyhub/convert-currency-to-multiple-currencies

QUICKSTART

GUIDE

Quickstart

Convert one source currency into a set of target currencies.

curl -X POST "https://api.eu.apyhub.com/apyhub/convert-currency-to-multiple-currencies" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "usd",
    "targets": ["eur", "gbp", "jpy"]
  }'

What you'll get back

Returns a JSON object where each top-level field is a currency pair like usd_eur.

{
  "usd_eur": 0.9214,
  "usd_gbp": 0.7891,
  "usd_jpy": 161.8731257
}

TRY ITLIVE · 5 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Converts one source currency into multiple target currencies for a given date and returns a JSON object of conversion results keyed by currency pair.

Request Body

Parameter	Type	Mandatory	Description
date	String	No	Date in `YYYY-MM-DD` format. Defaults to today when omitted or blank.
source	String	Yes	Source currency code.
targets	String Array	Yes	Target currency codes to convert into.

Response

Returns a JSON object whose top-level fields are dynamic currency-pair keys such as usd_eur, usd_gbp, and usd_jpy.

Parameter	Type	Mandatory	Description
`{source}_{target}`	Decimal	Yes	One field per requested target, keyed as the `source` and `target` codes joined by an `underscore` (for example `usd_eur`). The value is the exchange rate for that pair.

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.

Similar APIs

Closest matches in the catalog based on this service.

CALLCurrency Converter API: Live & Historical Exchange RatesApyHub CALLForeign Exchange Rates APIQuadlem, LLC CALLGlobal Pricing Recommendations APISumalya APIs CALLConvert Date & Time Formats APInick creighton

From the blog

Reads that touch this API.

Currency Conversion and Exchange Rates Made Easy for DevelopersAug 5, 2026 ApyHub Changelog – 01 Nov 2023: Latest API UpdatesJul 9, 2026 Getting Started with APIs: A Beginner’s Guide 2026Sep 17, 2026 Build Inventory Management App in Retool with ApyHub Currency APIAug 7, 2026