Convert Currency
50 atoms
Base tier
About
This Utility API allows you to convert currencies from a source currency to a target currency.
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
Documentation
convert currency
POST
https://api.apyhub.com/data/convert/currencyRequest example
Method:
POSTContent Type:
application/jsonRequest Body
| Attribute | Type | Mandatory | Description |
|---|---|---|---|
| source | String | Yes | The source currency |
| target | String | Yes | The target currency |
| date | String | No | The date in yyyy-mm-dd, defaults to today, if not provided |
Response
| Attribute | Type | Description |
|---|---|---|
| data | Decimal | A decimal value that returns the daily exchange rate for the source - target currency |
Sample Response
Returns a
Decimal value for the given amountHTTP 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 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 workspace settings (on the left side of the navbar) and go to applications.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-tokenas the header parameter to pass the token. - Use the
Authorizationheader to send the basic authentication credentials.
Error codes
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.