Access Real-Time & Historical Tadawul All Shares Historical Trends Using Indices-API

In the fast-paced world of financial markets, having access to real-time and historical data is crucial for making informed decisions. The Indices-API provides developers with the tools necessary to access both real-time and historical Tadawul All Shares index rates. This blog post will guide you through the capabilities of the Indices-API, including detailed instructions on how to utilize its features effectively. By the end of this post, you will have a comprehensive understanding of how to leverage this powerful API for your financial applications.

About Indices-API

The Indices-API is a robust platform designed to provide developers with real-time and historical data for various financial indices. With a focus on innovation and technological advancement, this API empowers developers to build next-generation applications that can analyze market trends, perform currency conversions, and track fluctuations over time. The API is particularly useful for those interested in the Tadawul All Shares index, as it offers extensive data that can be utilized for market analysis and investment strategies.

For more information, you can visit the Indices-API Website or check the Indices-API Documentation for detailed guidance on implementation.

API Description

The Indices-API offers a variety of endpoints that allow developers to access different types of data. These endpoints include:

Latest Rates Endpoint: This endpoint provides real-time exchange rate data, updated at intervals depending on your subscription plan. You can receive updates every 60 minutes, every 10 minutes, or even more frequently.
Historical Rates Endpoint: Access historical rates for most currencies dating back to October 2024. By appending a specific date to your request, you can retrieve past exchange rates.
Convert Endpoint: This feature allows you to convert any amount from one currency to another, facilitating seamless transactions across different currencies.
Time-Series Endpoint: Query the API for daily historical rates between two dates of your choice, enabling you to analyze trends over specific periods.
Fluctuation Endpoint: Retrieve information about how currencies fluctuate on a day-to-day basis, which is essential for understanding market volatility.
Open/High/Low/Close (OHLC) Price Endpoint: Get detailed OHLC data for specific time periods, allowing for in-depth market analysis.
API Key: Your unique API key is required to access the API, ensuring secure and authorized usage.
API Response: The API delivers exchange rates relative to USD by default, providing a consistent reference point for users.
Supported Symbols Endpoint: Access a constantly updated list of all available currencies and indices.

For a complete list of supported symbols, refer to the Indices-API Supported Symbols page.

Key Features and Endpoints

The Indices-API is equipped with several key features that enhance its usability for developers:

Latest Rates Endpoint

This endpoint allows you to retrieve real-time exchange rates for all available indices. The response includes the base currency, the date of the rates, and the rates for various indices. Here’s an example of a typical response:

{
"success": true,
"timestamp": 1783990240,
"base": "USD",
"date": "2026-07-14",
"rates": {
"DOW": 0.00029,
"NASDAQ": 0.00039,
"S&P 500": 0.00024,
"FTSE 100": 0.00058,
"DAX": 0.00448,
"CAC 40": 0.00137,
"NIKKEI 225": 0.0125
},
"unit": "per index"
}

Historical Rates Endpoint

Access historical exchange rates for any date since 1999. This is particularly useful for analyzing past market performance. Here’s an example response:

{
"success": true,
"timestamp": 1783903840,
"base": "USD",
"date": "2026-07-13",
"rates": {
"DOW": 0.00028,
"NASDAQ": 0.00038,
"S&P 500": 0.00023,
"FTSE 100": 0.0124,
"DAX": 0.0126,
"CAC 40": 0.0126,
"NIKKEI 225": 0.0126
},
"unit": "per index"
}

Time-Series Endpoint

The time-series endpoint allows you to query exchange rates for a specific time period. This is beneficial for trend analysis. An example response is as follows:

{
"success": true,
"timeseries": true,
"start_date": "2026-07-07",
"end_date": "2026-07-14",
"base": "USD",
"rates": {
"2026-07-07": {
"DOW": 0.00028,
"NASDAQ": 0.00038,
"S&P 500": 0.00023,
"FTSE 100": 0.0124,
"DAX": 0.0126,
"CAC 40": 0.0126,
"NIKKEI 225": 0.0126
},
"2026-07-09": {
"DOW": 0.00029,
"NASDAQ": 0.00039,
"S&P 500": 0.00024,
"FTSE 100": 0.0124,
"DAX": 0.0126,
"CAC 40": 0.0126,
"NIKKEI 225": 0.0126
},
"2026-07-14": {
"DOW": 0.00029,
"NASDAQ": 0.00039,
"S&P 500": 0.00024,
"FTSE 100": 0.0124,
"DAX": 0.0126,
"CAC 40": 0.0126,
"NIKKEI 225": 0.0126
}
},
"unit": "per index"
}

