Global Historical Exchange Rates API

API ID 5262

Access historical exchange rate data, perform trend analysis, and retrieve currency symbol details with this versatile financial API.

100% uptime 423 ms avg response

API Documentation

Endpoints

Request

Make a GET request to the endpoint to get a complete list of all currencies and symbols supported by the API.

Endpoint ID: 6779
GET https://zylalabs.com/api/5262/global+historical+exchange+rates+api/6779/supported+symbols
INPUT PARAMETERS

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

This endpoint does not require any input parameters.

API EXAMPLE RESPONSE
JSON
{"000001":"SSE Composite","AORD":"ALL ORDINARIES","AXJO":"S&P\/ASX 200","BFX":"BEL 20","BSESN":"S&P BSE SENSEX","BUK100P":"Cboe UK 100","BVSP":"IBOVESPA","CAD":"Canadian Dollar","CLP":"Chilean Peso","CNY":"Chinese Renminbi Yuan","DJI":"Dow Jones Industrial Average","DX-Y":"US Dollar","EGP":"Egyptian Pound","EGX-30":"EGX 30","EUR":"Euro","FCHI":"CAC 40","FTSE":"FTSE 100","GBP":"British Pound","GDAXI":"DAX Performance","GSPC":"S&P 500","GSPTSE":"S&P\/TSX Composite","HSI":"HANG SENG","IPSA":"S&P IPSA","IXIC":"NASDAQ Composite","JKSE":"IDX COMPOSITE","JN0U":"Top 40 USD Net TRI","KLSE":"FTSE Bursa Malaysia KLCI","KRW":"South Korean Won","KS11":"KOSPI Composite","MERV":"MERVAL","MOEX-ME":"Public Joint-Stock Company Moscow Exchange MICEX-RTS","MSCI-EU":"MSCI EUROPE","MXN":"Mexican Peso","MXX":"IPC Mexico","N100":"Euronext 100","N225":"Nikkei 225","NYA":" NYSE Composite","NZ50":"S&P\/NZX 50","RUB":"Russian Ruble","RUT":"Russell 2000","STI":"STI","STOXX50E":"EURO STOXX 50","TA125":"TA-125","TWII":"TSEC Weighted","USD":"United States Dollar","VIX":"CBOE Volatility","XAX":"NYSE AMEX Composite","XDA":"Australian Dollar Currency","XDB":"British Pound Currency","XDE":"Euro Currency","XDN":"Japanese Yen Currency"}
Supported Symbols — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/5262/global+historical+exchange+rates+api/6779/supported+symbols' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request

Time Series endpoint lets you query the API for daily historical rates between two dates of your choice. (The date limits per API request depends on the acquired plan).

You can not use the current date on the parameter "end_date". We recommend using a day prior to the current date in order to get a successful response. To get the last price you will have to use the latest endpoint.

Endpoint ID: 6780
GET https://zylalabs.com/api/5262/global+historical+exchange+rates+api/6780/time+series
INPUT PARAMETERS

Time Series — Endpoint Features

Object Description
start_date Required The start date of your preferred timeframe. (The date limits per API request depends on the acquired plan)
end_date Required The end date of your preferred timeframe. (The date limits per API request depends on the acquired plan)
symbols Required Enter one currency or indices codes to limit the output.
base Optional Enter the three-letter currency code or commodity code of your preferred base currency. Default USD.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

start_date
end_date
symbols
base
API EXAMPLE RESPONSE
JSON
{"data":{"success":true,"timeseries":true,"start_date":"2024-10-04","end_date":"2024-10-09","base":"USD","rates":{"2024-10-04":{"NYA":5.1579147169749e-5,"USD":1},"2024-10-05":{"NYA":5.1180530107459e-5,"USD":1},"2024-10-06":{"NYA":5.1180530107459e-5,"USD":1},"2024-10-07":{"NYA":5.1180530107459e-5,"USD":1},"2024-10-08":{"NYA":5.146071231918e-5,"USD":1},"2024-10-09":{"NYA":5.1453483735297e-5,"USD":1}},"unit":{}}}
Time Series — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/5262/global+historical+exchange+rates+api/6780/time+series?start_date=2024-10-04&end_date=2024-10-09&symbols=NYA' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request

Retrieves historical exchange rates for a specific currency by providing a date in the format YYYYY-MM-DD.

Endpoint ID: 6781
GET https://zylalabs.com/api/5262/global+historical+exchange+rates+api/6781/historical+rates
INPUT PARAMETERS

