apyhub
FINANCE

Convert Currency API

What it does

Currency Converter returns the exchange rate for a source and target currency pair, optionally for a specific date. Send source and target in the request body, and include date when you need a historical rate; if you omit date or leave it blank, the service uses today.

Use Currency Converter when you need a rate lookup inside pricing flows, invoices, reporting, or financial normalization. It is built around a simple pair-based request, so you can convert one currency into another without handling a larger market dataset.

The response contains a single data field. That field can be a numeric exchange rate or a boolean value, so your client should be prepared to handle either form exactly as returned.

If you are building checkout totals, exporting multi-currency reports, or backfilling currency values for a given day, Currency Converter gives you a direct rate lookup without extra fields to parse.

POST
Convert currency pair for a date
https://api.eu.apyverse.com/apyhub/convert-currency

QUICKSTART

GUIDE

Quickstart

Convert an amount from one currency to another for a given date with this minimal request.

curl -X POST "https://api.eu.apyverse.com/apyhub/convert-currency" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"source":"usd","target":"eur"}'

What you'll get back

Returns a JSON object with a data field, which can be either a number exchange rate or a boolean value.

{
  "data": 0.9214
}
TRY ITLIVE · 50 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*
Defaults to today when omitted or blank.

About this endpoint

What it does

Converts a currency pair for a specified date and returns the result in a JSON object with a data field. The data field is either a numeric exchange rate or a boolean, depending on the response shape.

Request Body

ParameterTypeMandatoryDescription
dateStringNoDate in date format. Defaults to today when omitted or blank.
sourceStringYesSource currency code.
targetStringYesTarget currency code.

Response

Returns a JSON object with a data field. The data field is either a Number or a Boolean value.

ParameterTypeMandatoryDescription
dataNumber / BooleanNoExchange rate as a number, or a boolean value.

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.