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

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

In today's fast-paced financial landscape, having access to real-time and historical economic indicators is crucial for developers and analysts alike. The Indices-API provides a powerful solution for accessing comprehensive data on various indices, including the Tadawul All Shares Index. This blog post will guide you through the process of utilizing the Indices-API to access both real-time and historical rates, enabling you to build innovative applications that leverage this data effectively.

About Indices-API

The Indices-API is a robust platform designed for developers seeking to integrate financial data into their applications. With its extensive range of endpoints, the API allows users to access real-time exchange rates, historical data, and various other economic indicators. The transformative potential of this API lies in its ability to provide developers with the tools necessary to create next-generation applications that can analyze and visualize financial data in real-time.

For more information, visit the Indices-API Website or check out the Indices-API Documentation.

API Description

The Indices-API offers a wide array of functionalities that empower developers to access and manipulate financial data seamlessly. With endpoints designed for various use cases, the API supports real-time data retrieval, historical analysis, and even currency conversion. This flexibility allows developers to tailor their applications to meet specific needs, whether for trading, analysis, or reporting.

Key Features and Endpoints

One of the standout features of the Indices-API is its Latest Rates Endpoint. Depending on your subscription plan, this endpoint provides real-time exchange rate data updated at intervals of 60 minutes, 10 minutes, or even more frequently. This feature is particularly useful for applications that require up-to-the-minute data for trading or market analysis.

The Historical Rates Endpoint allows users to access historical rates for most currencies dating back to October 2024. By appending a specific date in the format YY-MM-DD, developers can retrieve past exchange rates, enabling them to conduct thorough analyses of market trends over time.

Another valuable feature is the Convert Endpoint, which facilitates currency conversion. This endpoint enables users to convert any amount from one currency to another, making it essential for applications that require multi-currency support.

The Time-Series Endpoint is particularly useful for developers looking to analyze trends over specific periods. By querying the API for daily historical rates between two chosen dates, users can gain insights into market fluctuations and performance metrics.

Additionally, the Fluctuation Endpoint allows developers to track how currencies fluctuate on a day-to-day basis. This feature is invaluable for applications focused on volatility analysis and risk assessment.

The Open/High/Low/Close (OHLC) Price Endpoint provides essential market data, allowing users to query the API for the open, high, low, and close prices for specific indices. This data is crucial for traders and analysts who rely on these metrics for decision-making.

To access the API, developers must use their unique API Key, which is passed into the API base URL's access_key parameter. This key ensures secure access to the API's functionalities.

All exchange rates delivered by the Indices-API are relative to USD by default, providing a consistent baseline for users. The API also includes a Supported Symbols Endpoint, which returns a constantly updated list of all available currencies, ensuring that developers have access to the latest information.

List of Symbols

The API provides access to a diverse range of index symbols. For a complete list of all supported symbols and their specifications, refer to the Indices-API Supported Symbols page.

API Endpoint Examples and Responses

Latest Rates Endpoint

Get real-time exchange rates for all available indices:

{
"success": true,
"timestamp": 1784335796,
"base": "USD",
"date": "2026-07-18",
"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:

{
"success": true,
"timestamp": 1784249396,
"base": "USD",
"date": "2026-07-17",
"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

Get exchange rates for a specific time period:

{
"success": true,
"timeseries": true,
"start_date": "2026-07-11",
"end_date": "2026-07-18",
"base": "USD",
"rates": {
"2026-07-11": {
"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-13": {
"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-18": {
"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

Convert any amount from one commodity to another or to/from USD:

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

Fluctuation Endpoint

Track rate fluctuations between two dates:

{
"success": true,
"fluctuation": true,
"start_date": "2026-07-11",
"end_date": "2026-07-18",
"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:

{
"success": true,
"timestamp": 1784335796,
"base": "USD",
"date": "2026-07-18",
"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

Get current bid and ask prices for indices:

{
"success": true,
"timestamp": 1784335796,
"base": "USD",
"date": "2026-07-18",
"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

Accessing real-time and historical economic indicators through the Indices-API opens up a world of possibilities for developers and analysts. By leveraging the various endpoints, you can create applications that provide valuable insights into market trends and fluctuations. Whether you are interested in real-time exchange rates, historical data analysis, or currency conversion, the Indices-API has you covered.

For further exploration, refer to the Indices-API Documentation for detailed information on each endpoint and its capabilities. Additionally, the Indices-API Supported Symbols page will help you understand the available indices and their specifications.

By integrating the Indices-API into your applications, you can harness the power of real-time financial data, enabling you to make informed decisions and drive innovation in the financial technology space.