Returns the observation series for a single indicator field within a group - the actual macroeconomic time series.
Calendar year to filter by, e.g. 2025. Defaults to 0.
Default:0
Example:2023
Time window for the series, e.g. 1d, 1m, 3m, 1y, 5y. Defaults to year.
Default:year
Example:year
Fiscal period within the year: 1-4 for quarters, 5 for the full year.
Default:
Example:year
Economic indicator group identifier.
Identifier of a field inside the selected indicator group.
Success
Returns the primary market indicators for the specified exchange:
index level (e.g. TASI for Tadawul, NOMU for the parallel market),
market breadth (advancing / declining / unchanged), and volume metrics.
Tip: For a full market data record (OHLCV + change) use
GET /markets/{marketId}/data. For sector-level breakdowns use
GET /markets/{marketId}/sectors.
Market ID (e.g. 1 for Saudi Tadawul).
Example:3
Success
Standardized successful API response wrapper for v1.0.0 endpoints.
Always true for successful responses.
Semantic API version (e.g., “1.0.0”).
UTC timestamp when the response was generated.
Unique request identifier for tracing.
The response payload.
Pagination and metadata information for collection responses.
Rate limit information returned with each response.
Returns the current index level plus daily / weekly / monthly
changes. Drop into a header ticker on a sector dashboard.
GET /api/v1.1/petrochemicals/index
Success
Daily index history for the supplied window. Use for trend
charts and rolling-window analytics.
GET /api/v1.1/petrochemicals/index/history?from=2023-01-01&to=2023-12-31
Start date (yyyy-MM-dd).
Example:2024-01-01
End date (yyyy-MM-dd).
Example:2024-03-31
Success
Returns the products available on this layer.
Success