Historical Rates — Endpoint Features

Object Description
base Required Enter the three-letter currency code or commodity code of your preferred base currency. Default USD.
symbols Required Enter a list of comma-separated currency codes or indices codes to limit output codes. (The number of symbols per API request depends on the acquired plan).
date Required

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

base
symbols
API EXAMPLE RESPONSE
JSON
{"data":{"success":true,"historical":true,"date":"2024-10-04","base":"usd","rates":{"NYA":5.1180530107459e-5,"USD":1},"unit":{}}}
Historical Rates — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/5262/global+historical+exchange+rates+api/6781/historical+rates?base=usd&symbols=NYA&date=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    

API Access Key & Authentication

After signing up, every developer is assigned a personal API access key, a unique combination of letters and digits provided to access to our API endpoint. To authenticate with the Global Historical Exchange Rates API simply include your bearer token in the Authorization header.

Headers
Header Description
Authorization Required Should be Bearer access_key. See "Your API Access Key" above when you are subscribed.

No long-term commitment. Upgrade, downgrade, or cancel anytime. Free Trial includes up to 50 requests.

(Save 2 months with annual billing 🎉)

🚀 Enterprise Plan

Starts at
$ 10,000/Year


  • Custom Volume
  • Custom Rate Limit
  • Specialized Customer Support
  • Real-Time API Monitoring

Overview

About the API: 

The Global Historical Exchange Rates API is a powerful resource for obtaining historical exchange rates and performing detailed trend analysis. Users can access a vast range of time series data and retrieve detailed information on supported currency symbols. With the ability to specify dates for historical rates and retrieve exchange data over multiple time periods, this API is ideal for investors, financial analysts, and market researchers. Whether it’s for understanding market shifts, performing comparative studies, or tracking long-term trends, this API provides reliable data in a simple-to-use JSON format. It is perfect for integrating into financial platforms, trading tools, and data analytics systems, offering a critical resource for global financial analysis.

Global Historical Exchange Rates API FAQs

Perform GET requests with date and symbol parameters to receive historical rates, available symbols or time series.

Global Historical Exchange Rates is an API designed to query historical currency data, including time series and symbols available for detailed financial analysis.

It receives dates and currency symbols as input parameters, and returns historical rates, available symbols and time series data in JSON format.

Analysis of historical currency trends for trading platforms. Time series study to identify currency fluctuations. Historical data retrieval for financial reporting and investment strategies.

Beside the number of API calls per month allowed, there are no other limitations.

There are different plans suits everyone including a free trial for small amount of requests, but it’s rate is limit to prevent abuse of the service.

The API uses API keys for authentication. To access the API, include your API key in the request header. The API key is provided upon registration and should be kept secure.

The API returns detailed information about the age and history of a domain, including years, months and days since its creation, as well as expiration and update dates.

The Time Series endpoint returns daily historical exchange rates between two specified dates. The response includes the base currency, date range, and a nested structure of rates for each date, allowing users to analyze trends over time.

The Historical Rates response includes fields such as "success" (indicating the request status), "date" (the queried date), "base" (the base currency), and "rates" (an object containing exchange rates for various currencies).

Users can customize requests by specifying the "start_date" and "end_date" parameters to define the date range for historical rates. Additionally, they can choose the base currency to retrieve rates against it.

The Supported Symbols endpoint provides a comprehensive list of all currencies and their corresponding symbols supported by the API, enabling users to identify available currencies for their queries.

The response data is organized in a JSON format, with a "data" object containing "success," "timeseries," "start_date," "end_date," "base," and a "rates" object that lists exchange rates by date.

The API sources its exchange rate data from reliable financial institutions and market feeds, ensuring that users receive accurate and up-to-date historical exchange rates for their analysis.

Users can analyze the time series data to identify trends, fluctuations, and patterns in currency exchange rates over the specified period, aiding in investment decisions and financial reporting.

Typical use cases include verifying available currencies for transactions, integrating currency symbols into financial applications, and conducting comparative analyses of different currencies in market research.

General FAQs

To obtain your API key, first sign in to your account and navigate to the API you want to use. From the API's Pricing section, choose a plan and complete the subscription process. Once subscribed, return to the API page and you will see your API Access Key displayed at the top of the documentation page. You can use this key to authenticate your requests.

You can’t switch APIs during the free trial. If you subscribe to a different API, your trial will end and the new subscription will start as a paid plan.

