Please wait...

Foreign Exchange Rates

By: Qymera


Manage finances better by integrating with Qymera’s Foreign Exchange API. Know accurate and instant currency conversion rates for over 100 world currencies.



Overview

  • Access current weather data for any location including over 200,000 cities
  • Current weather is frequently updated based on global models and data from more than 40,000 weather stations
  • Data is available in JSON, XML, or HTML format USING THE API We built the API to be as self-documenting as possible, but if you find yourself overwhelmed, we organized this site into four major areas.
  • Getting started introduces you to the operations offered by the API.
  • API calls gives you a hands-on experience of those operations with an interactive console.
  • Field reference lists and describes the type of information provided by the API.
  • Frequently Asked Questions (FAQ) Here are answers to some frequently asked questions.
  • Contact Us If you need support or need to get in touch, this is the place to look. ---

Getting Started

The current version of the API lives at https://gateway.qymera.tech/qymera/sb/rates/v1/.

  • https://gateway.qymera.tech/qymera/sb/rates/v1/date?start=REPLACE_THIS_VALUE
  • https://gateway.qymera.tech/qymera/sb/rates/v1/
  • https://gateway.qymera.tech/qymera/sb/rates/v1/latest-symbol?symbol=REPLACE_THIS_VALUE
  • https://gateway.qymera.tech/qymera/sb/rates/v1/latest-base?base=REPLACE_THIS_VALUE
  • 'https://gateway.qymera.tech/qymera/sb/rates/v1/latest-base-symbol?base=REPLACE_THIS_VALUE&symbol=REPLACE_THIS_VALUE
  • https://gateway.qymera.tech/qymera/sb/rates/v1/date-symbol?start=REPLACE_THIS_VALUE&symbol=REPLACE_THIS_VALUE
  • https://gateway.qymera.tech/qymera/sb/rates/v1/date-base?start=REPLACE_THIS_VALUE&base=REPLACE_THIS_VALUE
  • https://gateway.qymera.tech/qymera/sb/rates/v1/date-base-symbol?start=REPLACE_THIS_VALUE&base=REPLACE_THIS_VALUE&symbol=REPLACE_THIS_VALUE
Endpoints
Endpoint What it does
/ Get the latest foreign exchange reference rates.
/date Get historical rates for any day since 1999.
/latest-symbol Request specific exchange rates by setting the symbols parameter.
/latest-base Rates are quoted against the Euro by default. Quote against a different currency by setting the base parameter in your request.
/latest-base-symbol Request specific exchange rates by setting the base parameter and symbols parameter in your request.
/date-symbol Request specific exchange rates by setting the symbols parameter.
/date-base Rates are quoted against the Euro by default. Quote against a different currency by setting the base parameter in your request.
/date-base-symbol Request specific exchange rates by setting the base parameter and symbols parameter in your request.

API Calls

Headers
Key Value Description
accept application/json
x-ibm-client-id Use the given application credential id
x-ibm-client-secret Use the given application credential secret
/
Implementation Notes

Get the latest foreign exchange reference rates.

Sample Request:
curl --request GET \
  --url 'https://gateway.qymera.tech/qymera/sb/rates/v1/' \
  --header 'accept: application/json' \
  --header 'x-ibm-client-id: REPLACE_THIS_VALUE' \
  --header 'x-ibm-client-secret: REPLACE_THIS_VALUE'
Request

GET

https://gateway.qymera.tech/qymera/sb/rates/v1/

Response:

200

{
    "message": "Success.",
    "data": {
        "base": "EUR",
        "rates": {
            "GBP": 0.88573,
            "HKD": 8.5368,
            "IDR": 15456.94,
            "ILS": 3.7877,
            "DKK": 7.4662,
            "INR": 77.1615,
            "CHF": 1.0847,
            "MXN": 21.4522,
            "CZK": 25.816,
            "SGD": 1.506,
            "THB": 33.315,
            "HRK": 7.411,
            "MYR": 4.5592,
            "NOK": 9.8953,
            "CNY": 7.7784,
            "BGN": 1.9558,
            "PHP": 56.553,
            "SEK": 10.6958,
            "PLN": 4.3782,
            "ZAR": 16.5576,
            "CAD": 1.4426,
            "ISK": 135.1,
            "BRL": 4.5288,
            "RON": 4.7496,
            "NZD": 1.7375,
            "TRY": 6.1491,
            "JPY": 117.59,
            "RUB": 70.7557,
            "KRW": 1304.83,
            "USD": 1.0889,
            "HUF": 334.83,
            "AUD": 1.6126
        },
        "date": "2019-09-30"
    }
}

404

{
  "code": -15,
  "message": "Something went wrong to rate service."
}
/date
Implementation Notes

Get historical rates for any day since 1999.

Parameters:
Parameter Data Type Necessity Location Description
start string required query from 1999 to date
Sample Request:
curl --request GET \
  --url 'https://gateway.qymera.tech/qymera/sb/rates/v1/date?start=REPLACE_THIS_VALUE' \
  --header 'accept: application/json' \
  --header 'x-ibm-client-id: REPLACE_THIS_VALUE' \
  --header 'x-ibm-client-secret: REPLACE_THIS_VALUE'
