apyhub-logo

Convert Currency to Multiple Currencies API

100 atoms
Base tier

About

This Utility API allows you to convert currencies from a source currency to multiple target currencies.
This API supports more than 155+ currencies including common cryptocurrencies. The total list can be found in the documentation below. The rates are not real-time but are updated daily and you can also query for historical rates (for the past 2 years).
Using this API ensures that financial transactions are accurately recorded and reported, even when they involve different currencies. This helps to avoid errors and discrepancies in financial reporting. Currency conversion in software applications can provide businesses with greater visibility and control over their finances, especially in a globalized economy where transactions may involve multiple currencies.

API Playground

API Documentation

convert currency to multiple currencies
POST
https://api.apyhub.com/data/convert/currency/multiple

Request example

1
curl --location --request POST 'https://api.apyhub.com/data/convert/currency/multiple' \
2
--header 'Content-Type: application/json' \
3
--header 'apy-token: {{token}}' \
4
--data-raw '{
5
"source":"inr",
6
"targets":["usd", "aed", "eur"]
7
}'
Method: POST
Content Type: application/json
Request Body
AttributeTypeMandatoryDescription
sourceStringYesThe source currency
targetsArrayYesThe array of target currencies in string
dateStringNoThe date in yyyy-mm-dd, defaults to today, if not provided
Response
AttributeTypeDescription
source_targetDecimalDecimal value(s) that returns the exchange rate for the source - target currencies
Sample Response
Returns a Decimal value for the given amount
1
{
2
"inr_aed": 0.044382,
3
"inr_eur": 0.011266,
4
"inr_usd": 0.012085
5
}

HTTP Response Codes

The method may return one of the following HTTP status codes:
Status CodeDescription
200The request was successful.
401Required authentication information is either missing or not valid for the resource.
400Invalid input - either the date is invalid, source or target currencies are not provided as inputs or not valid currency codes are provided.
500If any unexpected error occurs while processing the request

Supported Currency Codes

