▣ FINANCE · STANDARD DATA

Convert Currency to Multiple Currencies API

Hosted on ApyHub

What it does

Currency Conversion lets you convert one source currency into multiple target currencies in a single request. Send a source currency code and a targets array, and optionally include a date to get rates for a specific day. If you omit date or leave it blank, it defaults to today.

The response is a flat JSON object where each key is a source-to-target pair such as usd_eur or usd_gbp. That makes the output easy to consume in pricing workflows, checkout logic, reporting jobs, or internal finance tools that need to compare several currencies at once.

Use Currency Conversion when you need to quote prices in multiple markets, normalize amounts across regions, or check historical FX rates for a given day. It keeps the request small and the response simple, so you can map returned pairs directly into your application without extra parsing.

POST

Convert one source currency to multiple targets

http://localhost:8080/apyhub/convert-currency-to-multiple-currencies

QUICKSTARTGUIDE

Quickstart

Convert one source currency into a set of target currencies.

curl -X POST "http://localhost:8080/apyhub/convert-currency-to-multiple-currencies" \
  -H "apy-token: $APY_TOKEN" \
  -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.