Request

GET

https://gateway.qymera.tech/qymera/sb/rates/v1/date?start=2010-01-12

Response:

200

{
    "message": "Success.",
    "data": {
        "base": "EUR",
        "rates": {
            "GBP": 0.8972,
            "HKD": 11.2301,
            "IDR": 13281.14,
            "PLN": 4.0838,
            "DKK": 7.4405,
            "LVL": 0.7093,
            "INR": 66.21,
            "CHF": 1.4743,
            "MXN": 18.4995,
            "CZK": 26.258,
            "SGD": 2.0133,
            "THB": 47.839,
            "BGN": 1.9558,
            "MYR": 4.8424,
            "NOK": 8.1825,
            "CNY": 9.8863,
            "HRK": 7.2753,
            "PHP": 66.106,
            "SEK": 10.2215,
            "LTL": 3.4528,
            "ZAR": 10.8264,
            "CAD": 1.4959,
            "BRL": 2.5309,
            "RON": 4.1405,
            "EEK": 15.6466,
            "NZD": 1.9573,
            "TRY": 2.1084,
            "JPY": 132.41,
            "RUB": 42.6974,
            "KRW": 1627.4,
            "USD": 1.4481,
            "HUF": 268.18,
            "AUD": 1.5668
        },
        "date": "2010-01-12"
    }
}

404

{
  "code": -15,
  "message": "Something went wrong to rate service."
}
/latest-symbol
Implementation Notes

Request specific exchange rates by setting the symbols parameter.

Parameters:
Parameter Data Type Necessity Location Description
symbol string required query currency symbol
Sample Request:
curl --request GET \
  --url 'https://gateway.qymera.tech/qymera/sb/rates/v1/latest-symbol?symbol=REPLACE_THIS_VALUE' \
  --header 'accept: application/json' \
  --header 'x-ibm-client-id: REPLACE_THIS_VALUE' \
  --header 'x-ibm-client-secret: REPLACE_THIS_VALUE'
Request

GET

https://gateway.qymera.tech/qymera/sb/rates/v1/latest-symbol?symbol=USD,GBP

Response:

200

{
    "message": "Success.",
    "data": {
        "base": "EUR",
        "rates": {
            "USD": 1.0889,
            "GBP": 0.88573
        },
        "date": "2019-09-30"
    }
}

404

{
  "code": -15,
  "message": "Something went wrong to rate service."
}
/latest-base
Implementation Notes

Rates are quoted against the Euro by default. Quote against a different currency by setting the base parameter in your request.

Parameters:
Parameter Data Type Necessity Location Description
base string required query currency symbol to compare to
Sample Request:
curl --request GET \
  --url 'https://gateway.qymera.tech/qymera/sb/rates/v1/latest-base?base=REPLACE_THIS_VALUE' \
  --header 'accept: application/json' \
  --header 'x-ibm-client-id: REPLACE_THIS_VALUE \
  --header 'x-ibm-client-secret: REPLACE_THIS_VALUE'
Request

GET

https://gateway.qymera.tech/qymera/sb/rates/v1/latest-base?base=USD

Response:

200

{
    "message": "Success.",
    "data": {
        "base": "USD",
        "rates": {
            "GBP": 0.81341721,
            "HKD": 7.839838369,
            "IDR": 14195.0041326109,
            "ILS": 3.4784645055,
            "DKK": 6.85664432,
            "INR": 70.8618789604,
            "CHF": 0.9961428965,
            "MXN": 19.7007989714,
            "CZK": 23.7083295068,
            "SGD": 1.3830471118,
            "THB": 30.5950959684,
            "HRK": 6.8059509597,
            "EUR": 0.9183579759,
            "MYR": 4.1869776839,
            "NOK": 9.0874276793,
            "CNY": 7.14335568,
            "BGN": 1.7961245293,
            "PHP": 51.9358986133,
            "PLN": 4.0207548903,
            "ZAR": 15.2058040224,
            "CAD": 1.3248232161,
            "ISK": 124.0701625494,
            "BRL": 4.1590596014,
            "RON": 4.3618330425,
            "NZD": 1.5956469832,
            "TRY": 5.6470750298,
            "JPY": 107.9897143907,
            "RUB": 64.9790614381,
            "KRW": 1198.3010377445,
            "USD": 1,
            "AUD": 1.480944072,
            "HUF": 307.4938010837,
            "SEK": 9.822573239
        },
        "date": "2019-09-30"
    }
}

404

{
  "code": -15,
  "message": "Something went wrong to rate service."
}
/latest-base-symbol
Implementation Notes:

Request specific exchange rates by setting the base parameter and symbols parameter in your request

Parameters:
Parameter Data Type Necessity Location Description
symbol string required query currency symbol
base string required query currency base
Sample Request:
curl --request GET \
  --url 'https://gateway.qymera.tech/qymera/sb/rates/v1/latest-base-symbol?base=REPLACE_THIS_VALUE&symbol=REPLACE_THIS_VALUE' \
  --header 'accept: application/json' \
  --header 'x-ibm-client-id: REPLACE_THIS_PLACE' \
  --header 'x-ibm-client-secret: REPLACE_THIS_PLACE'