The free trial lasts for 7 days and allows you to make up to 50 API requests.

No, the free trial is available only once, so we recommend using it on the API that interests you the most. Most of our APIs offer a free trial, but some may not include this option.

Yes. If the API offers a free trial, you will see a "Free 7-Day Trial" option in its Pricing section. The trial lasts for 7 days and allows up to 50 API requests, enabling you to evaluate the API before subscribing to a paid plan.

Zyla API Hub is like a big store for APIs, where you can find thousands of them all in one place. We also offer dedicated support and real-time monitoring of all APIs. Once you sign up, you can pick and choose which APIs you want to use. Just remember, each API needs its own subscription. But if you subscribe to multiple ones, you'll use the same key for all of them, making things easier for you.

Prices are listed in USD (United States Dollar), EUR (Euro), CAD (Canadian Dollar), AUD (Australian Dollar), and GBP (British Pound). We accept all major debit and credit cards. Our payment system uses the latest security technology and is powered by Stripe, one of the world's most reliable payment companies. If you have any trouble paying by card, just contact us at [email protected]

Additionally, if you already have an active subscription in any of these currencies (USD, EUR, CAD, AUD, GBP), that currency will remain for subsequent subscriptions. You can change the currency at any time as long as you don't have any active subscriptions.
The local currency shown on the pricing page is based on the country of your IP address and is provided for reference only. The actual prices are in USD (United States Dollar). When you make a payment, the charge will appear on your card statement in USD, even if you see the equivalent amount in your local currency on our website. This means you cannot pay directly with your local currency.
Occasionally, a bank may decline the charge due to its fraud protection settings. We suggest reaching out to your bank initially to check if they are blocking our charges. Also, you can access the Billing Portal and change the card associated to make the payment. If these does not work and you need further assistance, please contact our team at [email protected]
Prices are determined by a recurring monthly or yearly subscription, depending on the chosen plan.
API calls are deducted from your plan based on successful requests. Each plan comes with a specific number of calls that you can make per month. Only successful calls, indicated by a Status 200 response, will be counted against your total. This ensures that failed or incomplete requests do not impact your monthly quota.
Zyla API Hub works on a recurring monthly subscription system. Your billing cycle will start the day you purchase one of the paid plans, and it will renew the same day of the next month. So be aware to cancel your subscription beforehand if you want to avoid future charges.
To upgrade your current subscription plan, simply go to the pricing page of the API and select the plan you want to upgrade to. The upgrade will be instant, allowing you to immediately enjoy the features of the new plan. Please note that any remaining calls from your previous plan will not be carried over to the new plan, so be aware of this when upgrading. You will be charged the full amount of the new plan.
To check how many API calls you have left for the current month, refer to the 'X-Zyla-API-Calls-Monthly-Remaining' field in the response header. For example, if your plan allows 1,000 requests per month and you've used 100, this field in the response header will indicate 900 remaining calls.

You can monitor your API usage through the response headers included with every request:

x-zyla-api-calls-monthly-used: Shows the total number of API requests you have used during the current billing period.
x-zyla-api-calls-monthly-remaining: Shows the number of API requests you have remaining for the current billing period.

The 'X-Zyla-RateLimit-Reset' header shows the number of seconds until your rate limit resets. This tells you when your request count will start fresh. For example, if it displays 3,600, it means 3,600 seconds are left until the limit resets.

Yes, you can cancel your subscription at any time. Simply go to the Pricing section of the API you're subscribed to and click the "Unsubscribe" button.

Please note that upgrades, downgrades, and cancellations take effect immediately. Once your subscription is canceled, access to the service will end immediately, regardless of any remaining API calls in your quota.

After 7 days, you will be charged the full amount for the plan you were subscribed to during the trial. Therefore, it's important to cancel before the trial period ends. Refund requests for forgetting to cancel on time are not accepted.
When you subscribe to an API free trial, you can make up to 50 API calls. If you wish to make additional API calls beyond this limit, the API will prompt you to perform an "Start Your Paid Plan." You can find the "Start Your Paid Plan" button in your profile under Subscription -> Choose the API you are subscribed to -> Pricing tab.
You can contact us through our chat channel to receive immediate assistance. We are always online from 8 am to 5 pm (EST). If you reach us after that time, we will get back to you as soon as possible. Additionally, you can contact us via email at [email protected]

Please have a look at our Refund Policy: https://zylalabs.com/terms#refund


Related APIs