▣ 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, such as usd to ["eur", "gbp", "inr"]. Add an optional date in YYYY-MM-DD format to get the rates for a specific day. Without a date, you get today's rates.

The response is a flat JSON object with one key per currency pair, such as usd_eur or usd_gbp, each holding the exchange rate. Multiply a rate by your amount to convert it. If a rate isn't available for a pair, its value is false.

Use it to show prices in several currencies on a pricing or checkout page, convert invoice totals across regions, or pull historical rates for financial reporting. One call replaces a separate request per currency.

For a single currency pair, use the Currency Converter API. You can start on ApyHub's free tier with no card required.

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	Decimal value(s) that returns the exchange rate for the source - target currencies

Body

Name

Type

Description

bodyREQUIRED

object

—

▣ 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