NewConnect Claude, Cursor, ChatGPT, and other AI agents to API Ninjas via our MCP server →

Currency Conversion API

Note: This API converts between fiat currencies. For crypto-to-fiat conversions, use the Crypto Price API instead.

Supported Currencies ▶
(4.4)

From 5,079 users

2,800+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
216ms242ms313ms599ms1032ms

Didn't find what you were looking for? Suggest an improvement

/v1/convertcurrency GET

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

Converts an existing currency and amount into a new currency. This API is not suitable for live trading or high-frequency trading.

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.

Response

A JSON object with the following fields or an error if the request is unsuccessful.

  • old_amount

    The original amount to convert (e.g. 5000).

  • old_currency

    The original currency code (e.g. GBP).

  • new_amount

    The converted amount in the new currency (e.g. 9559.32).

  • new_currency

    The new currency code (e.g. AUD).

  • timestamp

    Unix timestamp (in seconds) indicating the time at which the exchange rate used for the conversion was applied.

Sample Request Live Demo!

have
want
amount

Try this API endpoint with all available parameters in our API playground

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

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/convertcurrency?have=GBP&want=AUD&amount=5000" \ -H "X-Api-Key: YOUR_API_KEY"

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.