Macroeconomic Layer API (Production)
Get key market indicators for a market (TASI, NOMU, breadth metrics).
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.
get
https://api.argaam.com/api/v1.1/markets/{marketId}/indicators
Path Parameters
marketIdinteger(int32)required
Market ID (e.g. 1 for Saudi Tadawul).
Example:3
Response
200 application/json
Response
200 application/json
Success
ApiV1Response
Standardized successful API response wrapper for v1.0.0 endpoints.
* Additional properties are NOT allowed.
successboolean
Always true for successful responses.
apiVersionstring | null
Semantic API version (e.g., “1.0.0”).
timestampstring(date-time)
UTC timestamp when the response was generated.
requestIdstring | null
Unique request identifier for tracing.
data
The response payload.
metaobject
Pagination and metadata information for collection responses.
* Additional properties are NOT allowed.
Show Child Parameters
rateLimitobject
Rate limit information returned with each response.
* Additional properties are NOT allowed.
Show Child Parameters
get/api/v1.1/markets/{marketId}/indicators
Authentication
Path Parameters
200 application/json
Latest value of the Argaam Petrochemical Price Index.
Returns the current index level plus daily / weekly / monthly
changes. Drop into a header ticker on a sector dashboard.
Example
GET /api/v1.1/petrochemicals/index
get
https://api.argaam.com/api/v1.1/petrochemicals/index
Response
200 application/json
Response
200 application/json
Success
PetrochemicalPriceIndex
* Additional properties are NOT allowed.
datestring(date-time)
priceValuenumber | null(double)
changenumber | null(double)
get/api/v1.1/petrochemicals/index
Authentication
200 application/json
Historical values of the Argaam Petrochemical Price Index.
Daily index history for the supplied window. Use for trend
charts and rolling-window analytics.
Example
GET /api/v1.1/petrochemicals/index/history?from=2023-01-01&to=2023-12-31
get
https://api.argaam.com/api/v1.1/petrochemicals/index/history
Query Parameters
fromstring
Start date (yyyy-MM-dd).
Example:2024-01-01
tostring
End date (yyyy-MM-dd).
Example:2024-03-31
Response
200 application/json
Response
200 application/json
Success
* Additional properties are NOT allowed.
datestring(date-time)
priceValuenumber | null(double)
changenumber | null(double)
get/api/v1.1/petrochemicals/index/history
Authentication
Query Parameters
200 application/json
List products
Returns the products available on this layer.
get
https://api.argaam.com/api/v1.1/petrochemicals/products
Response
200 application/json
Response
200 application/json
Success
* Additional properties are NOT allowed.
productIDinteger(int32)
productNameArstring | null
productNameEnstring | null
descriptionArstring | null
descriptionEnstring | null
utilizationEnstring | null
utilizationArstring | null
categoryIDinteger(int32)
attributeIDinteger | null(int32)
isPublicboolean
isChartEnabledForReportboolean | null
regionIDinteger(int32)
regionNameArstring | null
regionNameEnstring | null
productPricenumber(double)
changeInPricenumber | null(double)
entryDatestring(date-time)
get/api/v1.1/petrochemicals/products
Authentication
200 application/json
Latest prices for a petrochemical product (rolling window).
Returns prices observed during the requested rolling period
(1D, 1W, 1M, 3M, 1Y, MAX).
Example
GET /api/v1.1/petrochemicals/products/12/prices?regionId=1&period=1M
get
https://api.argaam.com/api/v1.1/petrochemicals/products/{productId}/prices
Query Parameters
regionIdinteger(int32)
Region ID. Defaults to Asia (1).
Example:1
periodstring
Rolling window. Default: 1M. Defaults to 1M.
Default:1M
Example:year
Path Parameters
productIdinteger(int32)required
Product ID from /products.
Response
200 application/json
Response
200 application/json
Success
* Additional properties are NOT allowed.
productPriceIDinteger(int32)
regionIDinteger(int32)
categoryIDinteger(int32)
productIDinteger(int32)
productPricenumber(double)
measuringUnitIDinteger(int32)
currencyIDinteger(int32)
entryDatestring(date-time)
changeInPricenumber | null(double)
regionNameArstring | null
regionNameEnstring | null
categoryNameArstring | null
categoryNameEnstring | null
productNameArstring | null
productNameEnstring | null
changenumber | null(double)
get/api/v1.1/petrochemicals/products/{productId}/prices
Authentication
Path Parameters
Query Parameters
200 application/json