Currency Conversion API

The Currency Conversion API allows you to convert pairs of currencies. Choose from over 100 different currencies.

Most popular currency pairs: USD/EUR, USD/GBP, USD/CAD



/v1/convertcurrency GET

https://api.api-ninjas.com/v1/convertcurrency

Converts an existing currency and amount into a new currency.


Parameters

  • have  required

    Currency you currently hold. Must be 3-character currency code (e.g. USD).

  • want  required

    Currency you want to convert to. Must be 3-character currency code (e.g. USD).

  • amount  required

    Amount of currency to convert.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Sample Request Live Demo!

have
want
amount
https://api.api-ninjas.com/v1/convertcurrency?have=GBP&want=AUD&amount=5000

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
1 2 3 4 5 6 { "old_amount": 5000, "old_currency": "GBP", "new_currency": "AUD", "new_amount": 9559.32 }

Code Examples

1 2 3 4 5 6 7 8 9 10 11 import requests have = 'GBP' want = 'AUD' amount = '5000' api_url = 'https://api.api-ninjas.com/v1/convertcurrency?have={}&want={}&amount={}'.format(have, want, amount) response = requests.get(api_url, headers={'X-Api-Key': 'YOUR_API_KEY'}) if response.status_code == requests.codes.ok: print(response.text) else: print("Error:", response.status_code, response.text)

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.