Convert Currency to Multiple Currencies API

ApyHub

100 atoms

Base tier

About

This Utility API allows you to convert currencies from a source currency to multiple target currencies. This API can be an ideal tool to help you handle your exchange rate conversions inside your application.

This API supports more than 155+ currencies including the most common cryptocurrencies. The total list can be found in the API documentation below. The currency exchange rates are not real-time but are updated daily. Our API can provide you with both current and historical foreign exchange rates (for up to 2 years).

Some use cases for the currency exchange rates API: Using this API in your application can ensure that financial transactions are accurately recorded and reported, even when they involve different/multiple currencies. This helps to avoid errors and discrepancies in financial reporting among others. Accurate currency conversion based on real exchange rates can provide businesses with greater visibility and control over their finances, especially in a globalized economy where transactions may involve multiple currencies.

Try out the Multiple Currency Converter API in the API playground and see how this free online currency converter API can help you make currency conversions easily, save time, and reduce currency conversion errors through a simple API call.

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

Attribute	Type	Mandatory	Description
source	String	Yes	The source currency
targets	Array	Yes	The array of target currencies in string
date	String	No	The date in yyyy-mm-dd, defaults to today, if not provided

Response

Attribute	Type	Description
source_target	Decimal	Decimal 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 Code	Description
200	The request was successful.
401	Required authentication information is either missing or not valid for the resource.
400	Invalid input - either the date is invalid, source or target currencies are not provided as inputs or not valid currency codes are provided.
500	If any unexpected error occurs while processing the request

Supported Currency Codes

