Search
K
Macroeconomic Layer API (Production)

List all indicator groups.

Returns the catalogue of groups (e.g., Saudi GDP, UAE
inflation, GCC monetary aggregates). Each entry includes
id, name (Ar/En), country, frequency, and field count.

Example

GET /api/v1.1/indicators/groups
get
https://api.argaam.com/api/v1.1/indicators/groups

Response

200

Success

get/api/v1.1/indicators/groups
 
200

Get fields for a group

Returns the fields for the group identified by groupId.

get
https://api.argaam.com/api/v1.1/indicators/groups/{groupId}/fields

Path Parameters

groupIdinteger(int32)required

Economic indicator group identifier.

Response

200

Success

get/api/v1.1/indicators/groups/{groupId}/fields
 
200

Get an economic indicator series

Returns the observation series for a single indicator field within a group - the actual macroeconomic time series.

get
https://api.argaam.com/api/v1.1/indicators/groups/{groupId}/fields/{fieldId}/values

Query Parameters

yearinteger(int32)

Calendar year to filter by, e.g. 2025. Defaults to 0.

Default:0

Example:2023

periodstring

Time window for the series, e.g. 1d, 1m, 3m, 1y, 5y. Defaults to year.

Default:year

Example:year

fiscalPeriodstring

Fiscal period within the year: 1-4 for quarters, 5 for the full year.

Default:

Example:year

Path Parameters

groupIdinteger(int32)required

Economic indicator group identifier.

fieldIdinteger(int32)required

Identifier of a field inside the selected indicator group.

Response

200

Success

get/api/v1.1/indicators/groups/{groupId}/fields/{fieldId}/values
 
200

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

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
 
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

Success

PetrochemicalPriceIndex

* Additional properties are NOT allowed.
datestring(date-time)
priceValuenumber | null(double)
changenumber | null(double)
get/api/v1.1/petrochemicals/index
 
200 application/json