Currency API Documentation

  1. Getting Started
  2. Where do I get my API Key?
  3. Responses
  4. What is the current API Version?
  5. What is the CompleteAPI.com Currency Service?
  6. Which currencies are supported?
  7. Upcoming Features
  8. How much does it cost?

1. Getting Started

To call the API, you simply open the following URL:

https://www.completeapi.com/v1/[API_KEY]/currency

The default base currency is US Dollar (USD). To change this, you can specify the base currency as follows:

https://www.completeapi.com/v1/[API_KEY]/currency/[BASE_CURRENCY]

2. Where do I get my API Key?

Grab it here.

3. Responses

Example of a Successful Response

{
  api: "CompleteAPI.com Version 1.0",
  success: true,
  currencies: {
    ZAR_ZAR: "1.0000000000",
    ZAR_USD: 0.0750457553970656,
    ZAR_EUR: "0.0647922538",
    ZAR_NAD: "1.0000000000",
    ZAR_GBP: "0.0577229437",
    ZAR_JPY: "8.3499689761",
    ZAR_SEK: "0.6689206409",
    ZAR_XBT: "0.0000107575",
    EUR_ZAR: "15.4339437410",
    NAD_ZAR: "1.0000000000",
    GBP_ZAR: "17.3241338002",
    JPY_ZAR: "0.1197609240",
    SEK_ZAR: "1.4949456465",
    XBT_ZAR: "92958.4011155008"
  }
}

Example of an Unsuccessful Response

{
  api: "CompleteAPI.com Version 1.0",
  success: false,
  currencies: [ ],
  errorMessage: "You did not specify a valid base currency."
}

4. What is the current API Version?

Current version is: Version 1.0.

Although we have implemented it for various of our own and client websites, the Currency API has not been publicly accessible until the launch of CompleteAPI.com.

5. What is the CompleteAPI.com Currency Service?

Our SMS Service offers you a way to send SMSs to single or multiple users. This can be done online via the provided user interface, or alternatively, programatically using the SMS API. The SMS API allows you to build SMS capabilities into just about any application, while the Online User Interface makes it easy for you to review sent messages and also manage contact lists.

6. Which currencies are supported?

We currently support:

Code Name Place
USD US Dollar United States of America
ZAR South African Rand South Africa
NAD Namibian Dollar Namibia
EUR Euro Europe
GBP British Pound United Kingdom
JPY Japanese Yen Japan
SEK Swedish Krone Sweden
XBT Bitcoin Global

7. Upcoming Features

We ultimately hope to support every single currency in the world with one single call and that will be our first priority. Following that, we also hope to add:

  • Historical data: See what exchange rates were at any point in time
  • Graphs: Instantly generate a graph for various currency pairs
  • Currency Widget: For those seeking to easily add a currency converter to their website.

8. How much does it cost?

The currency API is currently FREE and is likely to remain free for basic queries. The only limits we might impose are rate limits. Try not to query the API more than necessary. Hard limits are in place so you will get blocked if you do more than 1 query a second.

Copyright © Namhost Internet Services (Pty) Ltd | Privacy Policy | Terms of Use