Request

GET

GET https://gateway.qymera.tech/qymera/sb/rates/v1/latest-base-symbol?base=USD&symbol=GBP

Response:

200

{
    "message": "Success.",
    "data": {
        "base": "USD",
        "rates": {
            "GBP": 0.81341721
        },
        "date": "2019-09-30"
    }
}

404

{
  "code": -15,
  "message": "Something went wrong to rate service."
}
/date-symbol
Implementation Notes

Request specific exchange rates by setting the symbols parameter.

Parameters:
Parameter Data Type Necessity Location Description
date string required query date
symbol string required query currency symbol
Sample Request
curl --request GET \
  --url 'https://gateway.qymera.tech/qymera/sb/rates/v1/date-symbol?start=REPLACE_THIS_VALUE&symbol=REPLACE_THIS_VALUE' \
  --header 'accept: application/json' \
  --header 'x-ibm-client-id: REPLACE_THIS_VALUE' \
  --header 'x-ibm-client-secret: REPLACE_THIS_VALUE'
Request

GET

GET https://gateway.qymera.tech/qymera/sb/rates/v1/date-symbol?start=REPLACE_THIS_VALUE&symbol=REPLACE_THIS_VALUE

Response:
{
    "message": "Success.",
    "data": {
        "base": "EUR",
        "rates": {
            "GBP": 0.8972,
            "USD": 1.4481
        },
        "date": "2010-01-12"
    }
}

404

{
  "code": -15,
  "message": "Something went wrong to rate service."
}
/date-base

Implementation Notes Rates are quoted against the Euro by default. Quote against a different currency by setting the base parameter in your request.

Parameters:
Parameter Data Type Necessity Location Description
date string required query date
base string required query currency base
Sample Request:
curl --request GET \
  --url 'https://gateway.qymera.tech/qymera/sb/rates/v1/date-base?start=REPLACE_THIS_VALUE&base=REPLACE_THIS_VALUE' \
  --header 'accept: application/json' \
  --header 'x-ibm-client-id: REPLACE_THIS_VALUE' \
  --header 'x-ibm-client-secret: REPLACE_THIS_VALUE'
Request

GET

https://gateway.qymera.tech/qymera/sb/rates/v1/date-base?start=2010-01-12&base=USD

Response

200

{
    "message": "Success.",
    "data": {
        "base": "USD",
        "rates": {
            "GBP": 0.6195704717,
            "HKD": 7.7550583523,
            "IDR": 9171.4246253712,
            "PHP": 45.6501622816,
            "LVL": 0.4898142393,
            "INR": 45.7219805262,
            "CHF": 1.0180926732,
            "MXN": 12.7750155376,
            "SGD": 1.390304537,
            "CZK": 18.1327256405,
            "THB": 33.0357019543,
            "BGN": 1.3505973344,
            "EUR": 0.6905600442,
            "MYR": 3.343967958,
            "NOK": 5.6505075616,
            "CNY": 6.8270837649,
            "HRK": 5.0240314895,
            "PLN": 2.8201091085,
            "LTL": 2.3843657206,
            "TRY": 1.4559767972,
            "ZAR": 7.4762792625,
            "CAD": 1.0330087701,
            "BRL": 1.7477384159,
            "RON": 2.859263863,
            "DKK": 5.1381120088,
            "NZD": 1.3516331745,
            "EEK": 10.8049167875,
            "JPY": 91.437055452,
            "RUB": 29.485118431,
            "KRW": 1123.8174159243,
            "USD": 1,
            "AUD": 1.0819694772,
            "HUF": 185.1943926524,
            "SEK": 7.0585594917
        },
        "date": "2010-01-12"
    }
}

404

{
  "code": -15,
  "message": "Something went wrong to rate service."
}
/date-base-symbol
Implementation Notes

Request specific exchange rates by setting the base parameter and symbols parameter in your request.

Parameters:
Parameter Data Type Necessity Location Description
date string required query date
base string required query currency base
symbol string required query currency symbol
Sample Request:
curl --request GET \
  --url 'https://gateway.qymera.tech/qymera/sb/rates/v1/date-base-symbol?start=REPLACE_THIS_VALUE&base=REPLACE_THIS_VALUE&symbol=REPLACE_THIS_VALUE' \
  --header 'accept: application/json' \
  --header 'x-ibm-client-id: REPLACE_THIS_VALUE' \
  --header 'x-ibm-client-secret: REPLACE_THIS_VALUE'
Request

GET

https://gateway.qymera.tech/qymera/sb/rates/v1/date-base-symbol?start=2010-01-12&base=USD&symbol=GBP

Response:

200

{
    "message": "Success.",
    "data": {
        "base": "USD",
        "rates": {
            "GBP": 0.6195704717
        },
        "date": "2010-01-12"
    }
}

404

{
  "code": -15,
  "message": "Something went wrong to rate service."
}