Currency Conversion API

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



/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

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 import requests api_url = 'https://api.api-ninjas.com/v1/convertcurrency?have=GBP&want=AUD&amount=5000' 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.