Convert Endpoint

This endpoint allows for currency conversion, enabling you to convert any amount from one currency to another. Here’s an example response:

{
"success": true,
"query": {
"from": "USD",
"to": "DOW",
"amount": 1000
},
"info": {
"timestamp": 1783990240,
"rate": 0.00029
},
"result": 0.29,
"unit": "per index"
}

Fluctuation Endpoint

Track rate fluctuations between two dates using this endpoint. It provides insights into market volatility. An example response is shown below:

{
"success": true,
"fluctuation": true,
"start_date": "2026-07-07",
"end_date": "2026-07-14",
"base": "USD",
"rates": {
"DOW": {
"start_rate": 0.00028,
"end_rate": 0.00029,
"change": 1.0e-5,
"change_pct": 3.57
},
"NASDAQ": {
"start_rate": 0.00038,
"end_rate": 0.00039,
"change": 1.0e-5,
"change_pct": 2.63
},
"S&P 500": {
"start_rate": 0.0124,
"end_rate": 0.0125,
"change": 0.0001,
"change_pct": 0.81
},
"FTSE 100": {
"start_rate": 0.0124,
"end_rate": 0.0125,
"change": 0.0001,
"change_pct": 0.81
},
"DAX": {
"start_rate": 0.0126,
"end_rate": 0.0126,
"change": 0,
"change_pct": 0
},
"CAC 40": {
"start_rate": 0.0126,
"end_rate": 0.0126,
"change": 0,
"change_pct": 0
},
"NIKKEI 225": {
"start_rate": 0.0126,
"end_rate": 0.0126,
"change": 0,
"change_pct": 0
}
},
"unit": "per index"
}

OHLC (Open/High/Low/Close) Endpoint

Get OHLC data for a specific time period, which is essential for technical analysis. An example response is as follows:

{
"success": true,
"timestamp": 1783990240,
"base": "USD",
"date": "2026-07-14",
"rates": {
"DOW": {
"open": 0.00028,
"high": 0.00029,
"low": 0.00027,
"close": 0.00029
},
"NASDAQ": {
"open": 0.00038,
"high": 0.0004,
"low": 0.00037,
"close": 0.00039
},
"S&P 500": {
"open": 0.0124,
"high": 0.0126,
"low": 0.0123,
"close": 0.0125
},
"FTSE 100": {
"open": 0.0124,
"high": 0.0126,
"low": 0.0123,
"close": 0.0125
},
"DAX": {
"open": 0.0126,
"high": 0.0126,
"low": 0.0126,
"close": 0.0126
}
},
"unit": "per index"
}

Bid/Ask Endpoint

This endpoint provides current bid and ask prices for indices, which is critical for traders. An example response is shown below:

{
"success": true,
"timestamp": 1783990240,
"base": "USD",
"date": "2026-07-14",
"rates": {
"DOW": {
"bid": 0.00028,
"ask": 0.00029,
"spread": 1.0e-5
},
"NASDAQ": {
"bid": 0.00038,
"ask": 0.00039,
"spread": 1.0e-5
},
"S&P 500": {
"bid": 0.0124,
"ask": 0.0125,
"spread": 0.0001
},
"FTSE 100": {
"bid": 0.0124,
"ask": 0.0125,
"spread": 0.0001
},
"DAX": {
"bid": 0.0126,
"ask": 0.0126,
"spread": 0
},
"CAC 40": {
"bid": 0.0126,
"ask": 0.0126,
"spread": 0
},
"NIKKEI 225": {
"bid": 0.0126,
"ask": 0.0126,
"spread": 0
}
},
"unit": "per index"
}

Conclusion

The Indices-API is a powerful tool for developers looking to access real-time and historical Tadawul All Shares index rates. With its comprehensive set of endpoints, developers can retrieve the latest rates, historical data, perform conversions, and analyze fluctuations. By understanding how to utilize these features effectively, you can build applications that provide valuable insights into market trends and enhance decision-making processes.

For further exploration, refer to the Indices-API Documentation for detailed guidance on implementation, and check the Indices-API Supported Symbols page for a complete list of available indices. The Indices-API is not just a data provider; it is a gateway to innovative financial solutions that can transform how we interact with market data.

Ready to use Indices-API?

Try it now!

Access Real-Time & Historical Tadawul All Shares Historical Trends Using Indices-API