Currency CodeCurrency Name
1inch1inch Network
aaveAave
adaCardano
aedUnited Arab Emirates Dirham
afnAfghan afghani
algoAlgorand
allAlbanian lek
amdArmenian dram
ampSynereo
angNetherlands Antillean Guilder
aoaAngolan kwanza
arArweave
arsArgentine peso
atomAtomic Coin
audAustralian dollar
avaxAvalanche
awgAruban florin
axsAXS
aznAzerbaijani manat
bamBosnia-Herzegovina Convertible Mark
batBasic Attention Token
bbdBajan dollar
bchBitcoin Cash
bdtBangladeshi taka
bgnBulgarian lev
bhdBahraini dinar
bifBurundian Franc
bmdBermudan dollar
bnbBinance Coin
bndBrunei dollar
bobBolivian boliviano
brlBrazilian real
bsdBahamian dollar
bsvBitcoin SV
bswBiswap
btcBitcoin
btcbBitcoin BEP2
btgBitcoin Gold
btnBhutan currency
busdBinance USD
bwpBotswanan Pula
bynNew Belarusian Ruble
byrBelarusian Ruble
bzdBelize dollar
cadCanadian dollar
cakePancakeSwap
cdfCongolese franc
celoCelo
chfSwiss franc
chzChiliz
clfChilean Unit of Account (UF)
clpChilean peso
cnyChinese Yuan
compCompound Coin
copColombian peso
crcCosta Rican Colón
croCrypto.com Chain Token
crvCravy
cucCuban peso
cupCuban Peso
cveCape Verdean escudo
cvxConvex Finance
czkCzech koruna
daiDai
dashDash
dcrDecred
dfiDfiStarter
djfDjiboutian franc
dkkDanish krone
dogeDogecoin
dopDominican peso
dotDotcoin
dzdAlgerian dinar
egldElrond
egpEgyptian pound
enjEnjin Coin
eosEOS
ernEritrean nakfa
etbEthiopian birr
etcEthereum Classic
ethEther
eurEuro
feiFei USD
filFileCoin
fjdFijian dollar
fkpFalkland Islands pound
flowFlow
fraxFrax
ftmFantom
fttFarmaTrust
galaGala
gbpPound sterling
gelGeorgian lari
ggpGGPro
ghsGhanaian cedi
gipGibraltar pound
gmdGambian dalasi
gnfGuinean franc
gnoGnosis
grtGolden Ratio Token
gtGateToken
gtqGuatemalan quetzal
gydGuyanaese Dollar
hbarHedera
hkdHong Kong dollar
hnlHonduran lempira
hntHelium
hotHydro Protocol
hrkCroatian kuna
htHuobi Token
htgHaitian gourde
hufHungarian forint
icpInternet Computer
idrIndonesian rupiah
ilsIsraeli New Shekel
impCoinIMP
injInjective
inrIndian rupee
iqdIraqi dinar
irrIranian rial
iskIcelandic króna
jepJersey Pound
jmdJamaican dollar
jodJordanian dinar
jpyJapanese yen
kavaKava
kcsKucoin
kdaKadena
kesKenyan shilling
kgsKyrgystani Som
khrCambodian riel
klayKlaytn
kmfComorian franc
kncKyber Network
kpwNorth Korean won
krwSouth Korean won
ksmKusama
kwdKuwaiti dinar
kydCayman Islands dollar
kztKazakhstani tenge
lakLaotian Kip
lbpLebanese pound
leoLEOcoin
linkChainLink
lkrSri Lankan rupee
lrcLoopring
lrdLiberian dollar
lslLesotho loti
ltcLitecoin
ltlLithuanian litas
lunaLuna Coin
lvlLatvian lats
lydLibyan dinar
madMoroccan dirham
manaDecentraland
maticPolygon
mdlMoldovan leu
mgaMalagasy ariary
minaMina
miotaIOTA
mkdMacedonian denar
mkrMaker
mmkMyanmar Kyat
mntMongolian tugrik
mopMacanese pataca
mroMauritanian ouguiya
murMauritian rupee
mvrMaldivian rufiyaa
mwkMalawian kwacha
mxnMexican peso
myrMalaysian ringgit
mznMozambican Metical
nadNamibian dollar
nearNEAR Protocol
neoNEO
nexoNEXO
ngnNigerian naira
nioNicaraguan córdoba
nokNorwegian krone
nprNepalese rupee
nzdNew Zealand dollar
okbOkex
omrOmani rial
oneMenlo One
pabPanamanian balboa
paxgPAX Gold
penSol
pgkPapua New Guinean kina
phpPhilippine peso
pkrPakistani rupee
plnPoland złoty
pygParaguayan guarani
qarQatari Rial
qntQuant
qtumQTUM
ronRomanian leu
rsdSerbian dinar
rubRussian ruble
runeTHORChain (ERC20)
rwfRwandan Franc
sandBeachCoin
sarSaudi riyal
sbdSolomon Islands dollar
scrSeychellois rupee
sdgSudanese pound
sekSwedish krona
sgdSingapore dollar
shibShiba Inu
shpSaint Helena pound
sle
sllSierra Leonean leone
solSola
sosSomali shilling
srdSurinamese dollar
stdSão Tomé and Príncipe Dobra (pre-2018)
stxStox
svcSalvadoran Colón
sypSyrian pound
szlSwazi lilangeni
thbThai baht
thetaTheta
tjsTajikistani somoni
tmtTurkmenistani manat
tndTunisian dinar
topTongan Paʻanga
trxTRON
tryTurkish lira
ttdTrinidad & Tobago Dollar
tttTap Project
tusdTrue USD
twdNew Taiwan dollar
tzsTanzanian shilling
uahUkrainian hryvnia
ugxUgandan shilling
uniUniverse
usdUnited States dollar
usdcUSD Coin
usdpUSDP Stablecoin
usdtTether
uyuUruguayan peso
uzsUzbekistani som
vefSovereign Bolivar
vetVechain
vndVietnamese dong
vuvVanuatu vatu
wavesWaves
wbtcWrapped Bitcoin
wemixWEMIX
wstSamoan tala
xafCentral African CFA franc
xagSilver Ounce
xauXauCoin
xcdEast Caribbean dollar
xchChia
xdcXDC Network
xdrSpecial Drawing Rights
xecEternal Coin
xemNEM
xlmStellar
xmrMonero
xofWest African CFA franc
xpfCFP franc
xrpXRP
xtzTezos
yerYemeni rial
zarSouth African rand
zecZCash
zilZilliqa
zmkZambian kwacha
zmwZambian Kwacha
zwlZimbabwean Dollar

Authentication

All API requests to ApyHub services need to be authenticated. Currently we support tokens or basic authentication mechanisms. You can generate and view your existing credentials from your workspace settings (on the left side of the navbar) and go to “API Keys".
Points to note:
  • Credential secrets are generated on the fly and are not stored in plain text, so on generating a credential please save the secrets somewhere safe.
  • Use the apy-token as the header parameter to pass the token.
  • Use the Authorization header to send the basic authentication credentials.

Error codes

1
{
2
"error": {
3
"code": 105,
4
"message": "Invalid URL"
5
}
6
}
To search for a specific error code, enter the code in the search box below. Alternatively, you can click on the button to view a complete list of all error codes.