Currency Code	Currency Name
1inch	1inch Network
aave	Aave
ada	Cardano
aed	United Arab Emirates Dirham
afn	Afghan afghani
algo	Algorand
all	Albanian lek
amd	Armenian dram
amp	Synereo
ang	Netherlands Antillean Guilder
aoa	Angolan kwanza
ar	Arweave
ars	Argentine peso
atom	Atomic Coin
aud	Australian dollar
avax	Avalanche
awg	Aruban florin
axs	AXS
azn	Azerbaijani manat
bam	Bosnia-Herzegovina Convertible Mark
bat	Basic Attention Token
bbd	Bajan dollar
bch	Bitcoin Cash
bdt	Bangladeshi taka
bgn	Bulgarian lev
bhd	Bahraini dinar
bif	Burundian Franc
bmd	Bermudan dollar
bnb	Binance Coin
bnd	Brunei dollar
bob	Bolivian boliviano
brl	Brazilian real
bsd	Bahamian dollar
bsv	Bitcoin SV
bsw	Biswap
btc	Bitcoin
btcb	Bitcoin BEP2
btg	Bitcoin Gold
btn	Bhutan currency
busd	Binance USD
bwp	Botswanan Pula
byn	New Belarusian Ruble
byr	Belarusian Ruble
bzd	Belize dollar
cad	Canadian dollar
cake	PancakeSwap
cdf	Congolese franc
celo	Celo
chf	Swiss franc
chz	Chiliz
clf	Chilean Unit of Account (UF)
clp	Chilean peso
cny	Chinese Yuan
comp	Compound Coin
cop	Colombian peso
crc	Costa Rican Colón
cro	Crypto.com Chain Token
crv	Cravy
cuc	Cuban peso
cup	Cuban Peso
cve	Cape Verdean escudo
cvx	Convex Finance
czk	Czech koruna
dai	Dai
dash	Dash
dcr	Decred
dfi	DfiStarter
djf	Djiboutian franc
dkk	Danish krone
doge	Dogecoin
dop	Dominican peso
dot	Dotcoin
dzd	Algerian dinar
egld	Elrond
egp	Egyptian pound
enj	Enjin Coin
eos	EOS
ern	Eritrean nakfa
etb	Ethiopian birr
etc	Ethereum Classic
eth	Ether
eur	Euro
fei	Fei USD
fil	FileCoin
fjd	Fijian dollar
fkp	Falkland Islands pound
flow	Flow
frax	Frax
ftm	Fantom
ftt	FarmaTrust
gala	Gala
gbp	Pound sterling
gel	Georgian lari
ggp	GGPro
ghs	Ghanaian cedi
gip	Gibraltar pound
gmd	Gambian dalasi
gnf	Guinean franc
gno	Gnosis
grt	Golden Ratio Token
gt	GateToken
gtq	Guatemalan quetzal
gyd	Guyanaese Dollar
hbar	Hedera
hkd	Hong Kong dollar
hnl	Honduran lempira
hnt	Helium
hot	Hydro Protocol
hrk	Croatian kuna
ht	Huobi Token
htg	Haitian gourde
huf	Hungarian forint
icp	Internet Computer
idr	Indonesian rupiah
ils	Israeli New Shekel
imp	CoinIMP
inj	Injective
inr	Indian rupee
iqd	Iraqi dinar
irr	Iranian rial
isk	Icelandic króna
jep	Jersey Pound
jmd	Jamaican dollar
jod	Jordanian dinar
jpy	Japanese yen
kava	Kava
kcs	Kucoin
kda	Kadena
kes	Kenyan shilling
kgs	Kyrgystani Som
khr	Cambodian riel
klay	Klaytn
kmf	Comorian franc
knc	Kyber Network
kpw	North Korean won
krw	South Korean won
ksm	Kusama
kwd	Kuwaiti dinar
kyd	Cayman Islands dollar
kzt	Kazakhstani tenge
lak	Laotian Kip
lbp	Lebanese pound
leo	LEOcoin
link	ChainLink
lkr	Sri Lankan rupee
lrc	Loopring
lrd	Liberian dollar
lsl	Lesotho loti
ltc	Litecoin
ltl	Lithuanian litas
luna	Luna Coin
lvl	Latvian lats
lyd	Libyan dinar
mad	Moroccan dirham
mana	Decentraland
matic	Polygon
mdl	Moldovan leu
mga	Malagasy ariary
mina	Mina
miota	IOTA
mkd	Macedonian denar
mkr	Maker
mmk	Myanmar Kyat
mnt	Mongolian tugrik
mop	Macanese pataca
mro	Mauritanian ouguiya
mur	Mauritian rupee
mvr	Maldivian rufiyaa
mwk	Malawian kwacha
mxn	Mexican peso
myr	Malaysian ringgit
mzn	Mozambican Metical
nad	Namibian dollar
near	NEAR Protocol
neo	NEO
nexo	NEXO
ngn	Nigerian naira
nio	Nicaraguan córdoba
nok	Norwegian krone
npr	Nepalese rupee
nzd	New Zealand dollar
okb	Okex
omr	Omani rial
one	Menlo One
pab	Panamanian balboa
paxg	PAX Gold
pen	Sol
pgk	Papua New Guinean kina
php	Philippine peso
pkr	Pakistani rupee
pln	Poland złoty
pyg	Paraguayan guarani
qar	Qatari Rial
qnt	Quant
qtum	QTUM
ron	Romanian leu
rsd	Serbian dinar
rub	Russian ruble
rune	THORChain (ERC20)
rwf	Rwandan Franc
sand	BeachCoin
sar	Saudi riyal
sbd	Solomon Islands dollar
scr	Seychellois rupee
sdg	Sudanese pound
sek	Swedish krona
sgd	Singapore dollar
shib	Shiba Inu
shp	Saint Helena pound
sle
sll	Sierra Leonean leone
sol	Sola
sos	Somali shilling
srd	Surinamese dollar
std	São Tomé and Príncipe Dobra (pre-2018)
stx	Stox
svc	Salvadoran Colón
syp	Syrian pound
szl	Swazi lilangeni
thb	Thai baht
theta	Theta
tjs	Tajikistani somoni
tmt	Turkmenistani manat
tnd	Tunisian dinar
top	Tongan Paʻanga
trx	TRON
try	Turkish lira
ttd	Trinidad & Tobago Dollar
ttt	Tap Project
tusd	True USD
twd	New Taiwan dollar
tzs	Tanzanian shilling
uah	Ukrainian hryvnia
ugx	Ugandan shilling
uni	Universe
usd	United States dollar
usdc	USD Coin
usdp	USDP Stablecoin
usdt	Tether
uyu	Uruguayan peso
uzs	Uzbekistani som
vef	Sovereign Bolivar
vet	Vechain
vnd	Vietnamese dong
vuv	Vanuatu vatu
waves	Waves
wbtc	Wrapped Bitcoin
wemix	WEMIX
wst	Samoan tala
xaf	Central African CFA franc
xag	Silver Ounce
xau	XauCoin
xcd	East Caribbean dollar
xch	Chia
xdc	XDC Network
xdr	Special Drawing Rights
xec	Eternal Coin
xem	NEM
xlm	Stellar
xmr	Monero
xof	West African CFA franc
xpf	CFP franc
xrp	XRP
xtz	Tezos
yer	Yemeni rial
zar	South African rand
zec	ZCash
zil	Zilliqa
zmk	Zambian kwacha
zmw	Zambian Kwacha
zwl	Zimbabwean 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.

Search by code

Table of contents

AboutAPI PlaygroundAPI DocumentationAuthenticationError codesRelated Utility APIsRelated Articles

Convert Currency to Multiple Currencies API

About

API Playground

API Documentation

Request example

HTTP Response Codes

Supported Currency Codes

Authentication

Error codes

101 - Missing parameters

102 - Invalid JSON

103 - Invalid input

104 - Invalid file

105 - Invalid URL

109 - Invalid input format

110 - Server error